装备属性系统¶

本文档介绍装备随机属性系统的配置和使用方法，包括怪物极品概率覆盖、套装属性屏蔽等功能。

功能概述¶

装备属性系统支持以下核心功能：

功能	说明
极品概率	装备生成随机属性的概率
词条数量	极品装备生成1~4条随机属性的概率分布
怪物覆盖	特定怪物可覆盖默认的极品概率和词条概率
套装屏蔽	特定属性可配置不出现在某些套装装备上

配置文件¶

装备属性配置¶

路径：Database/System/物品数据/装备属性/

每个装备部位一个配置文件，如 项链.txt：

{
  "装备部位": "项链",
  "极品概率": 0.05,
  "单条概率": 70,
  "两条概率": 20,
  "三条概率": 8,
  "四条概率": 2,
  "属性列表": [
    {
      "属性编号": 32001,
      "属性概率": 10,
      "属性描述": "幸运等级+1",
      "屏蔽套装": ["祖玛装备", "赤月装备"]
    }
  ]
}

字段说明¶

字段	类型	说明
装备部位	枚举	装备部位类型
极品概率	float	0~1，如0.05表示5%
单条概率	int	生成1条属性的概率（百分比）
两条概率	int	生成2条属性的概率（百分比）
三条概率	int	生成3条属性的概率（百分比）
四条概率	int	生成4条属性的概率（百分比）
属性列表	数组	可生成的随机属性列表
屏蔽套装	数组	该属性不出现在这些套装装备上

概率总和

四项词条概率（单条+两条+三条+四条）总和应为100。非100时按权重比例计算，并在加载时输出警告日志。

怪物配置¶

路径：Database/System/Npc数据/怪物数据/

在怪物配置中添加极品概率相关字段：

{
  "怪物名字": "祖玛教主",
  "怪物编号": 350,
  "极品装备概率": 0.3,
  "生成一条属性概率": 50,
  "生成两条属性概率": 30,
  "生成三条属性概率": 15,
  "生成四条属性概率": 5
}

怪物覆盖字段¶

字段	类型	说明
极品装备概率	float	0表示使用装备属性默认值
生成一条属性概率	int	百分比，四项总和应为100
生成两条属性概率	int	百分比
生成三条属性概率	int	百分比
生成四条属性概率	int	百分比

覆盖机制¶

极品概率覆盖¶

条件	使用的概率
怪物 `极品装备概率 > 0`	使用怪物配置
怪物 `极品装备概率 = 0`	使用装备属性配置

词条数量覆盖¶

条件	使用的概率
怪物四项概率总和 > 0	使用怪物配置
怪物四项概率总和 = 0	使用装备属性配置

独立控制

极品概率和词条数量可以独立覆盖。例如：只配置怪物的极品概率，词条数量仍使用装备属性默认值。

生效范围¶

生成路径	怪物覆盖	套装屏蔽
怪物掉落	✅ 生效	✅ 生效
商店购买	❌ 不生效	✅ 生效
GM命令	❌ 不生效	✅ 生效
重铸装备	❌ 不生效	✅ 生效

配置示例¶

示例1：BOSS高概率出极品¶

{
  "怪物名字": "祖玛教主",
  "极品装备概率": 1.0,
  "生成一条属性概率": 0,
  "生成两条属性概率": 20,
  "生成三条属性概率": 50,
  "生成四条属性概率": 30
}

效果：100%出极品，且高概率出3~4条属性。

示例2：只覆盖极品概率¶

{
  "怪物名字": "白野猪",
  "极品装备概率": 0.5,
  "生成一条属性概率": 0,
  "生成两条属性概率": 0,
  "生成三条属性概率": 0,
  "生成四条属性概率": 0
}

效果：50%出极品，词条数量使用装备属性默认配置。

示例3：套装屏蔽幸运属性¶

{
  "属性编号": 32001,
  "属性概率": 10,
  "属性描述": "幸运等级+1",
  "屏蔽套装": ["祖玛装备", "赤月装备", "魔龙装备"]
}

效果：幸运+1属性不会出现在祖玛、赤月、魔龙套装的装备上。

加载期校验¶

服务器启动时会自动校验配置完整性：

警告日志示例¶

[游戏怪物] ⚠️ 配置提示: 祖玛教主 配置了极品概率=0.3，但词条概率未配置，将使用装备属性默认值
[游戏怪物] ⚠️ 配置提示: 白野猪 词条概率总和=90，非100，运行时按权重比例计算
[装备属性] ⚠️ 配置警告: 部位=项链 词条概率总和=95，非100，运行时将按权重比例计算

热更新¶

支持运行时热更新装备属性配置：

修改配置文件
在服务器管理界面点击"重载物品数据"（case 5）
系统自动刷新所有在线玩家的套装属性

热更新注意事项

热更新后，已生成的装备属性不会改变，只影响新生成的装备。

调试日志¶

开启 Settings.开启调试日志 后，可查看详细的属性生成过程：

[装备属性] 部位=项链 怪物=祖玛教主 极品概率=0.3 配置概率=0.05 重铸=False
[装备属性] 部位=项链 极品判定成功，词条数量=3 可用属性数=15
[装备数据] 怪物覆盖生成属性: 物品=裁决之杖 怪物=祖玛教主 极品概率=0.3

常见问题¶

Q: 为什么怪物掉落的装备没有随机属性？¶

检查以下配置：

装备属性配置的 极品概率 是否大于0
怪物配置的 极品装备概率 是否为0（0表示使用默认值）
查看启动日志是否有概率表加载警告

Q: 词条概率总和不是100会怎样？¶

系统会按权重比例计算。例如总和为50时：

单条概率20 → 实际40%
两条概率15 → 实际30%
三条概率10 → 实际20%
四条概率5 → 实际10%

Q: 如何让某个BOSS只出4条属性的极品？¶

{
  "怪物名字": "终极BOSS",
  "极品装备概率": 1.0,
  "生成一条属性概率": 0,
  "生成两条属性概率": 0,
  "生成三条属性概率": 0,
  "生成四条属性概率": 100
}