Mining Reward

模组

· 作者 biduleking

Mining Rewards 是一款面向 Minecraft 1.21.1 的 NeoForge 模组,专注于进度推进,为玩家提供每日挖矿与耕作的结构化目标。

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

最新 1.0.2 · 1.21.1 · NeoForge

一键开服(送7天)

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/

祝你整合包制作愉快!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源