CTNHChangelog

一个用于显示更新日志信息并检查更新的 Minecraft 模组。

配置说明

英文

配置文件位于 config/ctnhchangelog-client.toml。

字段	说明
`changelogUrl`	默认远程 JSON 更新日志 URL。供非英文/非俄文语言使用，也作为最后的兜底。
`changelogUrlEn`	英文远程 JSON 更新日志 URL。英文客户端优先使用此项。其他语言在对应 URL 为空时回退到此项。
`changelogUrlRu`	俄文远程 JSON 更新日志 URL。俄文客户端优先使用此项；若为空，则回退到 `changelogUrlEn`。
`enableChangelogTab`	若为 `true`，则在“创建新的世界”菜单中显示更新日志标签页。
`ModpackVersion`	当前整合包版本。用于与远程版本比较以检查更新。
`enableVersionCheck`	若为 `true`，则将 `ModpackVersion` 与远程文件中解析出的最高版本进行比较。
`buttonLocation`	按钮显示位置。可选值：`BOTH`（在标题界面和选择世界界面都显示）、`TITLE_SCREEN`（仅标题界面）、`SELECT_WORLD`（仅选择世界界面）。
`cacheTtlMinutes`	远程更新日志缓存有效期（分钟）。缓存未过期时，模组使用本地缓存而不联系远程服务器。设为 `0` 则每次都检查远程文件。

语言选择跟随游戏内语言代码。en_* 使用 changelogUrlEn，ru_* 使用 changelogUrlRu，其他语言使用 changelogUrl。对应 URL 为空时回退到 changelogUrlEn，再回退到 changelogUrl。

中文

配置文件位于 config/ctnhchangelog-client.toml。

字段	说明
`changelogUrl`	默认远程 JSON 更新日志文件 URL。非英文/俄文语言使用此项，也作为最后兜底。
`changelogUrlEn`	英文远程 JSON 更新日志文件 URL。英文客户端优先使用此项，其他语言对应 URL 为空时回退到此项。
`changelogUrlRu`	俄语远程 JSON 更新日志文件 URL。俄语客户端优先使用此项；为空时回退到 `changelogUrlEn`。
`enableChangelogTab`	设为 `true` 时，在“创建新的世界”菜单中显示更新日志标签页。
`ModpackVersion`	当前整合包版本号。用于与远程最新版本对比，检测更新。
`enableVersionCheck`	设为 `true` 时，会自动与远程文件中解析出的最高版本比较。
`buttonLocation`	按钮显示位置。可选值：`BOTH`（标题界面和选择世界界面都显示）、`TITLE_SCREEN`（仅标题界面）、`SELECT_WORLD`（仅选择世界界面）。
`cacheTtlMinutes`	远程更新日志缓存有效期（分钟）。缓存未过期时直接使用本地缓存，不访问远端；设为 `0` 时每次都检查远端文件。

语言选择跟随游戏内语言代码：en_* 使用 changelogUrlEn，ru_* 使用 changelogUrlRu，其他语言使用 changelogUrl。对应语言 URL 为空时，会回退到 changelogUrlEn，再回退到 changelogUrl。

更新日志 JSON 格式

v2 标准格式

游戏内编辑器导出的是 CTNHChangelog v2。新文件应使用以下结构；format、formatVersion、meta、types 和 accent 是标准字段名。

{
  "format": "ctnhchangelog",
  "formatVersion": 2,
  "meta": {
    "footer": "感谢游玩！",
    "tagColors": {
      "important": "#FFFF5555",
      "transparent": "#8044AAFF"
    }
  },
  "entries": [
    {
      "version": "2.0.0",
      "date": "2026-07-24",
      "title": "发布标题",
      "types": ["major"],
      "tags": ["important"],
      "accent": "#44AAFF",
      "changes": [
        "顶层变更",
        { "title": "详情", "children": ["嵌套变更"] }
      ]
    }
  ]
}

v2 字段	说明
`format`	固定为 `ctnhchangelog`。
`formatVersion`	固定为 `2`。
`meta.footer`	可选的底部文本。
`meta.tagColors`	可选的标签颜色映射。
`entries`	有序的更新日志条目。
`entries[].types`	类型数组，例如 `major`、`minor`、`patch`、`hotfix` 或 `danger`。显式空数组会保留，缺失字段才会为兼容旧数据默认成 `patch`。
`entries[].accent`	条目强调色。
`entries[].changes`	字符串和/或递归的 `{ "title", "children" }` 分组。

颜色支持不透明的 #RRGGBB，以及需要保留透明度时的 #AARRGGBB；输入也兼容 0xRRGGBB 和 0xAARRGGBB。

旧格式兼容

旧版未带版本号的文档（将 footer 和 tagColors 放在根层级，并使用 type/color 字段）仅作为输入被接受。重新导出时会写入规范的 v2 JSON。随附的旧格式示例仍可读取，用于兼容性测试。

游戏内编辑器

模组内置了更新日志编辑器，可从更新日志界面打开。

打开编辑器：

点击更新日志概览界面右上角的”编辑”按钮

编辑器功能：

标签页	说明
条目	添加、删除、排序更新日志条目；编辑版本号、日期、标题、类型、标签、颜色和变更内容
标签颜色	定义自定义标签颜色，供条目使用
脚注	编辑显示在底部的渐变色脚注文本

编辑变更内容：

双击已有变更条目即可进入编辑模式
按 Enter 确认修改
按 Escape 取消修改并恢复原文

导入/导出：

使用”导入”按钮从游戏目录加载 JSON 文件
使用”导出”按钮将当前更新日志保存为 JSON 文件到游戏目录

CTNH’s Changelog

介绍

CTNHChangelog

配置说明

英文

中文

更新日志 JSON 格式

v2 标准格式

旧格式兼容

游戏内编辑器

常见问题

CTNH’s Changelog 支持哪些 Minecraft 版本？

CTNH’s Changelog 怎么安装？

评论

mmyddd 的其他作品

GregTech-Construct

BetterGregTechPonder