这是本文档旧的修订版！

📚 游戏道具扩展

在《沙盘引擎》世界框架中，游戏道具是极为重要的存在，任何基于角色手持物品的逻辑都属于游戏道具范畴。

无论何种类型的游戏玩法，角色手中的物品都能起到大作用，无论是显示作用还是实际使用，亦或是【背包系统】等扩展操作，游戏道具系统都可以便捷实现。

📒 游戏道具简介

在默认情况下，沙盘引擎内所有的【游戏道具\物品】均没有任何作用，它们只是看起来像XXX的一个模型，必须由开发者根据实际游戏玩法，具体设定它们应该有何实际操作。

这需要开发者在模组目录\Data\Prop\XXX.json文件修改扩展有关【游戏道具】的Json配置文件，这其中可能包括ID、模型、Flag、叠加数量、伤害、延迟时间、动画组等数值设定，这将直接影响到游戏道具的实际展现形式。

📘 文件命名规范

想要进行游戏道具的扩展维护，必须对文件使用特定的命名规范，否则引擎可能无法识别配置文件。

命名规范：ID_Name.json

例如：10000_Base.json（自定义ID从10000开始）

这里需要注意，因为有些大型玩法模组可能会有【物品分类】等需求，所以游戏道具的配置文件允许由多个Json（数组）文件组合而成，如果游戏玩法相对简单，那么也可以只自定义一个json文件即可。

引擎API可能会额外提供一些根据物品分类筛选列表的功能，所以对于物品较多的游戏，分类是有必要的（沙盘引擎的默认物品均进行了分类）。

📒 道具配置设定

//枪类武器配置示例
[
    {
		"ID": 0, //道具ID
		"Model": 5163, //绑定模型ID
		"Pos": {"x": 0, "y": 0, "z": -0.2}, //模型位置偏移（可空）
		"Scale": {"x": 1.5, "y": 1.5, "z": 1.5}, //模型缩放（可空）
		"Flags": 132, //Flag类型（128+4 == 枪类+连续发射）
		"Multiple": 1, //背包内槽内叠加数量（1=不可叠加，通常有特性的物品都不应该叠加）
		"Damage": 10, //常规攻击力（因为此示例是Flags枪类武器，所以这里就是枪械的攻击力，平时则是普通攻击伤害）
		"DamageRange": 1, //产生攻击的检测范围（范围内的实体都会被攻击）
		"DamageShake": 1.0, //产生攻击时的检测范围偏移\不稳定性（0为不偏移，枪械类：表示后坐力偏移程度）
		"Distance": 35, //距离属性，主要用于类似枪械射程等内容，普通物品如果不为0，则表示物品声音范围（引擎默认值35）
		"Direction": 1, //手持物品方向类型（表格详情）
		"PreloadTime": 1.0, //物品刚切换时冷却CD时间
		"Speed": 1.0, //物品每次Action时的动画速度，直接影响Action时间间隔（例如：枪械射速）
		"Audios": { //声音类（可空0）
			"Idle": 0, //拿出物品时声音
			"Focus": 0, //焦点时声音
			"Action": 0 //行为时声音
		},
		"Animations": { //动作类（可空0）
			"Idle": 2, //站立时动作
			"Focus": 15, //焦点时动作
			"Action": 15 //行为时动作
		}
	}
]