物品属性和修改器

物品属性

版本： 1.4.1-legacy · Minecraft： 1.20.1 · 加载器： Forge

此模组的功能

物品属性让玩家（和管理员）能够使用经验值等级作为货币，自定义任何物品——无论是原版还是模组物品。所有内容都存储在物品自身的 NBT 中，因此不会添加任何新物品、方块或合成配方；一把普通的钻石剑或皮革靴子可以变成决定流派构建的关键装备。

该系统分为四个层级，大致按强度排列：

1. 属性 —— 将攻击伤害、攻击速度、攻击距离或护甲值设置为精确数值。
2. 效果 —— 附加原版或模组药水效果，可在持有、穿戴或近战命中时触发。
3. 等级 —— 物品上的每个属性和效果都算作一次“改造”。足够的改造次数可将物品等级从 E 一路提升至 SSS。
4. 通量核心 —— 一旦物品达到 SSS 等级，即可分配 12 种稀有核心中的一种（7 种用于武器，5 种用于护甲），每种核心都拥有其独立的被动技能组合，部分核心还具备独特能力。

所有内容均以经验值等级计价，系统内几乎所有的数值——费用、掉落率、冷却时间、伤害、地形破坏——均可通过服务器配置调整。

---

进度

等级

RankUtil 统计物品上的真实改造数量（伤害/速度/距离/护甲若被设置则各计一次，加上每个持有/穿戴/命中效果各计一次）：

改造数量	等级
0	E
1–2	D
3–4	C
5–6	A
7–9	S
10+	SSS

物品首次达到 SSS 等级时，会自动为其随机分配一个通量核心（从该物品类型对应的正确池中抽取——武器/工具对应武器核心，护甲部件对应护甲核心），并授予 神铸 进度。

费用

每次改造都消耗经验等级，按每个属性单独计算，并乘以全局费用倍率（默认 2 倍）：

• 伤害/速度/距离/护甲：费用随请求值缩放（每点费用，可配置）。
• 持有/穿戴/命中效果：1 级原版效果的基础费用（默认 30），模组效果翻倍（默认 2 倍），且每高于 1 级的放大器等级乘以对应倍率（默认每级 3 倍）。
• 设置特定通量核心需要固定费用（默认 500）；随机滚动一个核心费用较低（默认 50）。
• 可选的 最高等级费用上限 可将任何单次改造的费用限制在设定上限内，无论原始计算费用多么昂贵。

---

武器通量核心

在主手或副手槽位中滚动或设置。每个物品只能激活一个武器核心；神父在整个服务器中只能存在一个（见下文）。

核心	默认滚动权重	被动技能组
天选者	35%	持有期间获得生命恢复 II。命中时：造成真实伤害（无视护甲/抗性/无敌帧）。
主宰	25%	持有期间获得抗性提升 II、生命提升 II、伤害吸收 II。命中时：较弱的真实伤害爆炸。
天使	15%	生命恢复 II + 37 格“神压”光环（对附近敌对生物施加缓慢/凋零）。命中造成真实伤害。
死神	14.79%	力量 V、速度 V + 神压光环。命中造成 1.5 倍真实伤害，并将目标生命值上限限制在其最大生命值以下。
天界	0.1%	生命恢复 + 抗性提升，较慢的飞行能力，25% 几率受到的伤害无效化。潜行+攻击：冻结时间 15 秒（有冷却）。Alt+攻击：分裂斩——一道清除一条线地形的远程真实伤害斩击。
原始	0.1%	与天界相同的被动技能，外加“原始之怒”击杀计数器，可随时间提升真实伤害加成（最高 +50%），以及天界/神父所拥有的相同神压光环。潜行+攻击：恶魔之爪斩击。Alt+攻击：龙族冲击波——一个巨大的清地形范围攻击，消耗施法者自身 95% 的生命值。
神父	0.01%（唯一——整个服务器同一时间只能存在一个）	同时拥有所有被动技能（抗性提升、伤害吸收、速度、力量、生命恢复、急迫），金色翅膀、光环、神圣白昼光环、追踪真理之球、3 倍真实伤害命中。潜行+攻击：全能斩击。Alt+攻击：全能推击——模组中最具破坏力的能力。

真实伤害 在所有情况下都会无视护甲、抗性提升和无敌帧。终极能力（分裂斩、恶魔之爪、龙族冲击波、全能斩击、全能推击）各自拥有独立可配置的冷却时间和伤害值，且全能斩击/推击在触发时会对所有玩家的屏幕发出醒目的粗体标题。

清地形能力遵循全局破坏开关和百分比缩放（见配置）。

神父的唯一规则

整个服务器同一时间内只能存在一个带有神父核心的物品。在新物品上设置神父核心会从之前所在的物品上清除该声明。如果物品在没有经过模组自身清除逻辑的情况下丢失/被销毁，管理员可以使用 /itemattr forcerest godfather 强制重置该声明。

---

护甲通量核心

与武器核心完全独立的池子，在头盔/胸甲/护腿/靴子上滚动/设置。属性加成作为真实的属性修饰符应用，并与当前穿戴的装备绑定——取下一件装备，加成会在同一游戏刻消失，无残留药水效果。

核心	默认滚动权重	亮点
通量	55%	更多护甲 + 韧性，周期性耐久度自修复，穿戴期间获得速度 I。
枢纽	25%	紫色粒子。更大的攻击/防御/机动性提升。免疫跌落、火焰和溺水伤害。
星辰	15%	红色粒子。毒素 + 环境免疫。大幅属性提升。被击中后有 5% 几率获得 1 秒无敌。
顶点	4.9%	黑色粒子。毒素 + 环境免疫。超人属性。每件穿戴的装备提供 25% 伤害减免，上限 55%。
全框架	0.1%	金色粒子 + 25 格金色地面光环。装备部件不可破坏。神级属性。每件装备提供 75% 伤害减免，上限 75%。毒素 + 环境免疫。授予 命运眷顾 进度。

武器核心绝不会在护甲部件上起作用，护甲核心也绝不会在武器/工具上起作用——这在 GUI 中（按钮置灰）和服务器端（无法被修改过的客户端绕过）均强制执行。

全框架额外功能

• 排斥（按键绑定，默认 R）：一次音爆击退冲击。需穿戴至少一件全框架装备。威力随穿戴件数（1–4）缩放：
  • 半径：8 → 32 格。
  • 击退强度增加。
  • 冷却时间：1 件时 45 秒，降至完整 4 件套时的 5 秒（两端均可配置）。
  • 被击飞的任何东西落地时会受到一次小型爆炸的真实伤害（也会波及附近其他生物）。
  • 施法者获得 5 秒无敌。
• 额外经验值：穿戴全框架会倍乘所有经验值获取——1 件 = 2 倍，线性缩放至完整 4 件套 = 5 倍。

---

全局物品模板

适用于每个特定物品类型实例的服务器全局默认属性/核心——例如“所有钻石剑初始拥有 15 点攻击伤害”。通过 /itemattr global 或在配置文件中直接配置。

• 无需触碰物品 NBT 即可生效，因此永远不会算作“改造”，也不会影响等级。
• 玩家一旦在他们自己的特定物品上显式设置（通过命令或菜单）了相同的属性/核心值，该值从此对该物品优先——全局默认值继续适用于该物品类型的其他所有未触碰的实例。
• 支持伤害、速度、距离、护甲、默认武器核心或默认护甲核心。神父不能被设为全局默认，因为同一时间只能存在一个。
• 模组会自动验证物品/属性的兼容性（例如，不能给剑设置armor，也不能给头盔设置武器core）。

---

命令

所有命令都在 /itemattr 下。标记为 (op) 的命令需要权限等级 2 以上。

命令	描述
/itemattr menu	为手持物品打开物品锻造 GUI。如果 allowSurvivalMenu 被禁用，非管理员将被阻止使用。
/itemattr info (op)	显示手持物品上的所有改造：等级、属性、核心和效果列表。
/itemattr clear (op)	清除手持物品上的所有改造（属性、效果、两种核心）。
/itemattr damage <数值> (op)	设置手持物品的攻击伤害。
/itemattr speed <数值> (op)	设置手持物品的攻击速度。
/itemattr range <数值> (op)	设置手持物品的攻击距离。
/itemattr armor <数值> (op)	设置手持物品的护甲值。
/itemattr effect add/remove/clear <效果> [等级] [秒数] (op)	管理持有效果（持有/穿戴时生效）。
/itemattr armoreffect add/remove/clear <效果> [等级] (op)	管理护甲效果（穿戴在护甲槽位时生效）。
/itemattr hiteffect add/remove/clear <效果> [等级] [秒数] (op)	管理命中效果（应用于你近战攻击的目标）。
/itemattr fluxcore set/clear <核心> (op)	强制设置或清除手持物品的武器通量核心（绕过 SSS/费用检查；拒绝护甲物品）。
/itemattr armorfluxcore set/clear <核心> (op)	强制设置或清除手持物品的护甲通量核心（拒绝非护甲物品）。
/itemattr block fluxcore/armorcore <核心> (op)	将核心添加到运行时封禁列表（在配置封禁列表之上）。
/itemattr unblock fluxcore/armorcore <核心> (op)	从运行时封禁列表中移除核心。
/itemattr forcerest godfather (op)	删除所有已加载的神父物品（物品栏、末影箱、掉落物）并解锁新的声明。
/itemattr destruction <百分比> (op)	实时调整终极能力的地形破坏比例（同时更新配置文件）。
/itemattr global set damage/speed/range/armor <物品> <数值> (op)	为某个物品类型的每个实例设置全局默认属性。
/itemattr global set core <物品> <核心> (op)	为某个物品类型设置全局默认武器核心（神父会被拒绝）。
/itemattr global set armorcore <物品> <核心> (op)	为某个物品类型设置全局默认护甲核心。
/itemattr global clear <物品> (op)	移除某个物品类型的所有全局模板覆盖。
/itemattr global list (op)	列出所有已配置的全局物品模板。
/itemattr particles wing/sparks/goldypressure/halo/truthorbs/armorcore <true|false>	为每个玩家切换该核心的粒子效果（仅当持有/穿戴具有该效果的核心时可用）。
/itemattr truthorbs attack <true|false>	切换神父的追踪真理之球自动攻击。
/itemattr godlypressure effects <true|false>	在不移除核心的情况下，开启/关闭手持物品的神压光环。

---

按键绑定

两者均在控制设置中的“物品属性”类别下注册：

操作	默认键	备注
打开物品锻造菜单	M	立即打开 /itemattr menu。实际上会向服务器发送请求，服务器应用与命令相同的 allowSurvivalMenu 限制——按键绑定无法绕过仅限管理员的锁定。
全框架排斥	R	仅当穿戴至少一件全框架护甲装备时可用。

终极武器核心能力没有单独的按键绑定——它们使用原版的攻击/使用键：潜行+攻击、潜行+使用，以及 Alt+攻击（每个核心如何使用它们，请参见上面的武器通量核心表）。

---

配置

首次启动时在 config/itemattributes-common.toml 生成。以下所有值均为默认值。

[costs]

键	默认值	含义
costMultiplier	2.0	应用于每项计算费用的全局倍率。
moddedEffectMultiplier	2.0	非原版命名空间效果的倍率。
effectTierMultiplier	3.0	每高于 1 级的放大器等级倍率。
vanillaEffectBaseCost	30	原版 1 级效果的基础费用。
damageCostPerPoint	10.0	每点请求的攻击伤害费用。
speedCostPerPoint	15.0	每点请求的攻击速度费用。
rangeCostPerPoint	50.0	每点请求的攻击距离费用。
armorCostPerPoint	10.0	每点请求的护甲费用。
weaponFluxCoreCost	500	设置特定武器核心的基础费用。
armorFluxCoreCost	500	设置特定护甲核心的基础费用。
randomFluxCoreCost	50	滚动随机核心的基础费用（任一种池）。
maxLevelCostCap	-1	将任何单次改造的费用限制在此上限。-1 禁用上限。

[survival]

键	默认值	含义
allowSurvivalMenu	true	若为 false，只有管理员可以打开菜单或处理改造数据包。

[weaponFluxCores] / [armorFluxCores]

键	默认值	含义
bannedCores	[]	生存玩家无法滚动/设置的核心（管理员仍然可以强制设置）。
weights.*	见上方表格	每个核心的滚动权重。

[abilities]

键	默认值	含义
reaperDamageMultiplier	1.5	死神的真实伤害倍率。
godfatherDamageMultiplier	3.0	神父的真实伤害倍率。
primordialRagePercentPerKill	1.25	每次原始之怒击杀提供的真实伤害加成百分比。
primordialRageMaxPercent	5000.0	原始之怒加成百分比上限。
juggernautExplosionDamage	4.0	主宰的命中爆炸伤害。
juggernautExplosionRadius	2.0	主宰的命中爆炸半径。
celestialDivideDamage	50.0	天界的分裂斩能力伤害。
primordialClawDamage	50.0	原始的恶魔之爪伤害。
primordialShockwaveDamage	250.0	原始的龙族冲击波伤害。
godfatherSlashDamage	150.0	神父的全能斩击伤害。
godfatherPushDamage	500.0	神父的全能推击伤害。
godfatherOrbDamage	25.0	神父的真理之球伤害。
omniframeRepelImpactDamage	30.0	排斥击飞的实体着地时造成的真实伤害。

[destruction]

键	默认值	含义
terrainDestructionEnabled	true	终极能力清除地形的总开关。
destructionScalePercent	100.0	缩放地形清除半径/长度/深度（0–200%）。可通过 /itemattr destruction 实时调整。

[cooldowns]（单位均为秒）

键	默认值
celestialFreezeCooldownSeconds	120
celestialDivideCooldownSeconds	30
primordialClawCooldownSeconds	30
primordialShockwaveCooldownSeconds	300
godfatherSlashCooldownSeconds	20
godfatherPushCooldownSeconds	300
omniframeRepelCooldownSeconds	45（穿戴 1 件全框架装备时）
omniframeRepelCooldownMinSeconds	5（穿戴完整 4 件套全框架时）

[materialRequirements]

字符串列表，每个规则一条："操作:模组ID:物品ID:数量"，例如 "SET_FLUX_CORE:minecraft:nether_star:1" 要求设置武器核心时需要 1 个下界之星（除了经验值之外）。有效的 操作 值：SET_DAMAGE、SET_SPEED、SET_RANGE、SET_ARMOR、ADD_HOLD_EFFECT、ADD_ARMOR_EFFECT、ADD_HIT_EFFECT、SET_FLUX_CORE、SET_ARMOR_FLUX_CORE、RANDOM_FLUX_CORE、RANDOM_ARMOR_FLUX_CORE。

[globalItemTemplates]

字符串列表，每个物品一条："物品ID;键=值;键=值..."，例如 "minecraft:diamond_sword;Damage=15;Core=reaper"。有效键：Damage、Speed、Range、Armor（数字）、Core（武器通量核心，神父会被拒绝）、ArmorCore（护甲通量核心）。在游戏中使用 /itemattr global 管理此列表比手动编辑更简单。

---

给管理员的说明

• 此模组中的每个数值都可以在不重新编译的情况下调整——请参阅上面的配置部分。
• 等级/SSS 系统和通量核心扭蛋是唯一受费用和进度限制的内容；全局物品模板和管理员强制设置命令按设计完全绕过这些限制（它们是管理员/服务器的决定，而非玩家的刷刷刷）。
• 清地形终极能力不检查领地声明或世界保护插件——如果担心恶意破坏，请使用 terrainDestructionEnabled=false 或较低的 destructionScalePercent。
• 冷却时间、滚动权重和封禁列表会从配置文件中重新加载；运行时 /itemattr block 和 /itemattr destruction 的更改会自动写回配置文件。