
进一步难度配置
可配置阶段的渐进式难度模组。由事件触发,每个阶段提升生物属性(生命值、护甲等),包含黑名单、四种进度模式、热重载和阶段管理命令。
查看大图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 许可证 – 可自由使用、修改和再分发。
📥 安装
- 确保已安装 NeoForge 1.21.1 或兼容版本。
- 将下载的
further_difficulty-X.X.X.jar放入mods文件夹。 - 首次运行时,默认配置文件
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重置进度。但这不会改变已生成生物的属性。
📝 开发者信息
- 作者:盐灯水母
- 版本:1.0.0
- 许可证:MIT
- GitHub:(暂无)
- 邮箱:Jellyfishlamp0v0@outlook.com
你可以自由地将此模组包含在你的整合包中。署名会受到赞赏,但并非必需。
正在加载版本记录…




正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。