Kzeroko KTM2

弓术数据

通过Origins能力与手持物品代理授予已注册的弓术技法。

更新于 2026/11/10 3 分钟阅读

弓术数据负责授予已有技法,不定义弹道行为或伤害公式。持有弓弩时,基础能力与物品代理合并为一份去重的技法列表。

文件放在哪里

物品代理位于data/<namespace>/archery_proxy/<item-path>.json,文件标识必须对应已注册的弓或弩。内置的data/isekaiexpansion/archery_proxy/domainofego.json为真我之境·无暇回归授予星坠箭雨。同一文件标识先按正常的数据包优先级解析,再交给代理加载流程。

Origins能力沿用标准能力目录,例如data/isekaiskills/powers/archery_charged_arrow.json。还须通过种族/职业成员表、可学习能力奖励或其他Origins来源赋予能力;只有文件并不会自动授予技法。

最小示例

{
  "skills": ["isekaiexpansion:arrow_rain"]
}

字段

字段类型默认值范围或单位含义
skills标识符数组必填物品代理最多16个不同条目按显示顺序列出已注册技法,重复项合并。

完整示例

{
  "type": "isekaiorigins:archery_skills",
  "skills": ["isekaiexpansion:charged_arrow"],
  "rank": 2,
  "mastery_power": "isekaiskills:gale_mastery",
  "name": "archery.isekaiexpansion.charged_arrow",
  "description": "archery.isekaiexpansion.charged_arrow.description"
}
字段类型默认值范围或单位含义
type标识符必填isekaiorigins:archery_skillsOrigins能力工厂。
skills标识符数组必填已注册技法ID基础授予项;能力未激活时不提供技法。
rank整数11–3多个来源取最高等阶;武器代理固定为1阶。
mastery_power能力标识符省略仅限1或2阶持有且激活指定能力时再升1阶。基础等阶越界或为3阶配置精通能力时,授予无效。
name翻译键省略时采用Origins默认值无单位可选的能力显示名称。
description翻译键省略时采用Origins默认值无单位可选的能力描述。

已注册技法为isekaiexpansion:normal_arrow、isekaiexpansion:arrow_rain、isekaiexpansion:rapid_fire、isekaiexpansion:multishot、isekaiexpansion:piercing_arrow、isekaiexpansion:charged_arrow和isekaiexpansion:sylvan_spiral。精灵组合技为isekaiexpansion:sylph_crossing与isekaiexpansion:swallow_reversal,施展时还需拥有精灵之谐。消耗与效果见弓术。

拥有任一有效技法来源时,普通箭自动排在首位,无需单独授予能力或花费技能点。

校验

物品代理缺少skills、该字段不是数组、标识格式错误、技法不存在、物品不受支持或不同技法超过16个时,会拒绝该条目并记录错误。空数组可正常加载,但不授予技法。未知对象字段被忽略;重复技法保留首次出现的位置。基础能力字段由Origins解析;格式有效但未注册的技法ID不会生成栏位。

物品堆也可提供archery_proxy复合标签,其中skills为字符串列表。服务端最多读取前16项,忽略格式错误或未知的ID,并将结果叠加到物品文件和激活的基础授予项中。它不能定义新技法,也不能修改冷却。

重载

物品代理随服务端数据包重载,并整体替换之前的代理表。服务端每刻更新可用技法,并将授予项的变化同步给玩家。当前技法被移除时,拉弓会回到普通箭。失去授予项会取消正在执行的连续射击;冷却由共用技能管理器持有,换武器不会重置冷却。

相关页面

参阅弓术与精灵、技能树数据与动态玩家模块。