meta data for this page
  •  

📚 差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
extend:prop [2023/10/22 00:14] – bibiboxsextend:prop [2025/05/19 21:21] (当前版本) – bibiboxs
行 15: 行 15:
 在沙盘引擎世界中，所有的【游戏道具\物品】全部基于抽象的概念，**实际上并没有任何默认作用**，**它们只是看起来像XXX的一个模型，通过API方式放到了角色手上**，开发者可根据实际游戏玩法需要，自行通过【自定义游戏道具+代码编写道具功能】设定它们应该有何实际操作。 在沙盘引擎世界中，所有的【游戏道具\物品】全部基于抽象的概念，**实际上并没有任何默认作用**，**它们只是看起来像XXX的一个模型，通过API方式放到了角色手上**，开发者可根据实际游戏玩法需要，自行通过【自定义游戏道具+代码编写道具功能】设定它们应该有何实际操作。
  
-想要将一个普通模型注册为**游戏道具**，需要开发者==找到`LocalMod\Store\Data\Prop`目录==，**新建或修改**有关【游戏道具】的Json配置文件，这其中可能包括`ID、模型、Flag、叠加数量、伤害、延迟时间、动画组`等数值设定，这将**直接影响到游戏道具的实际展现形式**。+想要将一个普通模型注册为**游戏道具**，需要开发者==找到`LocalMod\Store\Data\Prop`目录==，**新建或修改**有关【游戏道具】的Json配置文件，这其中可能包括==ID、模型、Flag、叠加数量、伤害、延迟时间、动画组==等数值设定，这将**直接影响到游戏道具的实际展现形式**。
  
 > **注意：动物等特殊类型角色不会有任何道具拾取功能及效果，==道具功能主要用于人形角色（包括僵尸）==。** > **注意：动物等特殊类型角色不会有任何道具拾取功能及效果，==道具功能主要用于人形角色（包括僵尸）==。**
行 57: 行 57:
  "Model": 5163,  "Model": 5163,
  "Pos": {"x": 0, "y": 0, "z": -0.2},  "Pos": {"x": 0, "y": 0, "z": -0.2},
-        "Angle": {"x": 0, "y": 0, "z": 0},+ "Angle": {"x": 0, "y": 0, "z": 0},
  "Scale": {"x": 1.5, "y": 1.5, "z": 1.5},  "Scale": {"x": 1.5, "y": 1.5, "z": 1.5},
  "Color": {"r": 255, "g": 255, "b": 0},  "Color": {"r": 255, "g": 255, "b": 0},
行 89: 行 89:
 ``` ```
  
-| 属性Key             | 说明                                                         | 默认Value                                | +| 属性Key               | 说明                                                         | 默认Value                                | 
-| ------------------- | ------------------------------------------------------------ | ---------------------------------------- | +| --------------------- | ------------------------------------------------------------ | ---------------------------------------- | 
-| ID                  | 道具ID                                                       | 自定义道具ID必须从10000开始              | +| `ID`                  | 道具ID                                                       | 自定义道具ID必须从10000开始              | 
-| Model               | 物品展示（拿在手中）的模型ID，基于模型管理机制               | -                                        | +| `Model`               | 物品展示（拿在手中）的模型ID，基于模型管理机制               | -                                        | 
-| Pos                 | 模型本地坐标偏移（可空，默认中心）                           | Vector(0, 0, 0)                          | +| `Pos`                 | 模型本地坐标偏移（可空，默认中心）                           | Vector(0, 0, 0)                          | 
-| Angle               | 模型本地角度偏移（可空，默认无旋转）                         | Vector(0, 0, 0)                          | +| `Angle`               | 模型本地角度偏移（可空，默认无旋转）                         | Vector(0, 0, 0)                          | 
-| Scale               | 模型本地缩放偏移（可空，默认`1`）                            | Vector(0, 0, 0)                          | +| `Scale`               | 模型本地缩放偏移（可空，默认`1`）                            | Vector(0, 0, 0)                          | 
-| Color               | 颜色属性（并非修改模型颜色，主要用于弹道、投掷弹道等颜色）   | Color(255, 255, 255)                     | +| `Color`               | 颜色属性（并非修改模型颜色，主要用于弹道、投掷弹道等颜色）   | Color(255, 255, 255)                     | 
-| Flags               | **Flag特性类型，这将直接改变此物体的关键属性、效果、方式**<br />（此属性支持位操作，可叠加Flag效果，详情参考下方表格） | 0                                        | +| `FocusPoint`          | 道具焦点坐标（本地）<br />主要用于表示道具的核心\触发位置，目前仅用于展示攻击拖尾的坐标 | Vector(0, 0, 0)                          | 
-| Multiple            | **背包系统**槽内可叠加数量（1=不可叠加，通常有特性的物品都不应该叠加）<br />（注意：这是一个抽象概念，应搭配`Prop | Character.Prop`相关API使用，主要用于支持背包交互系统的模组，否则可忽略此属性） | 1                                        | +| `TrailColor`          | 行为时拖尾颜色                                               | Color(255, 255, 255)                     | 
-| Damage              | 常规攻击力，可能根据`Flags`不同有不同的效果<br />（例如：枪械的攻击力、投掷物伤害等，默认情况下是普通攻击挥动伤害） | 10                                       | +| `Flags`               | **Flag特性类型，这将直接改变此物体的关键属性、效果、方式**<br />（此属性支持位操作，可叠加Flag效果，详情参考下方表格） | 0                                        | 
-| DamageRange         | 产生攻击的检测范围（范围内的实体对象都会被攻击）<br />*枪械Flag：弹道宽度、伤害检测范围*<br />*投掷物Flag：投掷弹道宽度* | `≈1.0`                                   | +| `Multiple`            | **背包系统**槽内可叠加数量（1=不可叠加，通常有特性的物品都不应该叠加）<br />（注意：这是一个抽象概念，应搭配`Prop | Character.Prop`相关API使用，主要用于支持背包交互系统的模组，否则可忽略此属性） | 1                                        | 
-| DamageShake         | 目前版本主要用于Flag相关效果<br />*枪械Flag：后坐力、射击偏移*<br />*投掷物Flag：投掷时速度、力量* | *枪械Flag：`≈1.0`*<br />*投掷物：`≈0.5`* | +| `Damage`              | 常规攻击力，可能根据`Flags`不同有不同的效果<br />（例如：枪械的攻击力、投掷物伤害等，默认情况下是普通攻击挥动伤害） | 10                                       | 
-| Distance            | 距离属性，目前主要用于类似枪械射程等。<br />普通物品如果不为0，则表示物品声音范围（引擎默认值24） | 24                                       | +| `DamageRange`         | 产生攻击的检测范围（范围内的实体对象都会被攻击）<br />*枪械Flag：弹道宽度、伤害检测范围*<br />*投掷物Flag：投掷弹道宽度* | `≈1.0`                                   | 
-| Direction           | 手持物品方向修正类型（详情见下方表格）                       | 0                                        | +| `DamageShake`         | 目前版本主要用于Flag相关效果<br />*枪械Flag：后坐力、射击偏移*<br />*投掷物Flag：投掷时速度、力量* | *枪械Flag：`≈1.0`*<br />*投掷物：`≈0.5`* | 
-| PreloadTime         | 物品刚切换时冷却CD时间，期间无法进行当前物品的使用操作       | 0.75                                     | +| `Distance`            | 距离属性，目前主要用于类似枪械射程等。<br />普通物品如果不为0，则表示物品声音范围（引擎默认值24） | 24                                       | 
-| Speed               | **物品每次Action时的动画速度，直接影响Action时间间隔（例如：枪械射速）**<br />（简单来说，此属性控制物品整体Action速度，相当于物品的“攻击速度”） | 1.0                                      | +| `Direction`           | 手持物品方向修正类型（详情见下方表格）                       | 0                                        | 
-| MoveSpeedMultiplier | 手持物品时影响角色的移动速度（倍数）                         | 1.0                                      | +| `Enum`                | 通用枚举\数值\索引属性                                       | 0                                        | 
-| Audios[]            | `Idle`：拿出物品时的声音<br />`Focus`：焦点（HasFocus）时声音<br />`Action`：行为（HasAction）时声音 | 0                                        | +| `Interval`            | 物品每次**独立\首次Action**时的间隔秒数，不影响连续射击间隔（`Speed`）<br />（例如：两次连续点击鼠标时，最少等待`Interval`秒后才能再次执行） | 0.2                                      | 
-| Animations[]        | `Idle`：站立、闲置时动作<br />`Focus`：焦点（HasFocus）时动作<br />`Action`：行为（HasAction）时动作<br />（详情见下方【自定义动作列表】） | 0                                        |+| `PreloadTime`         | 物品刚切换时冷却CD时间，期间无法进行当前物品的使用操作       | 0.5                                     | 
 +| `Speed`               | **物品每次Action时的动画速度，直接影响Action时间间隔（例如：枪械射速）**<br />（简单来说，此属性控制物品整体Action速度，相当于物品的“攻击速度”） | 1.0                                      | 
 +| `MoveSpeedMultiplier` | 手持物品时影响角色的移动速度（倍数）                         | 1.0                                      | 
 +| `Audios[]`            | `Idle`：拿出物品时的声音<br />`Focus`：焦点（HasFocus）时声音<br />`Action`：行为（HasAction）时声音 | 0                                        | 
 +| `Animations[]`        | `Idle`：站立、闲置时动作<br />`Focus`：焦点（HasFocus）时动作<br />`Action`：行为（HasAction）时动作<br />（详情见下方【自定义动作列表】） | 0                                        |
  
  
行 118: 行 122:
 | 4        | 连续使用效果（Continue），否则是单次触发                     | | 4        | 连续使用效果（Continue），否则是单次触发                     |
 | 8        | 散射范围，目前主要用于表示**散弹类枪械**<br />如果希望常规物品提升攻击范围，请修改`DamageRange`属性 | | 8        | 散射范围，目前主要用于表示**散弹类枪械**<br />如果希望常规物品提升攻击范围，请修改`DamageRange`属性 |
 +| 16       | 多连发模式（Burst）<br />优先级更高，否则默认继承单发（Normal）或连续模式（Continue） |
 +| 64       | 行为时生成[Effect](scripting/native/effect)，效果类型与`Enum`有关 |
 | 128      | 预制类型：枪械类                                             | | 128      | 预制类型：枪械类                                             |
 | 256      | 预制类型：投掷类（扔出XXX、投掷光线、弓、RPG、手榴弹等）     | | 256      | 预制类型：投掷类（扔出XXX、投掷光线、弓、RPG、手榴弹等）     |
 | 512      | 投掷后爆炸效果（必须同时搭配`256`使用）                      | | 512      | 投掷后爆炸效果（必须同时搭配`256`使用）                      |
 | 1024     | 投掷后产生伤害（必须同时搭配`256`使用），伤害值与`Damage`有关 | | 1024     | 投掷后产生伤害（必须同时搭配`256`使用），伤害值与`Damage`有关 |
 +| 2048     | 投掷后产生烟雾（必须同时搭配`256`使用）                      |
 +| 4096     | 投掷后产生闪光（必须同时搭配`256`使用）                      |
 +| 8192     | 投掷后产生燃烧组（必须同时搭配`256`使用）                    |
  
 | Direction | 说明                                               | | Direction | 说明                                               |
行 148: 行 157:
 > 当通过上述操作**成功注册\绑定**道具后，开发者可能希望在**游戏内使用新的道具**，或者给**不同的道具实现不同的功能**，请参考此部分操作。 > 当通过上述操作**成功注册\绑定**道具后，开发者可能希望在**游戏内使用新的道具**，或者给**不同的道具实现不同的功能**，请参考此部分操作。
  
-1. 编写World脚本代码，建立相关角色，并使用`chara.SetProp()`功能【给予】角色一个道具到背包（注意道具ID要填写正确）+1. 编写World脚本代码，建立相关角色，并使用`chara.SetProp()`功能【给予】角色一个道具到背包
 2. 进入游戏内测试，如果没有报错的情况下，角色应该已经成功**手持（指定）新道具**（确保`chara.PropSlot`正确） 2. 进入游戏内测试，如果没有报错的情况下，角色应该已经成功**手持（指定）新道具**（确保`chara.PropSlot`正确）
 3. 此时可能发现道具因模型尺寸、位置不同，导致拿在手里的样式等不太正确，这需要根据上方的Json示例调整几次，直到满意为止 3. 此时可能发现道具因模型尺寸、位置不同，导致拿在手里的样式等不太正确，这需要根据上方的Json示例调整几次，直到满意为止
-4. 如果希望给道具绑定一些功能（例如：手持XXX，触发`Action`行为时做些什么，或者能否触发的前提条件），参考[《OnCharacterPropActionBefore及OnCharacterPropAction》](scripting/world/character)+4. 如果希望给道具绑定一些功能（例如：手持XXX，触发`Action`行为时做些什么，或者能否触发的前提条件），参考[《OnCharacterPropAction》](scripting/world/character)
  
  
行 230: 行 239:
  
 针对游戏道具扩展部分的内容，经过沙盘引擎开发组的自我评估，**几乎很多扩展功能都可以通过上述内容实现**，具体取决于开发者**如何合理控制Json以及API的行为事件交互**。 针对游戏道具扩展部分的内容，经过沙盘引擎开发组的自我评估，**几乎很多扩展功能都可以通过上述内容实现**，具体取决于开发者**如何合理控制Json以及API的行为事件交互**。
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +