Skip to content

Releases: Moeary/Chocolate

Release list

Chocolate 0.1.0：不兼容任何 Mod 加载器的 Mod！

Chocolate 0.1.0：不兼容任何 Mod 加载器的 Mod！ Latest
Latest

Choose a tag to compare

View all tags
@Moeary Moeary released this 10 Oct 02:01
v0.1.0
a824079

Chocolate 0.1.0 Release

发布日期：2026-10-10

Chocolate 0.1.0 是一个只把 Minecraft 1.21.1 原版猫变成人形猫娘的独立 Java agent。
这次发布的兼容性口号很简单：0% Fabric / Forge / NeoForge 兼容，0 个对外 Mod API，
1 只猫娘。 它不是 Mod，不由任何 Mod Loader 加载，也不启动 Fabric、Forge 或 NeoForge。

下载

前往 GitHub Release 的 Assets，
下载以下两个 JAR 与校验文件：

文件 用途 SHA-256
chocolate-agent-0.1.0.jar Minecraft 启动时由 -javaagent 加载的 ASM 变换 agent AE602DE25CADFE2ECDE33CEF9D9C31A89E0DC345554C5D778BEB40F6F38CA4C3
chocolate-installer-0.1.0.jar 创建继承官方 vanilla 1.21.1 的 Chocolate 启动 profile 10F28941FF5662DD33965AD65F08D2841E3FAE0115DB2CFEA5C48BB0210F3A42
SHA256SUMS.txt 两个 JAR 的校验和清单 —

两个 JAR 都是 Release 资产；请不要把它们放入 mods 目录，也不要交给 Fabric、Forge
或 NeoForge loader。

安装

  1. 准备官方 vanilla Minecraft Java Edition 1.21.1 与 Java 21。
  2. 用 installer 先执行 dry-run，确认继承版本为 1.21.1。
  3. 追加 --apply 创建 chocolate-1.21.1 profile，再在启动器中选择它。

先取得仓库，并在项目根目录准备 Pixi 环境；然后把 Release Assets 中的两个 JAR 都放到
该项目根目录，再运行下面的命令。pixi run 依赖根目录的 pixi.toml；把 JAR 单独放在
没有 pixi.toml 的下载目录中直接执行会失败。

Windows PowerShell 7 示例：

git clone https://github.com/Moeary/Chocolate.git
Set-Location .\Chocolate
pixi install --locked
# 将 chocolate-agent-0.1.0.jar 与 chocolate-installer-0.1.0.jar 复制到当前目录

pixi run java -jar ".\chocolate-installer-0.1.0.jar" `
  --game-dir "$env:APPDATA\.minecraft" `
  --agent (Resolve-Path '.\chocolate-agent-0.1.0.jar').Path

pixi run java -jar ".\chocolate-installer-0.1.0.jar" `
  --game-dir "$env:APPDATA\.minecraft" `
  --agent (Resolve-Path '.\chocolate-agent-0.1.0.jar').Path `
  --apply

installer 不下载 Minecraft，不读取或改写世界、选项和 mods 目录。生成的 profile 会
记录 agent 的绝对路径，因此启动后不要移动或删除 agent JAR。完整说明见
README.md。

验证状态

  • pixi run test、pixi run check 与构建检查已通过。
  • 真实官方 1.21.1 字节码变换、模型链接、纹理解码注册、安装器隔离和 PCL JSON 回归已通过。
  • PCL wrapper 对照中旧代理以 exit 78 拒绝，新代理以 exit 0 完成，并到达 LWJGL、OpenAL、
    声音、GUI、资源 atlas 与 shader 初始化。
  • 用户提供的 Minecraft 1.21.1 单人世界截图确认进入世界后可见一只人形猫娘；截图原样保存在
    docs/assets/chocolate-catgirl-in-game.jpg，
    SHA-256 为 BC65E1AF9C3D55537929474054C8C3EF3CFE73D927F3C2A0B3CE7198627525DC。

截图只确认了这次画面的外观。动画、全部猫 variant、不同启动器参数与长期运行稳定性仍未
验收；概念插画和离线模型预览也不替代实机证据。详细记录见
docs/verification.md。

边界

本版本只支持 Minecraft Java Edition 1.21.1 与 Java 21。Chocolate 不提供第三方 Mod API，
不扫描 mods 目录，不承诺 Fabric、Forge、NeoForge 或其他 Mod Loader 的共存和兼容。

Assets 5
Loading