Mining Rewards 是一款面向 Minecraft 1.21.1 的 NeoForge 模组,专注于通过每日采矿和耕作提供结构化的目标。
它添加了:
- 针对挖掘方块和收获作物的分级奖励。
- 附带额外经验值奖励的日常特殊挑战。
- 可解锁临时倍率的日常增强挑战。
- 简洁的游戏内用户界面,用于追踪进度、已领取的等级和当前目标。
该模组完全可配置,服务器管理员可以调整等级、奖励、重置行为和挑战难度,以适配其游戏风格。
Mining Rewards 模组 - 配置指南
概述
本指南解释了如何为整合包配置 Mining Rewards 模组。所有奖励、等级和模组行为均可通过 JSON 配置文件进行控制。
配置文件
位置: config/miningrewards-config.json
配置文件包含三个主要部分:
- settings(设置):通用模组参数
- mining(采矿):采矿奖励配置
- farming(耕作):耕作奖励配置
设置部分(通用参数)
结构
"settings": {
"resetType": "REAL_TIME",
"realTimeResetHour": 6
}
参数
resetType (string)
定义奖励的每日重置类型。
可选值:
"REAL_TIME"→ 在固定的现实时间每日重置(默认)"MINECRAFT_DAY"→ 基于 Minecraft 的一天进行重置(24000 tick ≈ 现实时间 20 分钟)
示例:
在早上 6 点(现实时间)重置:
"settings": {
"resetType": "REAL_TIME",
"realTimeResetHour": 6
}
在午夜(现实时间)重置:
"settings": {
"resetType": "REAL_TIME",
"realTimeResetHour": 0
}
按 Minecraft 的一天重置:
"settings": {
"resetType": "MINECRAFT_DAY",
"realTimeResetHour": 6
}
注意: 在
MINECRAFT_DAY模式下,realTimeResetHour参数无效,但为了保持 JSON 语法完整性,必须保留该字段。
realTimeResetHour (int)
REAL_TIME 模式下的重置小时数。
取值范围: 0 到 23(24 小时制)
0= 午夜6= 早上 6 点(默认)12= 中午18= 下午 6 点
采矿部分(采矿奖励)
结构
"mining": {
"tiers": [100, 200, 300, ...],
"rewards": {
"100": { ... },
"200": { ... },
...
}
}
子部分 tiers(奖励等级)
定义挖掘方块阈值以解锁奖励的整数数组。
示例:
"tiers": [100, 200, 300, 500, 1000, 2000, 5000]
- 挖掘 100 个方块 → 解锁第一个奖励
- 挖掘 200 个方块 → 解锁第二个奖励
- 挖掘 1000 个方块 → 解锁第五个奖励
- 依此类推
子部分 rewards(奖励详情)
包含每个等级奖励详情的对象。
单个奖励的结构:
"100": {
"xp": 33,
"pools": [
{
"options": [
{
"item": "minecraft:coal",
"minCount": 8,
"maxCount": 18
},
{
"item": "minecraft:copper_ingot",
"minCount": 6,
"maxCount": 14
}
]
},
{
"options": [
{
"item": "minecraft:redstone",
"minCount": 8,
"maxCount": 22
}
]
}
]
}
奖励字段
| 字段 | 类型 | 描述 |
|---|---|---|
xp |
int | 解锁等级时授予的经验值点数 |
pools |
array | 物品组(详见下文) |
物品池(Item Pools)
一个 pool(池)是一组选项,模组从中随机选择一个。
每个奖励可以有多个池。对于每个池,随机选择一个选项。
带有 2 个池的示例:
"pools": [
{
"options": [
{"item": "minecraft:coal", "minCount": 8, "maxCount": 18},
{"item": "minecraft:copper_ingot", "minCount": 6, "maxCount": 14}
]
},
{
"options": [
{"item": "minecraft:redstone", "minCount": 8, "maxCount": 22},
{"item": "minecraft:lapis_lazuli", "minCount": 7, "maxCount": 18}
]
}
]
可能的结果:
- 池 1 → 随机选择:煤炭 (8-18) 或 铜锭 (6-14)
- 池 2 → 随机选择:红石 (8-22) 或 青金石 (7-18)
玩家将获得来自池 1 的 1 件物品 + 来自池 2 的 1 件物品。
物品选项
| 字段 | 类型 | 描述 |
|---|---|---|
item |
string | 物品的 Minecraft 注册表 ID |
minCount |
int | 最小数量 |
maxCount |
int | 最大数量 |
实际数量将在 minCount 和 maxCount 之间随机选取(包含两端)。
耕作部分(耕作奖励)
farming 部分的结构与 mining 完全相同。
"farming": {
"tiers": [25, 50, 100, 200, 500],
"rewards": {
"25": {
"xp": 25,
"pools": [
{
"options": [
{"item": "minecraft:bone_meal", "minCount": 5, "maxCount": 15}
]
}
]
},
...
}
}
常见 Minecraft 物品 ID
| 物品 | ID |
|---|---|
| 煤炭 | minecraft:coal |
| 铜矿石 | minecraft:copper_ore |
| 铜锭 | minecraft:copper_ingot |
| 铁锭 | minecraft:iron_ingot |
| 金锭 | minecraft:gold_ingot |
| 钻石 | minecraft:diamond |
| 绿宝石 | minecraft:emerald |
| 红石 | minecraft:redstone |
| 青金石 | minecraft:lapis_lazuli |
| 黑曜石 | minecraft:obsidian |
| 末影珍珠 | minecraft:ender_pearl |
| 烈焰棒 | minecraft:blaze_rod |
| 下界之星 | minecraft:nether_star |
| 不死图腾 | minecraft:totem_of_undying |
| 经验瓶 | minecraft:experience_bottle |
| 骨粉 | minecraft:bone_meal |
| 紫水晶碎片 | minecraft:amethyst_shard |
| 远古残骸 | minecraft:ancient_debris |
| 下界合金碎片 | minecraft:netherite_scrap |
使用场景 / 示例
配置 1:硬核模式(稀有奖励)
{
"settings": {
"resetType": "REAL_TIME",
"realTimeResetHour": 6
},
"mining": {
"tiers": [500, 1000, 2000, 5000],
"rewards": {
"500": {
"xp": 100,
"pools": [
{"options": [{"item": "minecraft:coal", "minCount": 10, "maxCount": 20}]}
]
},
"1000": {
"xp": 200,
"pools": [
{"options": [{"item": "minecraft:iron_ingot", "minCount": 5, "maxCount": 10}]}
]
},
"2000": {
"xp": 500,
"pools": [
{"options": [{"item": "minecraft:diamond", "minCount": 1, "maxCount": 3}]}
]
},
"5000": {
"xp": 1000,
"pools": [
{"options": [{"item": "minecraft:nether_star", "minCount": 1, "maxCount": 1}]}
]
}
}
}
}
配置 2:休闲模式(慷慨奖励)
{
"settings": {
"resetType": "MINECRAFT_DAY",
"realTimeResetHour": 0
},
"mining": {
"tiers": [50, 100, 200, 400, 800],
"rewards": {
"50": {
"xp": 25,
"pools": [
{"options": [
{"item": "minecraft:coal", "minCount": 15, "maxCount": 40},
{"item": "minecraft:copper_ingot", "minCount": 10, "maxCount": 30}
]}
]
},
"100": {
"xp": 75,
"pools": [
{"options": [{"item": "minecraft:iron_ingot", "minCount": 15, "maxCount": 50}]},
{"options": [{"item": "minecraft:gold_ingot", "minCount": 10, "maxCount": 30}]}
]
},
"200": {
"xp": 200,
"pools": [
{"options": [{"item": "minecraft:diamond", "minCount": 5, "maxCount": 15}]},
{"options": [{"item": "minecraft:emerald", "minCount": 3, "maxCount": 10}]}
]
}
}
}
}
配置 3:平衡且有进度感
{
"settings": {
"resetType": "REAL_TIME",
"realTimeResetHour": 8
},
"mining": {
"tiers": [100, 250, 500, 1000, 2000, 4000],
"rewards": {
"100": {
"xp": 40,
"pools": [
{"options": [
{"item": "minecraft:coal", "minCount": 8, "maxCount": 18},
{"item": "minecraft:copper_ingot", "minCount": 6, "maxCount": 14}
]}
]
},
"250": {
"xp": 80,
"pools": [
{"options": [{"item": "minecraft:iron_ingot", "minCount": 10, "maxCount": 25}]},
{"options": [{"item": "minecraft:redstone", "minCount": 10, "maxCount": 30}]}
]
},
"500": {
"xp": 150,
"pools": [
{"options": [{"item": "minecraft:gold_ingot", "minCount": 8, "maxCount": 20}]},
{"options": [{"item": "minecraft:lapis_lazuli", "minCount": 12, "maxCount": 28}]}
]
}
}
}
}
整合包创作者提示
1. 平衡奖励
- 过于慷慨 → 破坏服务器经济
- 过于稀有 → 导致玩家沮丧
- 在发布前进行游戏内测试
2. 进度递增
随着层级提高而增加:
- 获得的经验值
- 物品数量
- 物品价值(煤炭 → 钻石 → 下界之星)
3. 重置类型
- REAL_TIME:最适合多人服务器(同步每日重置)
- MINECRAFT_DAY:最适合单人体验(基于玩家进度重置)
4. 奖池多样性
使用多个奖池以提供多样性而不破坏平衡:
"pools": [
{"options": [/* 常见选项 1 */]},
{"options": [/* 常见选项 2 */]},
{"options": [/* 稀有选项 */]}
]
5. 文档说明
在你的整合包中添加说明,解释:
- 模组用途
- 奖励机制如何运作
- 如需修改配置的方法
故障排除
“配置未加载”
• 确认文件位于 config/miningrewards-config.json
• 检查 JSON 语法(无缺失/多余的逗号)
• 重启客户端
奖励没有变化
• 是否保存了 JSON 文件? • 是否重启了客户端? • 是否达到了层级阈值?
JSON 错误
• 使用 JSON 验证器:
• 检查引号(必须为 " 而非 ")
配置清单
- JSON 语法有效
- 层级按升序排列
- 每个层级都定义了奖励
- 物品 ID 有效
- minCount ≤ maxCount
- XP 与难度一致
- resetType 正确(REAL_TIME 或 MINECRAFT_DAY)
- 文件已同步到
/run/config/
祝你整合包制作愉快!
你是这个资源的作者?登录后可认领此资源。
相似资源
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
查看物品与配方
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
AE2:一款流行的自动化与存储模组
那是什么?一个 Waila/Hwyla 的分支。
评论 0
登录后参与评分
还没有评论,来抢沙发吧