Further Difficulty Config

模组

· 作者 saltlamp_

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

0 本站下载 0 关注 更新于 6 个月前

最新 1.0.0 · 26.1 · NeoForge

一键开服(送7天)

进一步难度

进一步难度(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": [
    // ... 之前的阶段 ...
    {
      "id": "ender_dragon_kill",
      "trigger": { 
        "type": "kill", 
        "target": "minecraft:ender_dragon" 
      },
      "triggerMessage": "巨龙陨落,世界震颤……",
      "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 strict 阶段必须按顺序完成:阶段 1 必须在阶段 2 之前完成,阶段 2 必须在阶段 3 之前完成,以此类推。
Progressive progressive 完成阶段 N 会自动激活阶段 0 到 N 的所有效果(累积式)。示例:完成阶段 2 会应用阶段 0、1 和 2 的效果。
Unordered unordered 阶段可以以任何顺序触发;每个阶段的效果独立且累积地应用。完成阶段 0 和阶段 2 会同时生效。
First Only first_only 只有第一个触发的阶段生效;后续阶段被忽略(仅广播其消息)。

? 数据存储

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

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

存储的数据:

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

?️ 卸载说明

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

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

  • 如果你希望完全“净化”世界,可以考虑在使用命令 /furtherdifficulty progress reset 重置进度后再卸载模组。但是,这不会改变已经生成的生物的属性。

? 开发者信息

你可以自由地将此模组包含在你的整合包中。署名是受欢迎的,但不是必需的。

- 中文介绍:

Further Difficulty

Further Difficulty 旨在通过可配置的世界进度机制,为游戏增加渐进式难度。

你可以定义多个阶段(Stage),每个阶段可独立配置触发条件、生物黑名单和属性增强(生命值、护甲、护甲韧性、攻击力)。

所有配置通过简单的 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 许可证:允许自由使用、修改和整合。

? 安装

  • 确保已安装 NeoForge 1.21.1 或兼容版本。

  • 将下载的 further_difficulty-X.X.X.jar 放入 mods 文件夹。

  • 首次启动游戏会在 config 目录下生成默认配置文件 further_difficulty.json。

⚙️ 配置文件

  • 配置文件位于 config/further_difficulty.json,采用 JSON 格式。默认内容如下:
{
  "mode": "strict",
  "stages": [
    {
      "id": "nether_entry",
      "trigger": {
        "type": "dimension",
        "target": "minecraft:the_nether"
      },
      "triggerMessage": "地核某处传来一阵悸动...",
      "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": "似乎打破了某种未知的禁忌...",
      "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开始)
  • 阶段(Stage)字段
字段 类型 描述
id string 唯一标识符,用于进度存储和指令操作
trigger object 触发条件,包含 type 和 target
triggerMessage string 阶段首次触发时全局广播的消息
blacklist array 该阶段未解锁时禁止生成的生物 ID 列表(例如 "minecraft:skeleton")
modifiers object 属性增强配置,见下表
  • 修饰符(Modifiers)字段
字段 类型 描述
healthMultiplier double 最大生命值倍数
healthAddition double 最大生命值固定增加值
armorMultiplier double 护甲值倍数
armorAddition double 护甲值固定增加值
toughnessMultiplier double 护甲韧性倍数
toughnessAddition double 护甲韧性固定增加值
attackMultiplier double 攻击力倍数
attackAddition double 攻击力固定增加值

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

? 阶段扩展与限制

1.阶段数量限制

由于模组内部使用 int 类型的位掩码来存储已完成的阶段索引,理论上最多支持 31 个阶段(位 0 到 30)。

这是因为 int 在 Java 中为 32 位有符号整数,最高位(第 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不会自动激活(需要玩家完成阶段3的触发条件),但阶段0~2的效果仍然存在。

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

{
  "mode": "progressive",
  "stages": [
    // ... 原有阶段 ...
    {
      "id": "ender_dragon_kill",
      "trigger": { 
        "type": "kill", 
        "target": "minecraft:ender_dragon" 
      },
      "triggerMessage": "巨龙陨落,世界震颤...",
      "blacklist": [],
      "modifiers": {
        "healthMultiplier": 3.0,
        "healthAddition": 10,
        "armorMultiplier": 1.5,
        "armorAddition": 2,
        "toughnessMultiplier": 1.5,
        "toughnessAddition": 2,
        "attackMultiplier": 2.0,
        "attackAddition": 3
      }
    }
  ]
}

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

指令 描述
/furtherdifficulty reload 重新加载 config/further_difficulty.json 配置文件
/furtherdifficulty progress set <stageId> 强制完成指定 ID 的阶段(如果尚未完成)
/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) 系统存储于主世界(overworld)的 level.dat 中,因此:

  • 进度数据是全局的,影响所有维度。

  • 数据随世界保存,重启服务器不会丢失。

  • 多人游戏中,所有玩家共享同一进度(由第一个触发者决定)。

  • 存储内容:

completed_conditions:已完成阶段的 ID 列表(List<String>)

first_condition:最先完成的阶段 ID(String,用于 first_only 模式)

?️卸载说明

  • 直接卸载是安全的,存档不会因此损坏或无法打开。

  • 注意:卸载模组后,所有因模组而获得增强的已存在生物将保留其强化后的属性(如高血量)。只有新生成的生物才会恢复原版强度。

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

? 开发者信息

你可以在整合包中使用,请保留原作者署名(非强制,但很感谢)

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源