盐度库

模组库,添加了一些属性。

基础库

Salinity — 通用库模组

Salinity 是我为个人模组开发的通用库模组,提供跨模组共享的属性系统和辅助工具,避免重复编写代码。

当前功能状态

以下功能在所有版本中可用(26.1 以下版本):

  • mitigation — 伤害减免
  • arrow_damage — 箭矢伤害加成
  • arrow_speed — 箭矢速度倍率
  • attack_range — 近战攻击距离

以下法术相关功能仅在 26.1 及以上版本提供(26.1 以下版本不包含):

1. 法术属性
1.1 法术伤害与法术强度
属性 ID 显示名称 默认值 说明
salinity:spell_damage 法术伤害 0.0 直接为法术伤害提供加成(可受修饰符影响)
salinity:spell_power 法术强度 0.0 对所有法术提供二次乘算加成(可受修饰符影响)
1.2 法术抗性
属性 ID 显示名称 默认值 说明
salinity:spell_resistance 法术抗性 0.0 减少受到的法术伤害;值越高减伤越多

所有属性均支持原版修饰符(ADD_VALUE、ADD_MULTIPLIED_BASE、ADD_MULTIPLIED_TOTAL),可灵活配置。

2. 伤害计算流程
2.1 总流程
原始伤害 → [法术伤害加成] → [法术强度加成] → [法术抗性减伤] → 最终伤害
2.2 法术伤害加成

将施法者的 spell_damage 属性应用到原始伤害上,按顺序处理所有修饰符:

  1. 累加所有 ADD_VALUE 修饰符 → add
  2. 累加所有 ADD_MULTIPLIED_BASE 修饰符 → mult_base
  3. 累加所有 ADD_MULTIPLIED_TOTAL 修饰符 → mult_total

公式:

after_spell_damage = (原始伤害 + add) × (1 + mult_base) × (1 + mult_total)
2.3 法术强度加成

将施法者的 spell_power 属性应用到上述结果,使用相同的修饰符顺序:

after_spell_power = (after_spell_damage + add_power) × (1 + mult_base_power) × (1 + mult_total_power)
2.4 法术抗性减伤

应用目标的法术抗性,同时考虑目标的原版盔甲韧性(minecraft:armor_toughness):

最终伤害 = after_spell_power × 200 / ( 法抗 × (1 + 韧性/10) × √(after_spell_power) + 200 )

其中:

  • 法抗:目标的 salinity:spell_resistance 属性值
  • 韧性:目标的 minecraft:armor_toughness 属性值(若无则为 0)
  • √(after_spell_power):法术强度加成后伤害的平方根

注意:如果法抗为 0,则跳过减伤步骤,最终伤害 = after_spell_power。

3. 法术抗性减伤示例表

以下表格假设施法者的 spell_damage 和 spell_power 均为 0(即无加成,after_spell_power = 原始伤害),仅展示抗性和韧性的影响。

3.1 韧性 = 0
原始伤害 法抗=5 法抗=10 法抗=20
10 9.27 8.63 7.60
20 17.99 16.35 13.82
40 34.54 30.39 24.50
3.2 韧性 = 3
原始伤害 法抗=5 法抗=10 法抗=20
10 9.07 8.30 7.09
20 17.46 15.50 12.65
40 33.18 28.35 21.95
3.3 韧性 = 6
原始伤害 法抗=5 法抗=10 法抗=20
10 8.88 7.98 6.64
20 16.97 14.73 11.66
40 31.93 26.56 19.88
3.4 韧性 = 12
原始伤害 法抗=5 法抗=10 法抗=20
10 8.52 7.42 5.90
20 16.05 13.41 10.08
40 29.68 23.59 16.73

所有数值均保留两位小数;实际游戏内数值为浮点数。

4. 伤害类型
  • 伤害类型 ID:salinity:spell
  • 特性:
    • 无视护甲
    • 不受原版保护附魔影响
    • 不触发原版魔法伤害相关效果(如药水保护)
5. 为物品添加法术属性(API 示例)
import net.minecraft.world.item.ItemStack;
import net.minecraft.world.entity.ai.attributes.AttributeModifier;

ItemStack staff = new ItemStack(ModItems.DOOM_STAFF.get());

// 添加 +5 法术伤害(ADD_VALUE)
SalinityAPI.addModifier(staff, ModAttributes.SPELL_DAMAGE, "staff_damage", 5.0, AttributeModifier.Operation.ADD_VALUE);

// 添加 +20% 法术强度(ADD_MULTIPLIED_BASE)
SalinityAPI.addModifier(staff, ModAttributes.SPELL_POWER, "staff_power", 0.2, AttributeModifier.Operation.ADD_MULTIPLIED_BASE);
6. 注意事项(仅法术功能)
  1. 抗性公式中的平方根确保低伤害时减伤较弱、高伤害时减伤显著。
  2. 若目标的法术抗性为 0,则完全跳过减伤步骤。
  3. 施法者的 spell_damage 和 spell_power 可通过装备、药水效果等动态修改。

使用说明

  • 对 Trial Catacombs:Salinity 是必需的前置依赖。如果使用 26.1 以下版本,法术相关属性将不会生效。
  • 对其他开发者:可随意将 Salinity 作为依赖使用,按需调用已注册的属性。如需使用法术系统,请确保版本 ≥ 26.1。

技术信息