CAdvancements

CAdvancements

无需数据包的自定义进度!

Custom Advancements

此模组允许你使用标准的原版进度 JSON 文件为 Minecraft 添加自定义进度。如果你知道如何为数据包制作进度,那么你已经知道如何使用此模组了——只需将你的 JSON 文件放入 config 文件夹,它们就会作为常规进度加载。

此模组主要面向模组和整合包作者,他们希望在不创建完整数据包或将进度包含在模组 jar 内的情况下发布进度。

Example with BetterAdvancements

特性

通过 config 文件夹添加自定义进度

将你的进度 JSON 文件放入:

./config/cadvancements/advancements/<namespace>/<your_files>.json
  • <namespace> — 进度 ID 中使用的命名空间(例如 mymod、custom、tutorial)。
  • <your_files>.json — 一个与原版结构完全相同的进度文件(display、criteria、requirements、rewards 等)。

软重载

你可以使用标准的 /reload 命令更新进度。

完全兼容原版的 JSON 格式

在原版进度中有效的每个字段在这里都有效。你可以使用原版触发器(minecraft:inventory_changed、minecraft:player_killed_entity 等)、原版奖励(战利品、经验、函数)以及原版显示选项(图标、标题、描述、边框、背景、show_toast、announce_to_chat、hidden)。

JSON 进度示例

{
  "display": {
    "icon": { "item": "minecraft:stone" },
    "title": "Stone Age",
    "description": "Mine your first stone",
    "frame": "task",
    "show_toast": true,
    "announce_to_chat": true
  },
  "criteria": {
    "get_stone": {
      "trigger": "minecraft:inventory_changed",
      "conditions": {
        "items": [ { "items": ["minecraft:stone"] } ]
      }
    }
  },
  "requirements": [ ["get_stone"] ]
}

BetterAdvancements 兼容性

如果安装了 BetterAdvancements,你可以使用可选的 better_display 块来扩展你的进度,以控制进度在进度树中的绘制方式。

"better_display": {
  "pos_x": 0,
  "pos_y": 0,
  "completed_icon_color": "#FFFFFF",
  "uncompleted_icon_color": "#FFFFFF",
  "completed_title_color": "#FFFFFF",
  "uncompleted_title_color": "#FFFFFF",
  "draw_direct_lines": false,
  "hide_lines": false
}
字段 类型 描述
pos_x / pos_y int 进度图标相对于其默认位置的偏移量。
completed_icon_color hex string 已完成进度的图标颜色。
uncompleted_icon_color hex string 未完成进度的图标颜色。
completed_title_color hex string 已完成进度的标题颜色。
uncompleted_title_color hex string 未完成进度的标题颜色。
draw_direct_lines boolean 将连接线绘制为直线而非曲线。(存在 Bug)
hide_lines boolean 完全隐藏连接线。

如果未安装 BetterAdvancements,better_display 块将被忽略。

客户端与服务端友好

从 config 文件夹加载的进度行为与常规进度一致——它们会同步到客户端、与原版进度 GUI 配合工作、发放奖励,并可用于 /advancement grant 和 /advancement revoke 命令。