Skip to content

Minecraft Codex Companion v0.1.0

Choose a tag to compare

View all tags
@Hakurei-git Hakurei-git released this 11 Aug 15:32
· 0 commits to f10c0a357fba51c849624a5f15ebc344a814afc4 since this release
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 世界存档。
Assets 4
Loading