装备平衡数据
通过服务端数据包调整目录装备的属性加成与法术存储限制。
装备覆盖文件用于调整已有目录物品的属性加成和法术存储限制。服务端会把通过校验的数值同步给客户端,无须为这些数值另发客户端资源包。
文件放在哪里
每件物品对应一个data/isekaiexpansion/equipment/<item_id>.json。文件名指定已注册的目录物品,其他命名空间会被忽略。多个数据包提供相同路径时,优先级最高的文件整体生效,不会跨包合并字段。
此格式不能注册新物品,也不能修改稀有度、槽位、外观或持握发光。这些内容由启动装备目录定义。
最小示例
在data/isekaiexpansion/equipment/apprentice_fieldnotes.json中写入以下内容,只调整存储,保留内置属性加成:
{
"vessel": {
"capacity": 4,
"max_spell_tier": 2,
"spells_per_tier": 2,
"access": "CONTAINED"
}
}
字段
| 字段 | 类型 | 默认值 | 作用 |
|---|---|---|---|
stats | array<object> | 内置物品属性 | 替换整个加成列表。空数组移除全部目录属性加成。 |
vessel | object | 内置物品存储 | 替换全部存储设置,仅已有法术书和施法主手支持。 |
stats[].attribute | identifier | 必填 | 已注册的完整属性ID,包含命名空间。未知属性使重载失败。 |
stats[].amount | number | 必填 | 有限、非零的带符号数值。单位取决于属性和运算类型,允许负值惩罚。 |
stats[].operation | enum | 必填 | ADDITION、MULTIPLY_BASE或MULTIPLY_TOTAL。加法使用属性本身的单位,乘法使用小数修正量。 |
vessel.capacity | integer | 必填 | 存储条目总数,范围1–16。一个编织术式占一个条目。 |
vessel.max_spell_tier | integer | 必填 | 可容纳的法术或术式最高阶位,范围1–13。术式按完整评估阶位判断,不能只看起手法术。 |
vessel.spells_per_tier | integer | 必填 | 同一评估阶位可容纳的条目数,范围1–capacity。它与最高阶位分别限制。 |
vessel.access | enum | 必填 | 法术书使用CONTAINED,施法主手使用MAGIC。未知值或与物品类型不符都会使重载失败。 |
完整示例
同一路径可同时替换两组设置:
{
"stats": [
{
"attribute": "isekaiexpansion:intelligence",
"amount": 4,
"operation": "ADDITION"
}
],
"vessel": {
"capacity": 4,
"max_spell_tier": 2,
"spells_per_tier": 2,
"access": "CONTAINED"
}
}
校验
未知字段、未知目录物品、无法解析的属性ID、重复属性、损坏的JSON、缺失的内部字段,以及超出范围的数值,都会使重载失败。整数字段不接受小数,null也不表示使用默认值。
空对象保留内置默认值,空文件则无效。省略某组字段会恢复该组的内置值,不会沿用上次覆盖的值。删除覆盖文件会恢复两组内置设置。
重载
执行/reload后,服务端先准备完整且通过校验的平衡快照,等整个数据包重载成功再启用。重载失败时保留之前的生效数值。已装备的目录加成随之刷新;玩家加入和成功重载时,客户端都会收到生效快照。
降低存储限制不会删除已有铭刻。超出容量、最高阶位或同阶数量的条目进入休眠,无法施放;保留哪些条目取决于存储顺序。玩家仍可解除绑定,新铭刻和术式替换则必须满足当前限制。