收藏大师

收藏大师

将收集的资源通过可配置的物品收集和里程碑转化为奖励。

矿石与资源

CollectionMaster

CollectionMaster 为 Minecraft 添加可收集物品的收藏系统。通过找到目标物品来发现一项收藏,向其中投入物品以完成逐步增大的里程碑,并在推进过程中领取物品奖励。

✅ 功能

  • 为常见原版物品提供开箱即用的收藏。(仍在开发中,后续会添加更多收藏)
  • 二十三个默认里程碑,从 10 个物品到 500,000 个物品,并带有可配置的共享回退奖励。
  • 内置收藏各自拥有主题奖励表。自定义收藏可以继承全局里程碑和奖励,也可以自行定义。
  • 进度和待领取奖励按玩家存储在世界存档中,并由服务器校验。

📖 打开图鉴

默认按 K 打开图鉴。该按键可在 Minecraft 的“控制”设置中更改。你也可以使用以下任一命令:

  • /collectionmaster
  • /cmaster

在多人游戏中,请在服务器和每个连接的客户端上都安装该模组。

图鉴按类别对已发现的收藏进行分组,显示每项收藏的目标物品、当前进度、里程碑要求和奖励。未发现的收藏不会单独列出;图鉴可以显示剩余收藏的汇总数量。将鼠标悬停在里程碑区域上并滚动滚轮可浏览里程碑。

选择 1、Stack 或 All 可从你的物品栏中投入物品。单次投入量以剩余里程碑所需数量为上限。已完成的里程碑奖励会显示在其卡片上,并可在那里领取。若物品栏空间不足,奖励将保持待领取状态。

⚙️ 收藏定义

收藏定义是位于以下位置的 JSON 文件:

config/collectionmaster/collections/

该目录会被递归扫描,因此你可以用子文件夹组织定义文件。首次启动时,模组会安装十个示例收藏文件。已存在的文件会被保留。

一个最小的自定义收藏可以省略两个里程碑字段,并继承全局里程碑数量和奖励:

{
  "id": "collectionmaster:amethyst",
  "name": "Amethyst",
  "category": "Ores",
  "target_item_ids": ["minecraft:amethyst_shard"],
  "enabled": true
}

每个定义都需要唯一的收藏 id、一个 name、一个 category,以及 target_item_ids 中恰好一个目标物品。物品 ID 使用 Minecraft 的 namespace:path 格式。enabled 字段为可选项,默认为 true。

使用全局默认值

全局选项文件为 config/collectionmaster.json。它包含:

  • default_milestone_amounts:23 个正数且严格递增的物品要求。内置序列为 10, 20, 50, 100, 250, 500, 1000, 2500, 5000, 10000, 20000, 30000, 40000, 50000, 60000, 70000, 80000, 90000, 100000, 200000, 300000, 400000, 500000。
  • default_milestone_rewards:23 个奖励组,每个默认里程碑对应一组。每个奖励包含一个 item_id 和一个正数 count。一个组可以包含多个奖励。
  • show_locked_collections:控制图鉴是否显示未发现收藏的汇总数量;默认为 true。

全局奖励表由未提供自身奖励定义的收藏共享。编辑选项文件可更改继承默认值的新定义收藏的默认设置。

覆盖某项收藏的奖励

当某项收藏应保留全局里程碑数量但使用不同的奖励表时,使用 milestone_rewards。它会替换整个全局奖励表,并且必须按里程碑顺序恰好包含 23 个奖励组:

"milestone_rewards": [
  [{"item_id": "minecraft:amethyst_block", "count": 2}],
  [{"item_id": "minecraft:experience_bottle", "count": 4}]
]

该片段仅展示结构:完整的收藏定义必须提供全部 23 个组。每个组是一个列表,因此一个里程碑可以授予多种物品类型。

定义自定义里程碑

使用 milestones 直接定义收藏的里程碑编号、要求和奖励:

"milestones": [
  {
    "number": 1,
    "required_amount": 32,
    "rewards": [{"item_id": "minecraft:amethyst_block", "count": 2}]
  },
  {
    "number": 2,
    "required_amount": 128,
    "rewards": [
      {"item_id": "minecraft:amethyst_block", "count": 4},
      {"item_id": "minecraft:experience_bottle", "count": 8}
    ]
  }
]

里程碑编号必须从 1 开始且连续;要求必须为正数,并从一项里程碑到下一项递增。每个里程碑至少需要一个奖励。在收藏文件中使用 milestones 或 milestone_rewards 其中之一,不可同时使用两者。

Bisect Pedrijoe