Skip to content

Releases: Hakurei-git/minecraft-codex-companion

Release list

Minecraft Codex Companion v0.1.1

Minecraft Codex Companion v0.1.1 Latest
Latest

Choose a tag to compare

View all tags
@Hakurei-git Hakurei-git released this 11 Aug 16:49
v0.1.1
6abb54b

Minecraft Codex Companion v0.1.1

English

What changed

  • Added a new original application icon featuring an unnamed, quiet/mukuchi-style white-haired, red-eyed catgirl AI companion.
  • Embedded a multi-resolution Windows icon in the Setup EXE, installed launcher, native configuration client, and path picker.
  • Added the icon artwork to the repository landing pages and kept NPC names and personas fully user-configurable.
  • Aligned desktop, MCP, workspace, portable runtime, and AgentKit version metadata with v0.1.1.
  • Added regression checks that require the branded icon and bind it into deterministic release builds.

Downloads

Asset Choose this when
MinecraftCodexCompanion-Setup.exe You want the complete Windows installer with the local control service, native configuration app, Forge 1.20.1 bridge, and bundled runtime.
MinecraftCodexCompanion-AgentKit-v0.1.1.zip You already installed the EXE and want Skill + MCP instructions for Codex, Claude, Antigravity, or another MCP-capable AI.

Smart AI is optional. Local recognized action chains can run without Smart AI; enabling Smart AI improves complex-language planning but consumes additional model tokens.

The optional Book of Dragons and Saints Dragons mods are supported by adapters but are not redistributed inside the EXE. Install compatible versions separately when using dragon features.

Verification

  • Full automated test suite: passed.
  • Deterministic offline installer tests: passed.
  • Embedded icons extracted identically from Setup, launcher, and native client.
  • Installer integrity: verified.
  • Local-only antivirus gate: clean.
  • Authenticode status: NotSigned.
  • No API keys, accounts, private Base URLs, machine-specific paths, conversations, screenshots, logs, or Minecraft worlds are included.
SHA-256 checksums 
a5445eeeebb8d56d8e78e079752b141a239048cfb033b9b9c2adb382d9c077a8  MinecraftCodexCompanion-Setup.exe
023034467ac341782b29f2ce88ca6e7c8fab237c1e36a43115742224bd6b9a69  MinecraftCodexCompanion-AgentKit-v0.1.1.zip

简体中文

本次更新

  • 新增原创应用图标：未绑定名字、安静无口系性格的白发红瞳猫娘 AI 同伴。
  • 将多尺寸 Windows 图标写入安装器、安装后的主启动程序、原生配置客户端和路径选择器。
  • 在中英文项目首页展示新图标，NPC 名字与人格仍完全由用户自行配置，没有把个人 AI 名称写死。
  • 将桌面程序、MCP、工作区、便携运行时和 AgentKit 的版本信息统一升级为 v0.1.1。
  • 新增图标回归测试，并把图标哈希纳入确定性发布构建。

下载选择

文件 适用情况
MinecraftCodexCompanion-Setup.exe 普通 Windows 用户使用的完整安装程序，包含本地控制服务、原生配置界面、Forge 1.20.1 桥接模组和便携运行时。
MinecraftCodexCompanion-AgentKit-v0.1.1.zip 已经安装 EXE，希望把 Skill + MCP 使用说明导入 Codex、Claude、反重力或其他支持 MCP 的 AI。

智能 AI 是可选功能。已识别的本地动作链不启用智能 AI 也可以运行；启用智能 AI 可以理解更复杂的自然语言规划，但会额外消耗模型 Token。

Book of Dragons 与 Saints Dragons 属于可选第三方龙模组：项目提供适配，但不会把这些模组打包进 EXE。需要龙功能时请另外安装兼容版本。

安全与验证

  • 完整自动化测试：通过。
  • 确定性离线安装器测试：通过。
  • 安装器、主启动程序和原生客户端提取出的图标一致。
  • 安装器完整性：已验证。
  • 本地离线杀毒门禁：干净。
  • Authenticode 状态：NotSigned。
  • 发布物不包含 API Key、账号、私人 Base URL、本机目录、对话、截图、日志或 Minecraft 世界存档。
SHA-256 校验值 
a5445eeeebb8d56d8e78e079752b141a239048cfb033b9b9c2adb382d9c077a8  MinecraftCodexCompanion-Setup.exe
023034467ac341782b29f2ce88ca6e7c8fab237c1e36a43115742224bd6b9a69  MinecraftCodexCompanion-AgentKit-v0.1.1.zip
Assets 4
Loading

Minecraft Codex Companion v0.1.0

Minecraft Codex Companion v0.1.0

Choose a tag to compare

View all tags
@Hakurei-git Hakurei-git released this 11 Aug 15:32
v0.1.0
f6452a7

Minecraft Codex Companion v0.1.0

English README · 简体中文说明

This release provides two distribution choices. Download only the one that matches your workflow.

Downloads

Download Use it when
Windows Setup EXE
194,739,712 bytes		 Guided Windows setup that discovers HMCL, Minecraft, and Antigravity locations and installs the local service plus Forge bridge.
AgentKit ZIP
18,565 bytes		 Skill and MCP integration files for users who already manage an AI agent.
SHA-256 checksums 
cfa9f36f72a9745a2be14a48b19c3a6179ccc9a22a0b95e731d48f7781da59ef  MinecraftCodexCompanion-Setup.exe
c0dfdbe591a292f0a993f48655bc43f57af2748b4167177eeac11fac502adb94  MinecraftCodexCompanion-AgentKit-v0.1.0.zip

Installer hotfix: the Windows EXE was rebuilt after correcting WinForms initialization order. If you downloaded the previous EXE with SHA-256 200197d83afd941b3aa0b4e63e56aa3b71f9b2a7ddc675c205e7d6b42c2a1280, download it again and verify the new checksum above.

GitHub additionally displays its automatically generated Source code (zip) and Source code (tar.gz) links. Those are generated from the public repository and are not extra local files uploaded from the build machine. The release API contains exactly the two user-uploaded assets listed above.

What is included

  • A local MCP/control service, dashboard, Forge 1.20.1 NPC bridge, HMCL instance installer/updater, deterministic T-chat action chains, optional Smart AI planning, free chat, configurable NPC names/personas/skins, persistent tasks, gathering, crafting, delivery, building, storage, farming, survival, combat assistance, deep mining, and dragon actions.
  • English documentation is the default README.md; the complete Chinese guide is README.zh-CN.md. Minecraft resources include en_us and zh_cn. The setup UI, Dashboard, and deterministic local phrases are currently Chinese-first; complex English actions should use Smart AI. This release does not claim a fully localized bilingual UI.
  • Supported optional adapters: Book of Dragons (bookofdragons-1.31-1.20.1) and Saints Dragons (saintsdragons-0.8.2+forge-1.20.1-alpha). Their third-party JARs are not redistributed; install them separately in the HMCL source instance.

Smart AI and token usage

Smart AI is optional. Recognized deterministic actions run locally without planning-model tokens when Smart AI is disabled. Enabling Smart AI adds a provider planning request for complex or unrecognized actions and therefore uses additional input and output tokens. The output-budget setting limits requested planning output, not the provider's entire bill. Explicit multi-agent planning generally costs more, and enabled free-chat replies consume tokens independently.

Compatibility and validation

  • Target: Windows x64, Minecraft Java Edition, Forge 1.20.1, and HMCL.
  • The HMCL + Forge 1.20.1 single-player flow and the listed dragon-mod versions were live-tested. The official launcher path and HMCL Microsoft-account login flow were not live acceptance-tested in this release.
  • Source tests, TypeScript checks, Forge build/tests, deterministic installer extraction/update tests, package integrity checks, payload whitelist checks, and local privacy scans passed.
  • The EXE was scanned locally with ClamAV 1.5.4: clean, 0 infected. It is a development build and is not Authenticode-signed; verify the SHA-256 before running it.
  • Neither uploaded asset contains an API key, private Base URL profile, bridge token, account data, local machine path/state, conversation, log, screenshot, or Minecraft world.

Minecraft Codex Companion v0.1.0（简体中文）

本版本提供两种发行方式，按自己的使用场景下载其中一种即可。

下载选择

下载文件 适用场景
Windows 安装程序 EXE
194,739,712 字节		 自动发现 HMCL、Minecraft 与反重力路径，并安装本地服务和 Forge 桥接模组。
AgentKit ZIP
18,565 字节		 给已经管理 AI 代理的用户导入 Skill 与 MCP 接入文件。
展开查看 SHA-256 校验值 
cfa9f36f72a9745a2be14a48b19c3a6179ccc9a22a0b95e731d48f7781da59ef  MinecraftCodexCompanion-Setup.exe
c0dfdbe591a292f0a993f48655bc43f57af2748b4167177eeac11fac502adb94  MinecraftCodexCompanion-AgentKit-v0.1.0.zip

**安装器热修复：**Windows EXE 已修正 WinForms 初始化顺序并重新构建。如果之前下载文件的 SHA-256 是 200197d83afd941b3aa0b4e63e56aa3b71f9b2a7ddc675c205e7d6b42c2a1280，请重新下载并核对上面的新校验值。

GitHub 还会自动显示 Source code (zip) 和 Source code (tar.gz) 两个源码下载项。它们由公开仓库自动生成，不是从本机额外上传的文件；Release API 中人工上传的资产严格只有上表中的两个。

包含内容

  • 本地 MCP/控制服务、Dashboard、Forge 1.20.1 NPC 桥、HMCL 实例安装/更新、通过 T 触发的稳定动作链、可选智能 AI、自由聊天、可配置 NPC 名字/人格/皮肤、任务持久化、采集、制作、交付、建造、仓储、种植、生存、协战、深层挖矿和骑龙相关动作。
  • 英文说明为默认 README.md，完整中文说明为 README.zh-CN.md。Minecraft 资源包含 en_us 和 zh_cn。当前安装界面、Dashboard 和本地固定动作短语仍以中文为主；复杂英文动作建议开启智能 AI，本版本不宣称完整双语 UI。
  • 已适配可选模组：Book of Dragons（bookofdragons-1.31-1.20.1）与 Saints Dragons（saintsdragons-0.8.2+forge-1.20.1-alpha）。这两个第三方模组 JAR 不会被重新分发，需要用户自行安装到 HMCL 源实例。

智能 AI 与 Token 消耗

智能 AI 可以开启或关闭。关闭后，已识别的本地稳定动作链不调用规划模型，也不消耗这一步的规划 token。开启后，复杂或本地无法识别的指令会额外请求一次所选服务商进行规划，因此会增加输入和输出 token。输出预算只限制请求的规划输出，不等于限制服务商的全部计费；显式多代理通常消耗更多，自由聊天回复也会独立消耗 token。

兼容性与验证

  • 目标环境：Windows x64、Minecraft Java Edition、Forge 1.20.1 与 HMCL。
  • HMCL + Forge 1.20.1 单人流程和上述两个龙模组版本已完成实机测试；官方启动器路径与 HMCL 微软账号登录流程尚未完成本版本的实机验收。
  • 源码测试、TypeScript 检查、Forge 构建/测试、安装器确定性解包与更新测试、包完整性、载荷白名单和本地隐私扫描均已通过。
  • EXE 已使用本地 ClamAV 1.5.4 扫描：clean，0 infected。当前是开发版，未进行 Authenticode 签名，运行前请核对 SHA-256。
  • 两个人工上传资产均不包含 API Key、私人 Base URL 配置、桥接令牌、账号数据、本机路径或状态、会话、日志、截图和 Minecraft 世界存档。
Loading