CTNHChangelog

A Minecraft mod that displays changelog information and checks for updates.

Configuration / 配置说明

English

The configuration file is located at config/ctnhchangelog-client.toml.

Language selection follows the in-game language code. en_* uses changelogUrlEn, ru_* uses changelogUrlRu, and other languages use changelogUrl. Empty matching URLs fall back to changelogUrlEn, then changelogUrl.

中文

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

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

Changelog JSON Format / 更新日志 JSON 格式

Canonical v2 format / v2 标准格式

The in-game editor exports CTNHChangelog v2. New files should use this shape; format, formatVersion, meta, types, and accent are the canonical field names.

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

{
  "format": "ctnhchangelog",
  "formatVersion": 2,
  "meta": {
    "footer": "Thanks for playing!",
    "tagColors": {
      "important": "#FFFF5555",
      "transparent": "#8044AAFF"
    }
  },
  "entries": [
    {
      "version": "2.0.0",
      "date": "2026-07-24",
      "title": "Release title",
      "types": ["major"],
      "tags": ["important"],
      "accent": "#44AAFF",
      "changes": [
        "A top-level change",
        { "title": "Details", "children": ["Nested change"] }
      ]
    }
  ]
}

Colors accept #RRGGBB for opaque values and #AARRGGBB when alpha must be retained. 0xRRGGBB and 0xAARRGGBB are also accepted on input.

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

Legacy compatibility / 旧格式兼容

Older unversioned documents that place footer and tagColors at the root and use type/color fields are accepted as input only. Re-exporting writes canonical v2 JSON. The bundled legacy example remains readable for compatibility testing.

In-Game Editor / 游戏内编辑器

English

The mod includes a built-in changelog editor accessible from the changelog screen.

Opening the Editor:

• Click the "Edit" button in the top-right corner of the changelog overview screen

Editor Features:

Editing Changes:

• Double-click an existing change entry to edit it
• Press Enter to confirm the edit
• Press Escape to cancel and revert to the original text

Import/Export:

• Use the "Import" button to load a JSON file from the game directory
• Use the "Export" button to save the current changelog as JSON to the game directory

中文

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

打开编辑器：

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

编辑器功能：

编辑变更内容：

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

导入/导出：

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