Mentalitys | 自定义附魔

Mentalitys | 自定义附魔

Mentality | Custom Enchantments 是一个适用于 Minecraft 1.20.1(Fabric API)的模组,添加了自定义附魔。

冒险

Mentalitys | 自定义附魔

俄语版本

一个面向 Fabric API 的 Minecraft 1.20.1 模组,通过 Cloth Config API 添加具有灵活配置的独特附魔。


附魔

⚔️ 光击

一种适用于剑、斧和三叉戟的武器附魔。命中时,对目标施加发光效果,使其可以穿墙可见。

等级 持续时间 刻数
I 2 秒 40
II 4 秒 80
III 7 秒 140
  • 稀有度: 稀有
  • 最高等级: 3
  • 与击退不兼容;当应用于三叉戟时——也与暗影之刃不兼容
  • 仅当攻击者为玩家且目标为生物实体时触发效果
  • 每个等级的持续时间可配置

🦘 二段跳

一种靴子附魔。允许玩家在空中进行第二次跳跃。

等级 效果
I 二段跳
  • 稀有度: 极稀有
  • 最高等级: 1
  • 二段跳时在玩家下方生成白色粒子
  • 67% 几率消耗靴子 1 点耐久度(耐久附魔可降低此几率)
  • 仅在水或岩浆中不起作用时生效
  • 可通过配置启用/禁用

⛏️ 钻探

一种适用于镐和锹的工具附魔。在中心方块周围3×3 区域破坏方块。

等级 效果
I 3×3 挖掘
  • 稀有度: 极稀有
  • 最高等级: 1
  • 潜行时禁用(Shift)——允许精确的单方块挖掘
  • 3×3 平面由被挖掘方块的面决定
  • 每破坏一个额外方块消耗 1 点耐久度(耐久附魔适用)
  • 仅破坏适合该工具的方块;不可破坏的方块(基岩等)会被跳过
  • 可通过配置启用/禁用

🗡️ 毒刃

一种适用于剑和斧的武器附魔。命中时,对目标施加中毒效果。

等级 持续时间
I 2 秒
II 3 秒
III 4 秒
  • 稀有度: 稀有
  • 最高等级: 3
  • 与火焰附加不兼容
  • 仅当攻击者为玩家且目标为生物实体时触发效果
  • 每个等级的持续时间可配置
  • 可从附魔台和村民交易获得

🪵 伐木工

一种斧附魔。通过破坏一个原木方块砍倒整棵树。智能检测确保只砍伐自然树木原木——不会破坏玩家建造的结构。

等级 树木大小 最大方块数
I 小树 16
II 中等树木 48
III 大树 128
  • 稀有度: 稀有
  • 最高等级: 3
  • 仅破坏相同类型的原木方块(橡木、桦木、云杉、绯红、诡异等)
  • 不作用于 _wood 或 hyphae 方块(由锯木厂/工作台制作的完整树皮方块)
  • 适用于下界树木(绯红和诡异菌柄)
  • 验证方块是否为自然树木的一部分(检查顶部的树叶或疣块)
  • 不破坏原始方块下方的方块(对原木墙安全)
  • 每破坏一个原木消耗 1 点耐久度(耐久附魔适用)
  • 可通过配置启用/禁用;每个等级的最大方块数可配置

🗡️ 暗影之刃

一种三叉戟附魔。命中时,有几率将玩家传送到目标背后并对目标施加缓慢 II。

等级 几率 缓慢持续时间
I 15% 1 秒
II 25% 2 秒
III 35% 3 秒
  • 稀有度: 极稀有
  • 最高等级: 3
  • 与引雷、激流和光击不兼容
  • 将玩家传送到目标实体背后 1.5 格处,面向目标
  • 距离加成: 从 30 格远投掷时最多 +10% 几率(线性缩放)
  • 几率和缓慢持续时间可按等级配置
  • 可从附魔台和村民交易获得

🧲 磁力

一种适用于镐、斧、锹和锄的工具附魔。挖掘方块时,可配置半径内的物品会自动拾取到玩家物品栏中。

等级 效果
I 5 格范围内自动拾取
  • 稀有度: 稀有
  • 最高等级: 1
  • 与钻探和伐木工配合使用——收集额外方块的所有掉落物
  • 拾取半径可配置(默认:5 格)
  • 可从附魔台和村民交易获得
  • 可通过配置启用/禁用

🔥 自动冶炼

一种镐附魔。挖掘需要冶炼的矿石时,自动掉落冶炼后的产物而非原矿。

等级 效果
I 自动冶炼铁、金、铜矿石
  • 稀有度: 稀有
  • 最高等级: 1
  • 仅适用于有冶炼配方的矿石(铁、金、铜矿石及其深层变种)
  • 冶炼时给予冶炼经验
  • 与时运不兼容
  • 可从附魔台和村民交易获得
  • 可通过配置启用/禁用

🌱 植被

一种锄附魔。破坏成熟作物时,有几率自动补种。

等级 几率
I 30%
II 60%
III 100%
  • 稀有度: 稀有
  • 最高等级: 3
  • 适用于小麦、胡萝卜、马铃薯、甜菜根和下界疣
  • 收获后在下一个服务器刻补种
  • 新补种的作物在 0.5 秒内受到保护,防止意外破坏
  • 每个等级的几率可配置
  • 可从附魔台和村民交易获得
  • 可通过配置启用/禁用

🛡️ 反弹

一种盾牌附魔。格挡近战攻击时,击退攻击者并给玩家一个小的向后冲量。

等级 击退强度
I 0.5
II 1.0
III 2.0
  • 稀有度: 稀有
  • 最高等级: 3
  • 不造成伤害
  • 消耗额外盾牌耐久度(每级 1 点)
  • 玩家也会受到小的自身击退(攻击者击退的 15%)
  • 每个等级的击退强度可配置
  • 与反馈和守护者之恩不兼容
  • 可从附魔台和村民交易获得
  • 可通过配置启用/禁用

🛡️ 反馈

一种盾牌附魔。格挡魔法攻击(伤害药水、伤害箭、潜影贝子弹等)时,完全取消受到的伤害,恢复盾牌耐久度,并在举盾期间清除所有活跃的有害效果(中毒、瞬间伤害、缓慢等)。同时在格挡时防止新的有害效果被施加。

等级 效果
I 取消魔法伤害,清除效果,恢复耐久度
  • 稀有度: 稀有
  • 最高等级: 1
  • 完全格挡来自伤害药水/箭的瞬间伤害(v2.9 修复)
  • 在 hurt() 中于伤害应用前取消魔法伤害
  • 魔法格挡时清除所有当前活跃的有害效果
  • 作为格挡奖励,盾牌耐久度部分恢复
  • 耐久度恢复量可配置
  • 与反弹和守护者之恩不兼容
  • 可从附魔台和村民交易获得
  • 可通过配置启用/禁用

🪱 二次呼吸

一种胸甲附魔。当玩家生命值降至1 颗心(2 HP)以下时,立即获得一波生存效果。效果持续时间随拥有该附魔的护甲件数缩放。

附魔件数 速度 II 持续时间 抗性 I 持续时间
1 2 秒 1 秒
2 3 秒 1 秒
3 3 秒 2 秒
4 4 秒 2 秒
  • 稀有度: 极稀有
  • 最高等级: 1
  • 可应用于头盔、胸甲、护腿和靴子
  • 当生命值 ≤ 2.0 HP(1 颗心)时触发
  • 给予速度 II、抗性 I和100% 击退抗性
  • 视觉效果: 烟雾和云粒子(无屏幕覆盖)
  • 冷却: 60 秒(可配置)
  • 可从附魔台和村民交易获得
  • 可通过配置启用/禁用

🛡️ 守护者之恩

一种盾牌附魔。成功格挡攻击时,有几率将部分格挡伤害转化为食物(恢复饱和度)。满级时,还会稀有地治疗玩家。

等级 食物恢复几率 额外效果
I 10% —
II 20% —
III 30% +10% 几率治疗 1 颗心
  • 稀有度: 稀有
  • 最高等级: 3
  • 触发时恢复 1 点食物(半个可视化鸡腿)
  • III 级:额外 10% 几率治疗 2 HP(1 颗心)
  • 每个等级的几率可配置
  • 与反弹和反馈不兼容
  • 可从附魔台和村民交易获得
  • 可通过配置启用/禁用

🎯 易伤

一种弓和弩附魔。此弓射出的箭部分忽略目标的护甲值,穿透保护。

等级 护甲忽略
I 10%
II 20%
III 30%
  • 稀有度: 稀有
  • 最高等级: 3
  • 适用于普通箭、火焰箭和其他弹射物类型
  • 在计算伤害时降低有效护甲值和韧性值
  • 每个等级的百分比可配置
  • 可从附魔台和村民交易获得
  • 可通过配置启用/禁用

🎣 牵引大师

一种钓鱼竿附魔。收线勾住的生物时增加拉力。

等级 拉力
I +15%
II +25%
III +40%
  • 稀有度: 罕见
  • 最高等级: 3
  • 对钓鱼竿勾住的任何生物有效
  • 可从附魔台和村民交易获得
  • 可通过配置启用/禁用

⚡ 天空之怒

一种弓和弩附魔。雷暴期间,箭有几率在命中位置召唤闪电。

等级 几率
I 10%
II 20%
III 30%
  • 稀有度: 稀有
  • 最高等级: 3
  • 仅在雷暴期间激活(非普通降雨)
  • 在屋顶下不起作用——命中位置必须暴露于天空
  • 每玩家冷却:两次闪电之间 1.5 秒(30 刻)
  • 不兼容: 火矢、无限、穿透
  • 可从附魔台和村民交易获得
  • 可通过配置启用/禁用

✨ 经验虹吸

一种剑附魔。对生物的攻击有几率在生物死亡前掉落经验球。

等级 几率 经验
I 5% 1
II 10% 2
III 15% 3
  • 稀有度: 罕见
  • 最高等级: 3
  • 对任何生物有效,包括首领
  • 可从附魔台和村民交易获得
  • 可通过配置启用/禁用

💥 动能释放

一种鞘翅附魔。快速鞘翅飞行后着陆在地面会制造冲击波,击退附近的生物。波强度取决于附魔等级。

等级 半径 效果
I 3 格 弱击退
II 5 格 中等击退
III 7 格 强击退 + 对所有命中实体造成 2 HP 伤害
  • 稀有度: 稀有
  • 最高等级: 3
  • 仅当着陆速度 ≥ 0.4 格/刻(可配置)时触发
  • III 级(被动): 飞行期间,90% 的耐久度消耗被返还(≈−90% 鞘翅磨损)
  • III 级: 冲击波激活仅有 10% 几率消耗耐久度(90% 免费)
  • 视觉效果:中心爆炸粒子 + 波半径处的噗噗粒子环
  • 所有参数(速度阈值、击退、伤害)可配置
  • 可从附魔台和村民交易获得
  • 可通过配置启用/禁用

🌑 幽匿绽放

一种剑附魔。击杀生物时,幽匿在死亡位置蔓延——就像放置了幽匿催发体一样。

等级 效果
I 小型幽匿绽放(≈2–3 格半径)
II 大型幽匿绽放(≈4–5 格半径)
  • 稀有度: 稀有
  • 最高等级: 2
  • 仅对用附魔武器直接击杀有效
  • 可按照自然传播规则将土壤、石头和其他方块转化为幽匿
  • 可能生成幽匿脉络、传感器或尖啸体
  • 可从附魔台和村民交易获得
  • 可通过配置启用/禁用

获取

附魔书可从图书管理员村民处购买:

附魔 村民等级 价格
光击 I 新手 (1) 10 绿宝石
光击 II 老手 (3) 28 绿宝石
光击 III 大师 (5) 48 绿宝石
二段跳 I 专家 (4) 38 绿宝石
钻探 I 大师 (5) 50 绿宝石
毒刃 I 新手 (1) 12 绿宝石
毒刃 II 老手 (3) 30 绿宝石
毒刃 III 大师 (5) 50 绿宝石
伐木工 I 学徒 (2) 14 绿宝石
伐木工 II 专家 (4) 32 绿宝石
伐木工 III 大师 (5) 52 绿宝石
暗影之刃 I 学徒 (2) 16 绿宝石
暗影之刃 II 专家 (4) 34 绿宝石
暗影之刃 III 大师 (5) 54 绿宝石
磁力 I 老手 (3) 24 绿宝石
自动冶炼 I 专家 (4) 32 绿宝石
植被 I 学徒 (2) 14 绿宝石
植被 II 专家 (4) 30 绿宝石
植被 III 大师 (5) 48 绿宝石
反弹 I 学徒 (2) 16 绿宝石
反弹 II 专家 (4) 32 绿宝石
反弹 III 大师 (5) 50 绿宝石
反馈 I 老手 (3) 22 绿宝石
二次呼吸 I 大师 (5) 52 绿宝石
守护者之恩 I 学徒 (2) 16 绿宝石
守护者之恩 II 专家 (4) 32 绿宝石
守护者之恩 III 大师 (5) 50 绿宝石
易伤 I 学徒 (2) 18 绿宝石
易伤 II 专家 (4) 36 绿宝石
易伤 III 大师 (5) 52 绿宝石
牵引大师 I 新手 (1) 10 绿宝石
牵引大师 II 老手 (3) 22 绿宝石
牵引大师 III 专家 (4) 36 绿宝石
天空之怒 I 老手 (3) 22 绿宝石
天空之怒 II 专家 (4) 38 绿宝石
天空之怒 III 大师 (5) 55 绿宝石
经验虹吸 I 学徒 (2) 14 绿宝石
经验虹吸 II 老手 (3) 26 绿宝石
经验虹吸 III 专家 (4) 40 绿宝石
动能释放 I 专家 (4) 28 绿宝石
动能释放 II 大师 (5) 44 绿宝石
动能释放 III 大师 (5) 62 绿宝石
幽匿绽放 I 专家 (4) 30 绿宝石
幽匿绽放 II 大师 (5) 50 绿宝石

所有附魔也可从附魔台获得。


配置(Cloth Config)

本模组通过 Cloth Config API 支持配置。配置文件:config/custom-enchants.json。

参数

参数 默认值 描述
glowStrikeEnabled true 启用/禁用光击
glowStrikeDurationL1 40 I 级持续时间(刻)
glowStrikeDurationL2 80 II 级持续时间(刻)
glowStrikeDurationL3 140 III 级持续时间(刻)
doubleJumpEnabled true 启用/禁用二段跳
drillEnabled true 启用/禁用钻探
poisonBladeEnabled true 启用/禁用毒刃
poisonBladeDurationL1 40 I 级持续时间(刻)
poisonBladeDurationL2 60 II 级持续时间(刻)
poisonBladeDurationL3 80 III 级持续时间(刻)
lumberjackEnabled true 启用/禁用伐木工
lumberjackMaxBlocksL1 16 I 级最大方块数
lumberjackMaxBlocksL2 48 II 级最大方块数
lumberjackMaxBlocksL3 128 III 级最大方块数
shadowBladeEnabled true 启用/禁用暗影之刃
shadowBladeChanceL1 15 I 级几率(%)
shadowBladeChanceL2 25 II 级几率(%)
shadowBladeChanceL3 35 III 级几率(%)
shadowBladeSlowDurationL1 20 I 级缓慢持续时间(刻)
shadowBladeSlowDurationL2 40 II 级缓慢持续时间(刻)
shadowBladeSlowDurationL3 60 III 级缓慢持续时间(刻)
magnetEnabled true 启用/禁用磁力
magnetRadius 5 拾取半径(格)
autoSmeltEnabled true 启用/禁用自动冶炼
vegetationEnabled true 启用/禁用植被
vegetationChanceL1 30 I 级几率(%)
vegetationChanceL2 60 II 级几率(%)
vegetationChanceL3 100 III 级几率(%)
reboundEnabled true 启用/禁用反弹
reboundKnockbackL1 5 I 级击退(×0.1)
reboundKnockbackL2 10 II 级击退(×0.1)
reboundKnockbackL3 20 III 级击退(×0.1)
feedbackEnabled true 启用/禁用反馈
feedbackHealAmount 2.0 治疗量(HP)
feedbackRepairAmount 2 恢复的耐久度
secondWindEnabled true 启用/禁用二次呼吸
secondWindSpeedDuration 5 速度 II 持续时间(秒)
secondWindCooldown 60 冷却(秒)
guardiansGraceEnabled true 启用/禁用守护者之恩
guardiansGraceChanceL1 10 I 级几率(%)
guardiansGraceChanceL2 20 II 级几率(%)
guardiansGraceChanceL3 30 III 级几率(%)
vulnerabilityEnabled true 启用/禁用易伤
vulnerabilityIgnoreL1 10 I 级护甲忽略(%)
vulnerabilityIgnoreL2 20 II 级护甲忽略(%)
vulnerabilityIgnoreL3 30 III 级护甲忽略(%)
tetherMasterEnabled true 启用/禁用牵引大师
skyRageEnabled true 启用/禁用天空之怒
skyRageCooldownTicks 30 两次闪电之间的冷却(刻)
xpSyphonEnabled true 启用/禁用经验虹吸
kineticDischargeEnabled true 启用/禁用动能释放
kineticDischargeMinSpeed 0.4 触发的最小飞行速度(格/刻)
kineticDischargeKnockbackL1 1.5 I 级击退强度
kineticDischargeKnockbackL2 2.5 II 级击退强度
kineticDischargeKnockbackL3 3.5 III 级击退强度
kineticDischargeDamageL3 2.0 III 级额外伤害(HP)
sculkBloomEnabled true 启用/禁用幽匿绽放

项目结构

src/main/java/com/mentality/customenchants/
├── CustomEnchantsMod.java         — 主模组类,交易注册
├── config/
│   ├── ModConfig.java             — JSON 配置加载/保存
│   └── ModConfigScreen.java       — GUI 设置界面(Cloth Config)
└── enchantment/
    ├── ModEnchantments.java       — 附魔注册
    ├── GlowStrikeEnchantment.java — 光击逻辑
    ├── DoubleJumpEnchantment.java — 二段跳定义
    ├── DoubleJumpServerHandler.java — 服务端二段跳 + 耐久度
    ├── DrillEnchantment.java      — 钻探定义
    ├── DrillHandler.java          — 服务端 3×3 挖掘逻辑
    ├── PoisonBladeEnchantment.java — 毒刃逻辑
    ├── LumberjackEnchantment.java — 伐木工定义
    ├── LumberjackHandler.java     — 服务端砍树逻辑
    ├── ShadowBladeEnchantment.java — 暗影之刃逻辑
    ├── MagnetEnchantment.java     — 磁力定义
    ├── MagnetHandler.java         — 服务端自动拾取逻辑
    ├── AutoSmeltEnchantment.java  — 自动冶炼定义
    ├── AutoSmeltHandler.java      — 服务端自动冶炼逻辑
    ├── VegetationEnchantment.java — 植被定义
    ├── VegetationHandler.java     — 服务端自动补种逻辑
    ├── ReboundEnchantment.java    — 反弹定义
    ├── FeedbackEnchantment.java   — 反馈定义
    ├── SecondWindEnchantment.java  — 二次呼吸定义(所有护甲槽位)
    ├── SecondWindHandler.java      — 服务端二次呼吸逻辑(按件数缩放)
    ├── GuardiansGraceEnchantment.java — 守护者之恩定义
    ├── XpSyphonEnchantment.java   — 经验虹吸定义
    ├── KineticDischargeEnchantment.java — 动能释放定义
    ├── KineticDischargeHandler.java — 服务端着陆冲击波逻辑
    ├── SculkBloomEnchantment.java — 幽匿绽放定义
    ├── SculkBloomHandler.java     — 服务端击杀时幽匿蔓延逻辑
    └── ModEnchantments.java       — 附魔注册

src/client/java/com/mentality/customenchants/
├── CustomEnchantsClient.java      — 客户端初始化器
├── config/
│   └── ModConfigScreen.java       — GUI 设置界面(Cloth Config)
└── enchantment/
    ├── DoubleJumpHandler.java     — 客户端二段跳逻辑
    └── SecondWindClientHandler.java — 客户端二次呼吸效果

需求

  • Minecraft 1.20.1
  • Fabric Loader ≥ 0.18.4
  • Fabric API
  • Cloth Config API ≥ 11.0.0
  • Java 21+

构建

./gradlew build

编译后的 jar 位于 build/libs/。

许可证

CC0-1.0