进一步难度配置

进一步难度配置

可配置阶段的渐进式难度模组。由事件触发,每个阶段提升生物属性(生命值、护甲等),包含黑名单、四种进度模式、热重载和阶段管理命令。

冒险

Further Difficulty

Further Difficulty 是一个 Minecraft NeoForge 模组,旨在通过可配置的世界进度系统来增加渐进式难度。你可以定义多个阶段,每个阶段拥有独立的触发条件、生物黑名单和属性修饰符(生命值、护甲、护甲韧性、攻击伤害)。所有配置均通过简单的 JSON 文件完成,模组支持游戏内指令重载和进度管理。

✨ 特性

  • 多阶段进度 – 支持无限数量的阶段,每个阶段拥有唯一 ID。
  • 四种进度模式 – strict、progressive、unordered 和 first_only,以满足各种难度设计。
  • 灵活的触发条件 – 阶段可通过进入维度(例如 minecraft:the_nether)或击杀特定生物(例如 minecraft:ender_dragon)触发。
  • 生物黑名单 – 每个阶段拥有自己的黑名单;未解锁阶段中的生物不会自然生成(刷怪蛋仍然有效)。
  • 属性修饰符 – 可独立对生命值、护甲、护甲韧性和攻击伤害进行乘法/加法修饰。
  • 热重载指令 – /furtherdifficulty reload 无需重启服务器即可重载 config/further_difficulty.json。
  • 进度管理指令
    • /furtherdifficulty progress set <stageId> – 强制完成某个阶段。
    • /furtherdifficulty progress reset – 重置所有进度(用于测试/调试)。
  • 完全本地化 – 指令反馈支持多种语言(内置英文和简体中文)。
  • 开源 & MIT 许可证 – 可自由使用、修改和再分发。

📥 安装

  1. 确保已安装 NeoForge 1.21.1 或兼容版本。
  2. 将下载的 further_difficulty-X.X.X.jar 放入 mods 文件夹。
  3. 首次运行时,默认配置文件 further_difficulty.json 将在 config 目录中生成。

⚙️ 配置

配置文件位于 config/further_difficulty.json,使用 JSON 格式。默认内容如下:

{
  "mode": "strict",
  "stages": [
    {
      "id": "nether_entry",
      "trigger": {
        "type": "dimension",
        "target": "minecraft:the_nether"
      },
      "triggerMessage": "A tremor echoes from the core...",
      "blacklist": [],
      "modifiers": {
        "healthMultiplier": 1.5,
        "healthAddition": 0.0,
        "armorMultiplier": 2.0,
        "armorAddition": 5.0,
        "toughnessMultiplier": 2.0,
        "toughnessAddition": 5.0,
        "attackMultiplier": 2.0,
        "attackAddition": 0.0
      }
    },
    {
      "id": "dragon_kill",
      "trigger": {
        "type": "kill",
        "target": "minecraft:ender_dragon"
      },
      "triggerMessage": "You have broken an ancient taboo...",
      "blacklist": [],
      "modifiers": {
        "healthMultiplier": 2.0,
        "healthAddition": 0.0,
        "armorMultiplier": 2.0,
        "armorAddition": 5.0,
        "toughnessMultiplier": 2.0,
        "toughnessAddition": 5.0,
        "attackMultiplier": 2.0,
        "attackAddition": 0.0
      }
    }
  ]
}

顶层字段

字段 类型 描述
mode string 进度模式(见下表)
stages array 阶段列表,按顺序定义(索引 0,1,2,...)

阶段字段

字段 类型 描述
id string 阶段的唯一标识符,用于指令和存储
trigger object 触发条件,包含 type 和 target
triggerMessage string 阶段首次触发时广播的全局消息
blacklist array 该阶段锁定期间禁止生成的实体 ID 列表(例如 "minecraft:skeleton")
modifiers object 属性修饰符设置(见下文)

修饰符字段

字段 类型 描述
healthMultiplier double 生命值倍数
healthAddition double 生命值固定加值
armorMultiplier double 护甲倍数
armorAddition double 护甲固定加值
toughnessMultiplier double 护甲韧性倍数
toughnessAddition double 护甲韧性固定加值
attackMultiplier double 攻击伤害倍数
attackAddition double 攻击伤害固定加值

注意: 最终属性值 = (基础值 × 倍数) + 加值。所有已解锁阶段的修饰符会累积应用(倍数相乘,加值相加)。

📈 阶段扩展与限制

1. 阶段数量限制

在内部,模组使用 int 位掩码来存储已完成的阶段索引,最多支持 31 个阶段(位 0 到 30)。这是因为 Java int 是 32 位有符号整数;最高位(第 31 位)是符号位,剩余 31 个可用位。如果配置超过 31 个阶段,多余的阶段将无法被正确存储或识别。

如果你需要超过 31 个阶段,可以修改源代码:

  • 将 ModAttachments.java 中 COMPLETED_CONDITIONS 的类型从 Codec.INT 改为 Codec.LONG(最多支持 63 个阶段),并更新所有位操作(将 1 << i 替换为 1L << i)。
  • 或者,使用 BitSet 并将其序列化为字节数组(理论上无限制)。

2. 如何添加新阶段

添加新阶段很简单:只需在配置文件的 stages 数组末尾追加一个新的阶段对象。请记住:

  • 每个阶段必须拥有唯一 ID(例如 "ender_dragon_kill")。
  • 阶段顺序很重要:
    • 在 strict 模式下,阶段必须按顺序触发(阶段 0 → 阶段 1 → 阶段 2 → ...)。
    • 在 progressive 模式下,完成阶段 N 会自动激活从阶段 0 到 N 的所有阶段(累积)。
    • 在 unordered 和 first_only 模式下,没有顺序依赖,但已完成列表仍按 ID 记录。
  • 添加新阶段不会影响现有进度。已完成阶段 ID 列表保持不变,但激活位掩码会根据新阶段顺序和当前模式重新计算。 例如:在 progressive 模式下,如果玩家已完成阶段 2,添加新阶段 3 不会自动激活阶段 3(玩家必须完成其触发条件)。但是,阶段 0–2 仍然生效。

示例:添加第三个阶段(击杀末影龙)

{
  "mode": "progressive",
  "stages": [
    // ... previous stages ...
    {
      "id": "ender_dragon_kill",
      "trigger": { 
        "type": "kill", 
        "target": "minecraft:ender_dragon" 
      },
      "triggerMessage": "The dragon falls, the world trembles...",
      "blacklist": [],
      "modifiers": {
        "healthMultiplier": 3.0,
        "healthAddition": 10,
        "armorMultiplier": 1.5,
        "armorAddition": 2,
        "toughnessMultiplier": 1.5,
        "toughnessAddition": 2,
        "attackMultiplier": 2.0,
        "attackAddition": 3
      }
    }
  ]
}

🎮 指令

所有指令需要权限等级 2(通常为操作员/管理员)。指令前缀为 /furtherdifficulty。

指令 描述
/furtherdifficulty reload 重载配置文件 config/further_difficulty.json
/furtherdifficulty progress set <stageId> 强制完成指定阶段(如果尚未完成)
/furtherdifficulty progress reset 重置所有进度(清空已完成阶段)

示例

/furtherdifficulty reload
/furtherdifficulty progress set nether_entry
/furtherdifficulty progress reset

🧠 进度模式

模式名称 配置值 行为描述
严格 strict 阶段必须按顺序完成:必须先完成阶段 1 才能完成阶段 2,完成阶段 2 才能完成阶段 3,以此类推。
递进 progressive 完成阶段 N 会自动激活从阶段 0 到 N 的所有阶段效果(累积)。例如:完成阶段 2 会应用阶段 0、1 和 2。
无序 unordered 阶段可以任意顺序触发;每个阶段的效果独立且累积应用。完成阶段 0 和阶段 2 会同时应用两者。
仅首次 first_only 只有第一个触发的阶段生效;后续阶段被忽略(仅广播其消息)。

💾 数据存储

进度数据使用 NeoForge 的 Attachment 系统存储在主世界的 level.dat 中。这意味着:

  • 进度是全局的,影响所有维度。
  • 数据随世界保存,并在服务器重启后保留。
  • 在多人游戏中,所有玩家共享同一进度(由第一个触发阶段的玩家决定)。

存储的数据:

  • completed_conditions:已完成阶段 ID 列表(List<String>)。
  • first_condition:第一个完成阶段的 ID(String,用于 first_only 模式)。

🗑️ 卸载说明

  • 直接卸载模组是安全的;世界存档不会损坏或无法打开。

  • 注意:卸载模组后,任何已被模组增强的现存在生物将保留其提升后的属性(例如更高的生命值)。只有新生成的生物才会恢复原版强度。

  • 如果你希望彻底“净化”世界,可以考虑在卸载前使用指令 /furtherdifficulty progress reset 重置进度。但这不会改变已生成生物的属性。

📝 开发者信息

你可以自由地将此模组包含在你的整合包中。署名会受到赞赏,但并非必需。