Changelog

R26#

R25#

支持 All the Mods 10 8.1#

其他修复#

致谢#

感谢 Sym601ETH 的反馈： #33、 #49、 #50、 #51。

R24#

致谢#

感谢 Sym601ETH 的反馈： #47、 #49。

感谢 siesta 的反馈。

R23#

支持 All the Mods 10 8.0#

8.0 与 7.3 的整合包自带文件逐字节比过：3436 个文件里 3337 个一字未改， 本包要改的 77 个文件里 72 个原样不动。

其他修复#

R22#

受影响的是 vr21 及更早。

致谢#

感谢 SWAUS 的反馈。

感谢 四十连装暴风雪鱼雷 的反馈。

感谢 Sym601ETH 的反馈： #33。

感谢 AkihaTatsu 的反馈： #44。

感谢 0xyk3r 的改动： #34、 #35、 #36、 #37、 #38、 #39、 #40、 #41、 #42、 #43。

R21#

受影响的是 vr20 及更早。

致谢#

感谢 Chr1sG029 的反馈： #26。

感谢 Sym601ETH 的反馈： #18、 #32。

感谢 0xyk3r 的改动： #22、 #23、 #24、 #25、 #27、 #28、 #30、 #31。

R20#

受影响的是 vr19。

致谢#

感谢 Sym601ETH 的反馈： #18。

感谢 0xyk3r 的改动： #15、 #16、 #17、 #20、 #21。

R19#

受影响的是 vr18 及更早的全部版本。 [u] 这一项从 vr16 起就在，但 macOS / Linux 上一次都没显示过；也因为如此，这两个系统的用户这次仍需手动下载，装上本版 之后 [u] 才能用。

有两处不是翻译能控制的，这次和以后都改不了：属性界面里「% 暴击伤害」的百分号 位置、FTB Ultimine 那两栏显示成一长串 0。

致谢#

感谢 Sym601ETH 的反馈： #10、 #11。

感谢 0xyk3r 的反馈： #12， 以及 #14 的改动。

R18#

这一版做两件事：把名字对齐（照任务书、图鉴里写的名字去 JEI 搜，现在都搜得到）， 以及补齐四本图鉴。

名字对齐#

跨模组的 XP／经验没有拉平：经验流体（可怖之物）、流体经验（刷怪塔实用设备）、 液态经验（动力附魔工业）是三个模组各自的官方物品名，拉平反而与 JEI 里搜到的对不上。 符文附魔台那条任务写的「经验流体」也是对的——那台机器的配方指名要可怖之物那个模组的流体， 英文原文写的「Fluid XP」反倒是误导。

物品说明里的「奥术」没动——那些译的是 Arcane（奥术底座、奥术核心、奥术图书馆），不是 Ars。

这些保留英文：AllTheMods Staff／Team、Iron's Spells、Ars Ocultas、Spirit Halloween、 Roy G. Bpm、Pie Romancer 等 20 来个，整个整合包里查不到中文名，编一个反而搜不到。

任务书的按键参考#

那一屏（F1 或任务书菜单打开）以前只有标题是中文，53 个键现在全补上： 通用控制、编辑模式、任务视图面板三段，放大／缩小／重置缩放、上一章节／下一章节、 居中视图、搜索、玩家偏好、复制／粘贴／撤销／重做／全选／取消选择、 编辑标题／副标题／描述／任务属性。

标题也改了：「关键参考」→「按键参考」。

任务书自己的界面另外补了 58 个键：书签提示、修改历史显示（始终显示／字号／最大行数／ 显示时长），以及编辑模式下的外观预设、图片点击动作与文字属性、撤销重做的操作名。 补完之后 FTB Quests 的英文条目一条不剩。

说不清楚的句子#

任务书不再断在奇怪的地方#

「你开始时有 3 个基本形态」会断成「你开始时有」／「3 个基本形态」， 「一个抄写台 来为你的法术书」会断成「……抄写台」／「来为你的法术书」—— 中文里留着从英文原文带过来的空格，而任务书正是在空格处换行的。

现在整本任务书里这类多余空格都去掉了，6104 处。中英混排该留的空格没动 （「AllTheMods 团队」「60 位阶」照旧）。

奥瑞科技导览书按物品真名重排#

反馈截图：辐镍晶锭那一页标题写着「Energite液体」——名字没译，而且它是锭不是液体； 正文里的链接文字 foundry、nickel、fluxite 也全是英文。

顺着查了整本书。链接的目标本来就是物品 ID，可以逐个查真名比对：

几个典型：铂锭那页目录写着「铂金矿石」（它是锭不是矿石）、深层铂矿石那页写着 「矿石与矿石巨石」、链锯写成「电锯」、磨粉机写成「粉碎机」、辐水晶写成「通量水晶」、 装配器写成「汇编执行器」。照这些名字去 JEI 搜，一个都搜不到。

现在标题、目录、正文链接三处一律取该页 id: 指向的那件物品的真名。

另外 12 本图鉴也按物品名重排了术语#

跟 MFFS 一样的毛病：图鉴自己起了一套名字，跟 JEI 里搜得到的对不上。 332 处，涉及 13 个模组：

对照表是机械生成的：图鉴每一页的 name 就是它对该物品的叫法， 拿英文原名去查该物品在游戏里的中文名，两边不等的就改。

MFFS 手册整本按物品名重排术语#

同一个模组的两本书用了两套叫法：神谕目录里是「扩展模块／干涉矩阵／力场投影仪」， 而 Patchouli 手册里是「尺寸模块／结界矩阵／力场投射器」——后者照着去 JEI 一个都搜不到。

以物品名为准，手册里 22 个物品、191 处改齐：

「力场子」没动——那是 Fortron 这种流体在游戏里的名字（fluid_type.mffs.fortron）， 不是错译。

MFFS 手册里的物品链接不再显示英文#

反馈截图：立方体模式那页正文里，Scale Module 这样的链接是英文。

原因是链接写成了空标签 [](@mffs:scale_module)——神谕目录遇到空标签会回落到 物品的英文名。全书 65 处都是这么写的，涉及 16 件物品：扩展模块、力场投影仪、 干涉矩阵、Fortron 能量储存器、识别卡、频率卡……现在一律按物品真名填上。

顺带核了这本书的标题与目录，与物品名本来就是齐的，没动。

神化附魔的漏译#

反馈截图：附魔台改版那几个方块的名字与说明还是英文。

同一系列的三个命名空间（神化、神化属性、神化附魔）一起查过， 除上面这些之外剩下的「英文」都是纯符号或格式串（%s、[%s - %s]、☑ %s、 附魔等级的罗马数字），照原样才对。

物品说明最后那行灰蓝色的 Apothic Enchanting 是模组名， 它来自模组自己的元数据而不是语言文件，资源包改不到。

补齐的图鉴#

受影响版本： 7.0 / 7.1 / 7.2 / 7.3 全部。装完不用做别的动作。

服主注意： 这一版任务书改动很大（物品名、语句、断行），都会进服务端包， 装了才和客户端对得上。说明文档里的加载器版本也修了：7.3 应为 NeoForge 21.1.247， r17 的包里印成了 21.1.241。图鉴、界面、JEI 那些仍然只在客户端。

致谢#

感谢 Sym601ETH 的反馈： #10。

R17#

支持 All the Mods 10 7.3#

7.3 新增的任务书文字里，玩家实际会看到英文的共 219 条，本版全部译完。 （上游自带中文的键不在此列；空描述、纯数字、纯图片标签这类不需要翻译的也不计入。）

物品名一律取自模组自己的中文表：位阶 / 量子化 / 阿卡那、五个世界层级 （居所·边境·攀升·高峰·顶点）、绯夜脂 / 瘴紫石 / 深银 / 流璃 / 星火 / 永冻石 / 热泉石 / 星钻、寻觅者 / 苦彗怕 / 高塔乌贼 / 黯影蜗牛……照任务书里写的名字去 JEI 搜，一定搜得到。

7.3 新增的 3 张任务书图片逐张看过：一张符文魔法阵、两个纯图标，没有可译文字。

7.3 的已知问题：两个配方做不出来（整合包自带，我们改不了）#

任务书里仍然会引导你去做这两样东西——那是上游任务书写好的内容，不是本包加的。 在整合包修好之前，这两条任务做不完，跳过即可，不影响其他进度。

这是 ATM10 7.3 自带的问题：Apotheosis 从 8.5.4 升到 8.6.1 时新加了这两个配方， 在本整合包环境里配方的宝石那一项解析为空，游戏加载时就被丢弃。7.2 及更早不受影响 （那些版本的 Apotheosis 里还没有这两个配方）。

判断依据是同一台机器上的前后对照：装本汉化包之前的那次启动，日志里本包的文件 一次都没出现，这两个配方照样报同样的错、次数一模一样。本包也不含任何配方文件。

装 7.3 请下 -atm7.3 的包。 版本不对会让任务书文案与你的整合包对不上—— 不同版本的英文原文本来就不同，我们按版本分开发就是为了这个。

安装器可能一个文件都没装，却显示「✅ 汉化已应用」#

受影响的是 vr16 及更早的全部版本。 判断自己是否中招：安装器那行 「已备份 0 个将被覆盖的文件」——在真实的 ATM10 实例上这个数不可能是 0， 是 0 就说明那次安装其实没生效，请用本版安装器重装一次。

极限反应堆章节：任务书里的名字和实际物品对不上#

照着任务里写的名字去 JEI 搜，以前搜不到；现在任务书里的每个名字都与物品名一致。 共 13 个任务的描述受影响，受影响的是 vr16 及更早的全部版本。

游戏内的「发现新版本」提示从来没弹出来过#

受影响的是 vr16-beta4 与 vr16——这个提示是那时才加进来的，从加进来那天起 就没工作过一次；vr15 及更早根本没有这个功能。换成 r17 即可，不需要做任何额外操作。

仍然可以用环境变量 ATM_SKIP_UPDATE_CHECK=1 关掉联网检查（与安装器同一个开关）； 检查失败时只往日志写一行，不会打扰游戏。

R16#

修 #5 报的 5 处瑕疵#

受影响的是 vr15 及更早的全部版本。

女巫和监守者那两条，模组自己的英文原文就写错了（写的是 Cat 和 Axolotl， 而配方要的是鸡和牛）。中文按游戏里实际的配方写，不跟着原文错。

顺带一处玩家看得见的改动：158 个仪式物品的名字里，「仪式」后面的冒号从全角改成了 半角加空格（仪式: 合成灌注镜片）。上面那条 Jade 显示要正常，这是必要条件。

根源经典的教程书不再冲出页面#

这本书的折行是模组自己写的，只在空格处断句。英文单词之间有空格所以没事， 中文一个空格都没有，整段就被当成一个词，怎么都断不开。现在中文在打包时就按 书页宽度切好，断点插的空格正好落在行尾，看不出来。

受影响的是 vr15 及更早的全部版本。

两条任务的描述被红字报错顶掉#

这两条都是整合包自带中文里的笔误：& 在任务书里是颜色码前缀，后面跟的字母 被漏掉或者写了个不认识的，FTB 就把整段描述换成那行红字。已经覆盖修掉。

受影响的是 vr15 及更早的全部版本。

神秘学的物品说明里多出来的方框#

物品说明是整条画出来的、不会在中间断行，原文里的换行符就被当成普通字符画了出来。 英文版同样有这个方框，我们这边先绕掉。

受影响的是 vr15 及更早的全部版本。

自动化之火终于能看出是哪个仪式#

那行字是仪式的注册名，写在物品数据里，资源包够不着，所以改成显示时替换。 ME 终端里一堆自动化之火的样板，现在能直接看中文分辨。

受影响的是 vr15 及更早的全部版本。

结构名在各处统一#

叫法一律向中文百科和游戏内的结构名对齐。

受影响的是 vr15 及更早的全部版本。

任务书的修正在服务器上可能随机失效#

发作条件是「在服务器/客户端第一次启动之前就把汉化包装进去」，而且只在目录顺序 不按名字返回的文件系统上（典型是 Linux 服务器的 ext4）。已经跑过一次再装包的机器 从来不会碰到——我们自己的测试服正好是后一种，所以一直没发现。

修法是任务书语言改成整份替换：下发的是「整合包自己那份中文 + 本包的修正」， 文件名与整合包原本的一致。同一个键从此只由一份文件持有。服务主注意： 装包时会覆盖 config/ftbquests/quests/lang/zh_cn/ 下的同名文件，装之前照例先备份。

受影响的是 vr16-beta3 及更早的全部版本。

安装器会永久删掉你自己的 .txt 文件#

旧版本的清理是「递归删掉那个目录下的全部 .txt」，不看内容也不按清单。 你自己放的 CC 程序数据、别的补丁的文件，只要后缀是 .txt 就一起没了。 现在只认 lua/rom/help/ 这一层、只删含中文的（我们发的是中译本，CC 自带的全是英文）， 而且删的每一个文件都会先复制进本次备份目录。

受影响的是 vr16-beta3 及更早的全部版本。

Windows 全新实例装完还是英文#

PowerShell 的单引号字符串会把内嵌的双引号原样保留成两个，写出来的数组解析不了。 如果你之前在 Windows 上「装完发现全是英文」，多半就是这个。 （macOS / Linux 的安装器没有这个问题。）

受影响的是 vr16-beta3 及更早的全部版本。

安装器支持一键更新#

菜单里有新正式版时会多出 [u] 一键下载并更新：按你这份包的 ATM 版本去 Release 里挑对应的客户端包（不会把 7.0 的实例升成 7.2 包），校验 SHA-256 通过后才解包安装， 装完把备份归并回原目录、并把原目录里的安装器本身也换成新版。校验不过或摘要缺失一律拒绝。 Windows 与 macOS / Linux 行为一致。

不想让安装器联网就设环境变量 ATM_SKIP_UPDATE_CHECK=1，设了之后这一项不会出现。

致谢#

感谢 Sym601ETH 的反馈： #5、 #8。

感谢 Cioe_ 的反馈。

感谢 phoenix594 的反馈： #9，以及 #7。

感谢 PHCHNGAMING： #6。

R15#

修掉 vr14 的全场景掉帧#

受影响的是 vr14 全部版本，vr13 及更早不受影响。 装本版即可，不用改配置、 不用删文件。

原因是我们自己的替换表：vr14 往 VaultPatcher 的动态替换里堆了太多条目，而那种 替换是全局开销，界面文字越多越明显。本版把它从 3396 条压回 1086 条，其中最贵的 「子串替换」从 168 条压到 4 条。

代价只有一处：「模组配置界面汉化」暂不随包发行（744 条标签，vr14 里是 2232 条 替换）。凡是通过 Create 的「模组配置」列表打开的配置页，选项名都回到英文——不只是 Create 自己的，那个列表会枚举所有带标准配置的模组。见已知限制。 建筑风格名和其他任何译文都不受影响，一条没少。

装过 r14 的人不用做额外操作：安装器会自动清掉 r14 装进去的 vaultpatcher/modules/config_ui_generated.json 与 catnip_config_ui.json。 （这一步会先把它们收进本次备份，选「恢复备份」能拿回来。）

译名修正#

R14#

现代化工业：物品名、机器界面、导览书#

电压等级 LV / MV / HV / EV / SV 按科技模组通例保留英文。

建筑棒 / MineColonies：40 个建筑风格终于是中文#

风格名和描述写在各模组 jar 内部的 pack.json 里，不走语言文件， 所以整个「切换建筑包」界面一直是英文。

界面顶部那行 包名/类别/文件名 是路径，不是界面文字。structurize 把同一个字符串 既拿去显示、又拿去当查表的键用（楼层行甚至把「路径:序号」塞进一个隐藏的文本控件， 点击时再读回来），译了它就等于把键改坏——vr14 beta2 就是这么崩的， 见下面的「预览蓝图闪退」。所以这一层整类放弃，宁可英文。

受影响的只有 vr14-beta1 和 vr14-beta2 两个测试版。 拿包内真实蓝图路径 逐版回放替换表的结果：

装的是 vr13 或更早的不用管这条。

界面本身也修了四处：

另外「本地」结构包分类与说明、这一套最后 6 条漏译一并补上，「拾取种子」改回「选择种子」。

RFTools 建造机：悬浮窗写的和卡片名对不上#

首页新增两个按钮：汉化包主页 / 问题反馈#

放在首页按钮网格的最后一行，样式与其余按钮一致（沿用整合包自己的 GitHub 按钮 底稿重绘中文，左边那个图标本来就是 GitHub 标志）。点开分别跳汉化包仓库主页与 Issues 页——漏翻错译有地方报，不用再去翻发布页找链接。

整合包原有的按钮一个都没动，只是在下面加了一行。

模组配置界面汉化（1206 条）#

Create、AE2 那类配置页里的条目名没有翻译键——它把配置字段名 fluidFogSettings 按驼峰拆成 Fluid Fog Settings 现拼出来，全部模组文件里都搜不到这串字， 所以语言文件够不着，只能按最终显示的字符串替换。

做法不是一条条手写（整合包有 7190 个配置项，手写永远追不上、译法还会飘）， 而是逐词词典 + 生成器：475 个词条，字段名拆词后逐个查词典， 有一个词查不到就整条跳过，宁可留英文也不猜。

有两类故意不译，是为了不重演「一汉化就崩」：

• 单个词的条目名（On / Off / Client / Mode / Level…）：它们极可能同时是配置项的 枚举值，译了可能被反查或写回配置文件。整类放弃，911 条。
• 缺词的条目：5198 条，等词典补上再自动生效。

实测确认设置照常生效、配置文件里没有一个中文混进值里。

修复：错译#

CC: Tweaked 的游戏内 help 文档撤回汉化：它的终端只有 256 个自带字形、 没有汉字，中文进去整屏乱码。详见 README 已知限制。装过旧版的实例，安装器会 自动清掉盘上残留的那 97 个中文 help 文件——只覆盖不删除的话，装了新版仍然是乱码。

术语对齐#

6 处「悬浮窗里的名字」和「物品本身的名字」不一致，一律以物品名为准改齐。 玩家拿物品名在 JEI 里搜东西，这个必须是单一真源。

致谢#

感谢 Chr1sG029 的反馈： #2 · #3。

R13#

修复：R12 丢了 3.3 万条中文，结构罗盘整个界面变回英文#

R12 里有一次「清理」按「这个模组不在整合包里」把 230 个命名空间、 33194 条译文当死重删掉了，其中包括本包自己做的 817 条结构名。 结果是结构罗盘 / 自然罗盘的界面几乎全英文。

这个判据本身就是错的：罗盘、成就、JEI 分类这类界面读的是表， 跟模组加载没加载无关。全部恢复，命名空间数从 368 回到 598，与 R11 一致。

顺带修好两处罗盘上的老毛病（R11 也有）：

• Nullscape 的生物群系名之前写在 item. 前缀下，而罗盘查的是 biome.， 于是界面上直接显示原始键
• 「标签: Cold, Dry, End」这类词从来没有任何模组给过翻译键，游戏是拿原文 首字母大写顶上的。扫遍 482 个 jar 的生物群系标签共 60 个词，其中 9 个 与原版生物群系同名、原版已有中文，其余 50 个补齐

「来源」那一栏（Structory / When Dungeons Arise…）改不了：它取的是各模组 mods.toml 里的显示名，代码里根本没经过翻译系统。

天境章任务书：143 条，之前一条中文都没有#

ATM 官方中文有 63 个章节文件，唯独没有天境；英文侧是有的，所以这一章从来 就是全英文（服务器上尤其明显）。70 个标题 + 73 段描述全部译出，术语跟游戏里 的物品名走：圣石 / 紫晶 / 重力晶 / 神能 / 天根木 / 女武神 / 恐鸟 / 天跃兔 / 史维特 / 滑行魔石 / 烈阳巨灵 / 境云。

任务书章节配图的悬停提示#

76 处 hover 提示写死在章节文件里，语言文件覆盖不到，一条没译。现在全部中文， 术语按物品真名反查：高炉、亡灵术士、储水罐矿车、堡垒等。

自耕农手册整本汉化（妈妈的香草与丰收）#

这本书的正文有 148 段写死在模组自己的 JSON 里，不走语言文件，所以物品名早就 全译了、翻开书还是满页英文。现已全部译出：奶酪制作全流程、作物与果树、香草香料、 储藏室方块、汤锅与烤盘餐、饮品、甜点。

建筑棒 / MineColonies#

• 风格名、风格描述、建筑类别名（木工 / 石工 / 冶金 / 仓储…）现已汉化
• 修好按钮文字顶到左上角：上游那两个界面的 12 个按钮都漏写了对齐属性

安装器#

• 修复：options.txt 是 CRLF 换行时，资源包实际没被启用，玩家得自己进游戏 手动拖一次。这是多人反馈的老问题
• 装之前查一次最新正式版：装的不是最新版就提醒；装的是测试版会说明并给出切回 正式版的链接。查不到就跳过，不会拦住安装

修复：错译#

奶酪块的叫法也统一了（原先「羊乳酪」和「菲达干酪楔」指同一物品）。

其他补译#

• Ars Nouveau / Ars Elemental 法术书的 61 条风味文本
• 导览书里剩余的 141 段英文：AE2《提示与技巧》整页、《熔炉自动化》的工作原理， 以及神谕目录里 Oritech 的机器文档 115 段（反应堆、粒子加速器、精炼厂、 末影激光器、离心机、蒸汽机、喷气背包、链锯、核弹等）

术语对齐#

导览书里的用词改成跟游戏里的物品名一致，不再一处一个叫法：

R12#

本包从这里开始按整合包版本族维护：一次构建同时产出 7.0 / 7.1 / 7.2 三个专属包， 补丁自己的版本号与整合包版本解耦。每个版本有自己的数据库（versions/db/<版本>/）： 该版真实 jar 的 sha256 与不可变的 CurseForge fileID、VaultPatcher 每条 key 在该版 的存在状态、任务书英文底本，逐版核验，不共用近似值。

捞回 104 条被误删的译文：英文底本看不见 jar-in-jar#

上一次「清掉底本带来的死重」裁掉 238 个命名空间，判据是扫三版 jar 的 assets/<ns>/ 与 modId。这个判据有个盲区：库模组多半是 jar-in-jar 塞在别人 肚子里发的，mods/ 下没有自己的文件，但游戏照样加载、照样注册翻译键。

结果是 6 个真实存在的命名空间被当成「整合包里没有」删掉，共 104 条：

宿主 jar 逐个按 sha256 命中 versions/db/7.2/jars.json，确认是官方 7.2 自带。 丢的是玩家看得见的东西：属性名（高度、碰撞箱缩放）、Ars Nouveau 管理工具 整套界面、以太主菜单配置项、Tempad 的 返回 / 取消。

顺带订正判据本身。裁剪当时问的是「这个命名空间在不在」，但 Minecraft 把全部 assets/*/lang/zh_cn.json 合并成一张全局表，文件搁在哪个命名空间并不限制它能 定义哪些键。该问的是「这条键会不会被查到」。按键重核：删掉的 34,842 条里， 7.2 真会查的正好 104 条，其余 34,738 条确实永远加载不到——那部分裁得对。

病因修在 build_en_baseline.py：mod_en() 现在下钻 META-INF/jarjar/， 顶层先扫、嵌套后补（同名以顶层为准，顶层 jar 一定被加载）。抽出的命名空间从 323 个增至 402 个，这 6 个的 en_us 条数与译文条数逐个吻合。底本是一堆判断的 依据，它瞎一块，下游就跟着错一片。已生成的 versions/db/*/lang_baseline_local.json 要重跑才会带上这 78 个此前看不见的命名空间。

常见问题增补：模组是中文、唯独原版是英文#

有玩家报「原版方块全变成英文了，整合包的都是中文」。日志里是这一句：

[Render thread/WARN] [net.minecraft.client.resources.language.ClientLanguage]:
  Failed to load translations for zh_cn from pack vanilla
java.nio.file.NoSuchFileException: ...\assets\objects\c4\c4ea30a9…

原版的中文不在客户端 jar 里——jar 的 assets/minecraft/lang/ 只有 en_us.json 一个文件；中文是启动器按资源索引单独下载、存进 assets/objects/ 的。这份缺了， 原版就整片回落英文，而模组的中文在各自 jar 里，跟着 mods/ 走，纹丝不动。 两半分家的症状就是这么来的，跟资源包顺序（另一条常见问题）不是一回事。

与本包无关：src/pack/assets/minecraft/lang/zh_cn.json 是三个版本包共用的唯一真源， 统共 130 条（102 条成就、16 条附魔、11 条物品、1 条杂项），一条方块名都没有—— 原版方块名本包从头到尾没碰过。反过来这也是个可对的指纹：真是资源缺失的话， 玩家会看到方块物品全英文、成就与部分附魔名却是中文。

README 常见问题加了这条，写明日志特征串、补全办法，以及第三方更新器装包为何最容易踩 （更新器只管模组和配置，原版资源归启动器管）。

包里的说明文档改名叫「请安装前务必看我.md」#

大多数人是从别处拿到 zip 的，不会去 GitHub 看 README，所以文件名得自己把话说完。 客户端与服务端两个包里的说明都改成这个名字。

verify_dist.py 加了一道：包里没有这个文件就不许发——改名要是哪天被谁改回去， 构建当场红。它没有进「原样分发」的豁免名单：服务端那份是由 SERVER.md 套上 版本号生成的，必须继续查占位符（「7.0 的包里印着 7.2」就是这条闸抓到的）。

版本数据库锚到字节：jars.json 记 sha256，不再只记文件名#

整套 versions/db/ 的合法性来自一句话——「对着该版本真实的 jar 逐条核验」。 但记下来的证据一直只是一串文件名。同名重传、本机换过的 jar、下坏的文件， 记录长得一模一样，而库照样声称「已验证」。一个以「不信声明只信字节」为前提的体系， 最后没有锚定字节。

这不是假想。versions/db/7.2/ 原本就是拿本机实例建的，里面躺着自制的 ysm-stub-2.9.9.jar（YSM 不支持 macOS，自己做的桩），而官方那份 7.2 里根本没有它。 只看文件名，完全看不出来。

现在：

• fetch_pack.py 下载时记 (projectID, fileID, sha256, size)。fileID 在 CurseForge 上是不可变的（重传会得到新 ID），把它和实际字节绑一起，才谈得上「这就是那一份」。
• jars.json 变成「文件名 → sha256 + fileID」，并带上 manifest 应有的总数。
• 目录里出现 manifest 之外的 jar → 拒绝建库（正是这条抓出了上面那两个）。
• 少下的 jar 必须在 versions/<版本>/unobtainable.json 里逐个登记原因才放行。 7.0 有 3 个、7.1 有 1 个文件已在 CurseForge 上删除（HTTP 404，重试无用）—— 这是永久事实，摆在明面上，而不是藏在一次静默的下载失败里：拿残缺集合建库， 库里那些 "missing" 判定就可能是假的。
• 三个版本的库全部拿干净的官方下载重建。
• 顺带修了 tree_digest：它会把按 manifest 下载的 jar 也算进 overrides 指纹， 于是同一个目录跑第二次就报指纹不符。
• 另一件事值得写下来：整合包自己的 overrides/mods/ 里也可能有 jar。 ATM10 7.2 就在那儿放了 cc-tweaked 1.120.0，用来盖掉 manifest 里那个会崩的 1.113.1。 这些 jar 是这一版的正当组成部分，既要进指纹也要进出处（只是它们没有 fileID）。 一开始按「mods/ 一律排除」处理，7.2 的指纹当场对不上——CI 抓到的。

校验从「一串顺序执行的检查」改成规则解释器#

check.py 原来是 284 行命令式代码、注释编号 1 到 8，加第 9 条规则要改文件、 加第 10 条再改一次。更要命的是有两类东西会持续累积——废弃译名、豁免白名单—— 硬编码进脚本，脚本就会慢慢长成垃圾桶。

现在规则是数据（src/rules/*.json），check.py 只提供检查器并按 kind 分派：

• 加一条同类规则 → 只改 JSON
• 加一种新检查器 → 才动脚本
• why 字段必填。这些规则几乎每条背后都有一次真事故，理由不写下来， 后人既不敢删也不敢改，最后只能绕过去
• 认不出的 kind 直接让校验失败——改错一个字母规则就静默失效，比不加还危险

按键扫描器重写成数据流分析，并变成一条硬门控#

注册名（options.txt 里 key_<name> 的那个 name）被翻译碰到，玩家的键位绑定会 静默回默认值。原来的扫描器只认 ldc 常量：拿一份真跑过的 options.txt 的 494 条 当真值一比，只认出 191 个，其中 25 个还是假的（把分类、格式串当成了注册名）。

重写成按 CFG 逐指令模拟操作数栈：分支处合并、long/double 老实占两格、 按方法描述符定位第几个参数，再顺着取值链回溯——静态字段、枚举实例字段、 helper 方法形参、lambda 捕获变量、invokedynamic 字符串拼接，一路求值。

结果（对着那 494 条真值）：

• 假名字 25 → 0
• 分类 76 个（旧扫描器报的 79 个里有 3 个是假的）
• 完整解出的注册名 193 个
• 注册名的字符串原子覆盖 93.5%——最终名字常常是运行期拼出来的 （"artifacts.key.%s.%s".formatted(…)），但组成它的字面量是死的、躺在常量池里， 而 VaultPatcher 改的正是常量池。所以门控比的是原子，不是最终名字。
• 实测：我们 1362 条替换原文，一条都没撞进按键名或其原子

构建工具链进依赖图#

之前只能「比像素不能比 sha256」，因为 PNG 字节跨平台不同。那是描述症状：病因是 Pillow 的 wheel 里打包着 freetype / zlib / libpng，工具链没被钉住，产物哈希自然没意义。

• src/toolchain.lock.json：容器镜像按 digest 钉（tag 会被重新指向，digest 不会）、 Pillow 版本、五份字体的 sha256
• requirements.lock：Pillow 全平台 wheel 哈希，装的时候必须 --require-hashes
• build / release 两条 CI 都搬进那个容器里跑
• fetch_fonts.sh 下完逐个核哈希——字形栅格化直接决定每一个像素
• PNG 写入参数显式化，不吃 Pillow 默认值
• toolchain.py 明确区分两种构建：标准环境下 verify_dist.py 拿内容指纹硬比； 别的环境照样能构建，但明说哈希不作数，绝不假装比过了

VaultPatcher 不再入库，改按 sha256 从 Modrinth 现取（顺带升到 1.5.2）#

仓库里不该放二进制。src/mods.lock.json 写死「哪个项目、哪个版本、什么地址、 什么哈希」，fetch_mods.py 构建时现取并逐个核 sha256——对不上就退出， 不会把来路不明的 jar 打进包里（对抗验证：把锁里的哈希改错一位，构建按预期红）。

顺带从 1.5.1 升到 1.5.2（Modrinth 上没有 1.5.1）。实机验过：服务层照常加载， 注册 459 个类转换器，与 1.5.1 完全一致，游戏正常起到主菜单。

JEI 拼音搜索（jecharacters）暂时仍入库——它只在 CurseForge 上有，而 CurseForge 的搜索与项目页接口挡机器人，拿不到能钉死的地址。哪天它上了 Modrinth 再挪过去。

CurseForge 从最高频那道闸上挪开：按版本缓存 + 内容指纹门控#

ci.yml 每个 PR 都要为三个版本各取一次官方 overrides，而 CurseForge 是整条链上 唯一不受我们控制的外部依赖（无配额说明、会限速、默认 UA 被挡）。它压在最高频的 那道闸上，一抽风整个 PR 就红。

ATM10 的某个已发布版本，它的 overrides 内容是不会变的。所以：

• versions/<版本>/overrides.sha256 记下整棵树的指纹（路径 + 内容，排序后逐个吃进哈希）。
• 三个 workflow 都加 actions/cache，键就是这三个指纹文件的 hash——只有我们有意 改了目标版本时才失效。命中缓存完全不联网。
• 命中与否都要核指纹：fetch_pack.py --verify 专门做这件事。CurseForge 哪天换了内容、 或者缓存里的东西坏了，构建当场红，而不是拿另一份东西去打补丁。

按键绑定界面的分类标题：逐个扫出来补齐#

「按键绑定」界面里，每组键位上方那行分类标题一直有一批是英文（Create、 Auroras、Corail Tombstone…），还有几个直接把翻译键裸露给玩家看 （key.categories.industrialization_overdrive）。

以前没修是因为数不准：在 lang 里按 key.categor* 匹配，既漏掉「没人定义所以 显示原始键」的，也完全看不见「压根不是翻译键、而是硬编码字面量」的那一类。 新增 scripts/scan_keybind_categories.py 直接读字节码——在每个 KeyMapping(…) 构造点取最后一个入栈的字符串常量，那就是分类。

扫出来全整合包共 81 个分类，其中 65 个本来就已是中文，剩下 16 个：

• 4 个补 lang：晶工艺（XyCraft）、指南（GuideME）、工业化超载、KubeJS （后两个原先无人定义，界面上露的是原始键）
• 7 个走 VaultPatcher 定向替换（硬编码在 class 里，lang 碰不到）： 机械动力（Create）、极光（Auroras）、墓碑（Corail Tombstone）、龙之进化 （Draconic Evolution）、铁喷气背包（Iron Jetpacks）、彩虹（Rainbows）、遗物（Relics）
• 其余跳过：key.kubejs.%s 是运行时拼的模板、key.jei.internal.* 是内部隐藏项， 以及下面这条血的教训里剔掉的那几个

踩了一次崩游戏的坑，已做成硬门控：我一开始把 open_upgrade_screen（压缩机器） 和三个模组共用的 category 也当成分类翻了。前者根本不是分类字符串——它被 modRL("open_upgrade_screen") 拿去构造 ResourceLocation，而 ResourceLocation 只接受 [a-z0-9/._-]，替换成中文后游戏在注册按键时直接 ResourceLocationException 崩溃，进不去主菜单。

check.py 新增硬检查：VaultPatcher 的原文如果长得像标识符（全小写 + 下划线/点/斜杠、 无空格），却被替换成中文，一律报错。这类串多半是注册名 / 翻译键 / 路径，不是界面文字。 对抗验证：把那条崩溃项塞回去，门控按预期拦下。

译名一律取本包已有的口径（itemGroup.relics = 遗物、任务书里的机械动力 / 龙之进化 / 晶工艺），不自造。三个版本的数据库重建后，11 个定向替换的目标类三版全部命中。

修复：装完汉化后键位 / 视频 / 声音设置被清空（玩家反馈）#

已有 options.txt 的情况是安全的——安装器只改 resourcePacks: 那一行，实测其余 598 行逐字节不变。出问题的是另一条路径：options.txt 不存在时新建一份。 新建的只有 lang:zh_cn 和资源包两行，游戏启动会把其余项按默认值补齐， 于是键位、视野、音量全部回到出厂设置。

一个玩过的实例必然有 logs/ 或 saves/；这时 options.txt 却不见了，多半是 选错了目录——启动器没开「版本隔离」时，设置在 .minecraft/options.txt， 那一层才是实例根目录。现在两个安装器遇到这种情况一律不新建，改为提示确认目录， 并告诉玩家手动启用资源包。从没启动过的实例（无 logs/ / saves/）行为不变。

三平台端到端测试加了这条回归，正反两面都测：玩过的实例必须拒绝新建， 全新实例必须照常新建。

顺带删掉了 config/defaultoptions/options.txt——三版整合包里没有任何模组读它， 官方 overrides 里也没有这个目录，纯属历史遗留，但它确实会覆盖玩家同名文件。

「设置只在 options.txt 里」是个错误前提，所以这次是拿整个实例做前后对照， 不是只看一个文件：安装器一共覆盖 239 个文件，而实例里 122 个「设置类」文件 （options.txt、config/sodium-options.json 画质、config/iris.properties 光影、 config/jei/*.ini、config/fancymenu/customization/、120 个 *-client.toml） 里只有 2 个被碰——options.txt（只改 resourcePacks: 一行） 和上面那个已删掉的 defaultoptions/options.txt。

清掉底本带来的死重：238 个模组根本不在整合包里#

原始底本覆盖的模组集比 ATM10 大。资源包里有 518 个文件属于 238 个命名空间， 而这些命名空间在 7.0 / 7.1 / 7.2 三版的全部 jar 里都不存在——游戏里永远加载不到。 其中 236 个 lang（abnormals_delight、abundantdelight、accessorify…）、 122 个 Modopedia 条目（enchanted）、83 个 justdynathings 指南页、 34 个 woot_revived 指南页等。

判定方式是机械的：扫三版全部 jar 的 assets/<ns>/ 与 data/<ns>/，再核一遍 每个 jar 声明的 modId。有 modId 但不出资源的 10 个库/API 模组保留 （flywheel、ponder、witchery、xaeroworldmap 等）——它们的翻译键仍可能被引用。

连带效果：奖杯名少 1472 条、木头名少 108 条，全部属于同一批不存在的模组 （entity.minecraft.villager.armorplus.* 这种是别的模组加的村民职业）。 资源包从 3496 个文件降到 2978 个，lang 从 598 个 / 21.2 万键降到 362 个 / 17.7 万键。 verify_dist.py 的下限已按新实测值重新校准——它这次正是先拦下了这次改动才让我发现要重定。

修复：服务端说明书在 7.0 / 7.1 的包里也印着「适用于 ATM10 7.2」#

SERVER.md 里那句「适用于 ATM10 7.2 专用服务器」是写死的，三个版本的服务端包 带的是同一份，于是 7.0 / 7.1 的用户打开说明书看到的是别的版本号。改成占位符现填。

同时把打包后的占位符残留检查从「只查 install.sh / install.ps1」扩到包里全部文本 文件——上次就是因为只查安装器，这处才漏到玩家手里。项目文档（README / CHANGELOG / CONTRIBUTING 等）是原样分发的，正文里会提到占位符本身，走白名单排除。

修复：奖杯名与木头名的快照把译文也缓存了#

build/snapshots/ 里那两份快照缓存的本该只是「扫 jar 才知道的东西」（有哪些实体、 英文名叫什么），却把我们自己的译文也一起缓存了。后果是改了资源包却没删快照时， 产物纹丝不动——实测把 tempad 的「时空门」统一成「时门」后，本机重跑六次产物都没变。 现在译文每次都以资源包为准重取。

顺带统一了 tempad 的译名：同模组 6 处写「时门」、entity.tempad.timedoor 一处写 「时空门」，按多数与物品名统一为时门。

又清掉三处「能算出来却手写死」的东西#

按同一条判据（换个整合包版本还对吗？能从官方数据推出来吗？）把 src/ 整个扫了一遍：

• 原版字体覆盖（font/default.json、font/uniform.json）。本包在原版的 provider 列表最前面插一条中文标点，做法要求把原版那份整份写下来。Mojang 哪天加一个 provider， 我们这份就把它整个吞掉且不报错。现取原版客户端 jar 里的那份再插。
• pack.mcmeta 的 pack_format。它由 Minecraft 版本决定，写死一个 34，将来整合包 换 MC 版本时资源包会被判成「不兼容」。现取客户端 version.json 的 pack_version.resource。
• VaultPatcher 主配置的模块清单。它就是模块文件名本身。手维护的那份此刻已经漏了 6 个（我们自己加的 *_zh 模块一个都没进去）——load_all_modules 为真时无害， 一旦有人关掉它这 6 个模块就静默失效。现按目录现填。

修复：7.0 / 7.1 的安装器界面印着「ATM10 7.2 汉化补丁」#

安装器里凡是跟整合包版本有关的字样，原先只有资源包文件名靠 sed 换掉， 界面标题那句「ATM10 7.2 汉化补丁 · 绿油油版 — 安装器」原样留在了三个包里。 现在全部改成 @@MCVER@@ 占位、由打包脚本按目标版本统一填；漏填会被 verify_dist.py 的占位符残留检查拦下。

顺带修了安装器测试的一个假通过：测试里 @@DEFAULT_PACKS@@ 压根没被替换， 安装器把这串占位符当成一个资源包名写进了 options.txt，测试照样绿。 现在测试与打包走完全同一套替换。

VaultPatcher 模块的 jar 名改由脚本按版本现填#

模块头部的 mods / desc 写的是带版本号的 jar 文件名（OctoLib-NEOFORGE-0.6.2+1.21.jar 这种）。整合包换个版本，一大半模组的 jar 版本号就变了，所以这两个字段不可能有一份通用的 ——原先手写死在仓库里，等于三个包里有两个是错的。拿 7.2 那份比对：7.1 只有 116/152 对得上，7.0 只有 83/152。

现在仓库里只留人写的部分（name / authors / dynamic / i18n + target_class + pairs）， mods 与 desc 由 gen_vaultpatcher.py 按 versions/db/<版本>/vaultpatcher.json 现填—— 那份数据库是拿该版真实字节码逐块解出来的，记着每个目标类实际由哪个 jar 提供。 152 个模块里有 70 个三版各不相同。

原版语言文件与点阵字体改从 Mojang 官方取#

奖杯名、木头名、格式串快照、任务书横幅这四个生成器都要读原版的 en_us / zh_cn 与 Unifont 点阵，原先只会从本机 HMCL 实例的目录布局里找（<实例>/<版本>.jar 加 .minecraft/assets/objects/）。CI 上的整合包目录只有 mods/，于是必然 StopIteration——Build 工作流从来就没跑通过。现在优先用本机实例（不联网、 结果不变），没有就按 Mojang 官方版本清单现取并缓存。

导览书改由模组 jar 现生成，顺手捞回两处被吞掉的上游内容#

Patchouli / AE2 Guide / Oracle Index 这些导览书，我们的译文原本是上游 JSON 的整份 副本，只有字符串换成了中文。结构、页码、配方引用全是上游的——模组一更新导览书， 我们那份旧副本就把新内容整个盖掉，玩家永远看不到，也没有任何报错。

改成只存「哪个位置、原文是什么、译成什么」（988 个文件、4350 条），构建时拿目标版本 jar 里的那份 JSON 重新套。列表按结构形状对齐而不是按下标硬对，所以上游在中间插一页 不会让后面的译文整体错位。另有 611 个「一个字都没翻」的副本退化成一行路径，构建时 从 jar 直接拷；709 个散文页记英文原稿指纹，上游改稿会被点名。

转换过程当场抓到两处正在发生的吞内容：

两处都已恢复，新那页也一并译出。

仓库重构：出货树全部移出版本库，上游文件只存改动#

以前仓库里躺着 kubejs/、config/、resourcepacks/、mods/ 四棵完整的出货目录树， 其中 77 个文件是整合包自带文件的修改副本。这有个看不见的后果：发出去的包是 「我们打包那天的上游 + 我们的改动」，上游后来的修复会被整个覆盖掉。多版本发布下 更直接——kubejs/startup_scripts/CustomAdditions.js 在 7.1→7.2 之间被 ATM 换掉了 冰与火的类名（iceandfire.data.DragonType → registry.IafDragonTypes）， 把基于 7.2 的副本发给 7.1 用户，Java.loadClass 当场找不到类。

改成：

• 仓库里只剩 src/（手写真源 + 上游改动映射）和 scripts/（生成器）。 四棵出货树一棵都没有，构建时由 scripts/assemble.py 从 src/ 现摊到 build/。
• 上游文件改存成 src/upstream/<路径>.json，内容是一组「找这几行 → 换成这几行」， 不带行号、不带上下文标记，因而与版本无关。构建时对着目标版本的官方文件套用： 7.1 的包拿到的是 7.1 自己的类名 + 我们的中文。共 63 个文件、238 处改动。
• 找不到原文就退出。 上游改了哪一行，构建当场失败，而不是静默发出一个 覆盖了别人修复的包。
• 顺带清掉了两处「已 gitignore 但仍留在索引里」的生成物：200 张任务书横幅、 14 张主菜单按钮图。它们本来就该由生成器现产。

重构前后逐字节比对：出货树 3767 个文件，多一个不多、少一个不少，内容差异只有 那 14 张按钮图——因为仓库里那份是用 macOS 系统字体生成的旧图，而生成器早已改用 OFL 思源黑体（这样 Linux 上的 CI 才能产出一致结果）。这正是「产物入库」会造成的 漂移本身。

术语统一：深暗之园全系按物品真名对齐#

任务书里的深暗之园章节用的是另一套自造译名，玩家照着去 JEI 搜什么都搜不到：

共 33 处。另外群系 rogdorium_grove 原译「罗格多里姆林地」是音译，而同族物品全是 意译的「澄腐」，同一种材料两套叫法 → 统一为澄腐林地；Sodium 粒子选项里的 3 条同样跟着改。

这批是做底本漂移检查时顺带发现的：查 7.1→7.2 英文变动、逐条核对中文，才发现这一章的 译名体系整个和物品名脱节。现有的 check_quest_desc_terms.py 只查「只差一个字」的变体， 这种完全另起一套的叫法它抓不到，是个检查缺口。

7.2#

修复：全新安装时汉化资源包被排到最低优先级（等于没启用）#

症状：全新实例装完汉化，进游戏后绝大部分翻译不生效。玩家在资源包界面里把包 拖到最上、最下都没用。

原因：全新实例没有 options.txt（Minecraft 退出时才写），安装器于是新建一份， 但只写了汉化包这一个。游戏首次启动时把整合包的 15 个内置包全部补进列表， 而它们被插到了汉化包后面——资源包是后面的覆盖前面的，于是汉化包实测落到 546 个包里的第 10 位，被 mod_resources 和五百多个模组包整个压住。

修复：新建 options.txt 时写入整合包的完整默认包列表（顺序照抄游戏自己写出来的）， 汉化包放最后一位。另外，options.txt 已存在时不再「发现已启用就跳过」， 而是先摘掉旧位置再追加到末尾——旧版本装出来的实例里它可能排在很前面， 不重新挪到最后等于没启用。

验证（对着官方 7.2 原包，真启动跑了两轮）： 修复前汉化包排 546 个包中的第 10 位；修复后排第 543 位，在 mod_resources 和全部模组包之后，与正常实例一致。

这条修复的已知局限：那 15 项默认列表是实测出来的，不是从整合包定义里推导的。 测试实例的 mod 集与官方 manifest 逐个比对过，差异只有 4 个光影 zip、 cc-tweaked 版本、以及两个额外 mod，都不注册内置资源包，所以列表应当完整； 但万一某个整合包版本多出内置资源包，它仍会被插到汉化包后面。 为此安装器在新建 options.txt 时会提示：首次进游戏若发现翻译没生效， 退出后重跑一次安装器即可——重跑会把汉化包重新挪到列表最后。

修复：全新安装时任务书变英文（本包覆盖了整合包自带的任务书翻译）#

症状：在没启动过的全新 ATM10 实例上装本包，进游戏后任务书整章整章是英文 （章节组名是中文、章节名和任务是英文）。已经启动过的实例看不出问题。 调资源包优先级无效——任务书的文字根本不走资源包。

原因：整合包自己也把任务书翻译拆成 config/ftbquests/quests/lang/zh_cn/chapters/<章节名>.snbt， 由 ftbquestslangsplitter 在进存档时按文件名字母序逐个合并进 zh_cn.snbt，后合并的覆盖先合并的。 本包的 delta 文件用了同样的命名，于是：

• 撞名 → 删掉整合包的翻译。安装器直接覆盖同名文件。对着官方 7.2 包实测， 34 个 delta 里 31 个撞名，把整合包 67 个任务书语言文件中的 31 个改小： productive_bees 567 键 → 4 键、basic_armor 347 键 → 2 键、 immersive_engineering 333 键 → 0 键、mekanism_reactors 287 键 → 4 键、 building_tips 257 键 → 3 键…… 已启动过的实例躲过一劫，是因为整合包那批早就合并完并改名成 .snbt_merged 了。
• 排序太靠前 → 本包的修正不生效。原先几个文件用 _ 开头，ASCII 里 _(0x5F) 排在 小写字母(0x61+)前面，在全新实例上会先于整合包的文件合并、再被整合包的原值盖回去。

修复：34 个 delta 全部改名为 zz_hanhua_<原名>.snbt——既不可能撞名（整合包的文件保住）， 又一定最后合并（本包的覆盖生效）。配套：

• check.py 新增硬校验：delta 文件名缺 zz_hanhua_ 前缀直接报错。
• 安装器新增遗留清理：删掉旧版本残留的旧名文件，且只在内容与本包新文件逐字节相同时才删， 绝不会误删整合包自己的文件；删到东西就提示用户旧版可能已破坏整合包翻译。
• 端到端回归对着官方 7.2 原包跑：新建一个从未启动过的实例（无 options.txt、 67 个官方任务书文件、0 个已合并标记），解压安装包、跑安装器， 官方 67 个文件安装后逐字节完好、本包 34 个文件并存。 同一套流程拿旧版 release7 跑对照组，破坏 31 个官方文件——证明这个测试测得出来， 不是走过场。 再真启动一次：ftbquestslangsplitter 在客户端启动时就完成合并，产出的 zh_cn.snbt 有 8366 键 / 70 个章节标题，官方 67 个文件无一被改小或丢失， 且本包的覆盖赢过官方原值（章节标题「神之术」→「神通术」、「极端事物」→「可怖之物」）。

已经中招的用户：重装一次整合包再运行本安装器即可；或用安装器的 backups/<时间戳>/ 回滚。

任务书艺术字第二轮：补到 200 张，换点阵中文字体，加三道机械校验#

• 横幅从 154 张补到 200 张。这一轮不靠人眼翻图找漏，改用 macOS Vision 把 questpics 下全部 1183 张图 OCR 一遍，再对形状像横幅（宽高比 ≥2.2）却没检出文字的 73 张做二次复扫，捞回 3 张漏检。判定：264 张含文字，扣掉任务书根本没引用的 23 张、 建筑师本人 ID 与作者署名 26 张（人名不译），实际补齐 46 张—— 天境 5（生物 / 武神女王 / 滑行魔石 / 烈阳巨灵 / 工具）、奇异饰品 5（腰带 / 手饰 / 首饰 / 项链 / 足部，槽位名取 curios 官方译法）、基础物流 5（基础 / 动态联合 / 物流 / 通用机械 / 管道）、永恒星光 4、建造技巧 4、神化 3、奥瑞科技 3、禁忌与奥秘 3，以及应用能源2 / 资源蜜蜂 / 悬赏板 / 食物与耕种 / 技巧与窍门 / 神秘农业 / 铁路工艺 / 神通术 / 晶工艺 / 更多熔炉 / 发电机盛会 / 第一章 等。
• 点阵中文换成缝合像素字体（OFL-1.1，scripts/fetch_fonts.sh 现取，字体不入库）。 原先用 Minecraft 自带的 Unifont，汉字画在 16px 框里、笔画只有 1px，配在原图那种粗壮的 像素英文旁边又细又虚；换字体后同样 1px 笔画占 1/11，放大倍率大四成半，笔画跟着变粗。 备 10 / 12 两档字框应对整数放大倍率的台阶，且只有在小字框没把笔画糊到一起 （数封闭内白判定）时才允许降档——「通用机械」「工具」就是这么被挡回 12px 的。 选缝合而非方舟本体，是因为方舟 zh_cn 12px 缺「旋热然聚嗡蟒骏」，缺字会渲成豆腐块。
• 对比度保底：中文笔画比英文细密，原图那套配色照搬过来容易糊成一坨。现在统一算描边 与字身的相对明度差，不足 96 就沿原描边色的方向压暗 / 提亮（只动明暗不动色相）， 一次性修掉几十张偏灰偏糊的。
• 新增三道机械校验，都是踩过坑才加的：
  • 擦除框边界不许切断连通域——「悬赏板」左边那对钻石剑、「食物与耕种」左边的装饰， 都被目测拍出来的百分比啃掉过。现在框按连通域算，切到就报错退出。
  • patch_from 平铺的最后一条要裁齐——原先整条贴会溢出文字框下沿， 把框外本该原样保留的像素盖掉（暮色森林被盖掉 5 万多个）。
  • 生成完把 200 张成图再 OCR 一遍，查有没有残留英文。
• 统一「神通术」：上游章节标题写「神之术」，而该章节所有任务正文与模组物品栏都写 「神通术」，同一章两个名字。按物品名统一为神通术。

绿油油版汉化（对应整合包 ATM10 7.2）。以 BBSMC 汉化为原始底本大幅重译，译文与底本已有大量出入，故独立命名、独立发布；致谢与许可见 致谢与技术说明.md。 客户端包与服务端包彻底分开发布，均附带三平台安装器 / 安装说明。

覆盖规模（实测口径）：整合包内 233 个模组自带官方中文，本包专注补齐其余部分—— 语言文件层 18 万余条，其中约 409 个模组的中文完全依赖本包、142 个模组补齐官方缺翻的键； 硬编码文本 1,452 条（151 个 VaultPatcher 模块）；RFTools 24 个 .gui；467 种资源蜂； 799 条结构名；任务书补丁 998 条；奖杯名 2.5 万条；精致存储木头名 1,517 条；主菜单按钮图 14 张。

主要修复 / 新增

• 主菜单首页汉化：ATM 主菜单按钮文字烤进 PNG 贴图，重绘 14 张为中文 （单人游戏 / 多人游戏 / 选项 / 退出 / 模组 / 语言 / 租用服务器）

• 系统性补译游戏内真实英文残留（~660 键）：用 jar 感知扫描（有效中文 = 模组官方自带 叠加资源包）找出真正显示英文的键——xtonesreworked 编号方块 496、Shiny 闪光热带鱼/村民 49、 MineColonies 守卫职业与任务对话 80，及 ~35 个模组的零散标签。剔除品牌名 / 罗马数字 / 快捷键 / 歌曲署名 / 技术缩写等本应保留英文的项，不盲翻。

• 补齐模组漏定义、会露原始键的名字（约 375 个）：Ender IO 灵魂瓶、Reliquary 护符、 Corail 墓碑卷轴、AE2 流体筛选等用 entity/block/fluid_type/effect.<ns>.<path> 通用引用名字， 但不少条目连模组自己都没在 en_us 定义 → 露出原始键。按可枚举真源（实体标签 / blockstates / mob_effect 纹理 / fluid.*_still）全模组扫描后补齐：59 实体 + 288 方块（含流体块，AE2 筛选流体用）

  • 3 流体类型 + 25 效果（含墓碑卷轴暴露的召唤计时效果）。

• 替上游修 bug：修正一批模组官方 zh_cn 自带的错误——死亡提示误加 %2$s 占位符导致 格式化失败（the_bumblezone / mcwfences / twilightforest）、minecolonies 指令取错参数、 神秘农业「夜视→步行辅助」、农夫乐事「免疫饥饿→无视饥饿回血」、Reliquary 虚空之泪模式反了等。

• 清理重复翻译：删除 17 个纯冗余文件（这些模组官方已全中文，资源包再盖属浪费）； 逐键 CJK 比对确保零英文回退，官方半成品（英文占位）文件全部保留。

• 任务书：补全 cataclysm / undergarden / railcraft / 神化 等章节缺口； 章节标题 XyCraft→晶工艺、Oritech→奥瑞科技、RailCraft→铁路工艺，补章节副标题； 「墓地」→「墓园」等译名与结构罗盘统一。

• 任务书术语 / 品牌统一（跟物品名对齐，不再执着保留英文）：以模组自译名 / 物品名 / 社区标准为单一真源——Allthemodium→ATM（与物品 ATM锭 / ATM镐 / ATM透视药水 统一，含基础 半吊子错译「所有modium」）、Just Dire Things→可怖之物（修正基础错译「极端事物」）、 EnderIO→末影接口、PneumaticCraft→气动工艺、EvilCraft→邪恶工艺、 Hostile Neural Networks→敌对神经网络、Ars Nouveau→新生魔艺、Pipez→管道、 Mob Grinding Utils→刷怪塔实用设备；维度名按社区认可：Mining Dimension→挖矿维度、 The Beyond→彼岸；「古代金字塔」与任务「远古金字塔」打架 → 统一为远古金字塔。 模组自身也保留英文的（MekaSuit / QIO / LaserIO / MEGA）不强译。

• 修任务书 3 个会崩溃的非法颜色码：&难得素秘术师护甲（漏了 &5）、&l&开裂&r石头 （漏了 &b）、&高级磁盘外壳（多余 &）——FTB 把 &+中文 当颜色码解析，报 「Invalid formatting! Unknown formatting symbol」。

• 补 Silent Gear 章节副标题：服务端缺 chapter_subtitle 键 → 显示英文 "And Productive Metalworks"，补基础译名「以及高效金属加工」（做成可复现 delta）。

• 修错译（AE2 物质聚合器一系，对齐机器真名 block.ae2.condenser＝物质聚合器）： 物质冷凝器→物质聚合器、冷凝物质/超冷凝物质→聚合物质/超聚合物质、「冷凝更多」→「聚合更多」 （condensed 指高度聚合，非热学冷凝）；仅改 AE2 语境，保留别模组的「魔源冷凝器/饱和冷凝器」。 结构罗盘补 trial_chambers→试炼密室（原版新结构，此前唯一漏网）。

• 正文对齐物品真名：ATM 星→ATM之星（item.allthetweaks.atm_star＝ATM之星，补漏「之」，13 处）。

• 全任务书正文机翻大扫除：3428 条正文经 12 路对抗精修 + 自动化校验（格式码 / 占位符 / 换行 / 术语字节级比对）， 改写 263 条真机翻 / 错译——反译（灌注塔生效范围、弩穿透逻辑说反）、附魔名混淆（水下速掘↔水下呼吸、 深海探索者）、数值错译（2700 颗心、9 格、540 血量等对齐英文）、漏译夹生英文词（overpowered / relentless / Titanium / read 等）、文化指代错译（Daredevil 敢死队→夜魔侠、Dr. Seuss→苏斯博士）、术语误译 （Tile Entity→方块实体、Kibi→奇异果、Kobold 哥布林→狗头人）、Pipez 升级机制描述错误、人称 / 敬语不一致等。 另修复 1 处 dict 转储污染（quest.6DB65926 的正文混入了一堆别的任务的 Python dict 垃圾文本）。

• flavor 文本本地化 / 修漏翻：ME 终端、武器?、无限增强器、无线终端（逐字彩虹）、脉动黑洞、 龙魂等副标题的机翻占位 / 狗屁不通句改成接地气或通顺文案； 修「武器?」正文漏翻的斜体 &oused&r（熵变机械臂那句）。

• 资源蜜蜂体系：译名单一真源 + 生成器派生双端脚本；服务端按 NBT ID 迁移旧蜂笼 / 实体显示名； 玩家命名牌名字绝不触碰；JEI 类型行精确翻译。

• 结构罗盘 / 自然罗盘结构名；传送石碑维度名；The Bumblezone 维度统一为「嗡嗡领域」； Sodium 模组自定义粒子选项。

• 神秘农业作物名假翻译修复（纯客户端）；修复其配置误上服务器导致的进服刷屏报错。

• RFTools：24 个 .gui + 硬编码界面文本；建造机服务端聊天反馈汉化 （服务端包 VaultPatcher 类定向模块）；协议值按设计保留英文防崩溃。

• Jonn's Trophies 奖杯名汉化（推翻上一版「无法汉化」的结论）：反编译 trophymanager 2.5.0 后确认 TrophyItem.getName() 是 Component.translatable(NBT.TrophyData.Name) —— 烘焙进 NBT 的那串 「<生物显示名> Trophy」是被当翻译键用的，资源包完全能翻。按四种烘焙形态 （创造栏 idToName 的 Polar bear／专用服务端 en_us 的 Polar Bear／服务端 查不到键时的原始键名／单人存档下的中文名）全量生成 2.5 万条映射， 并补上 entity.<ns>.name = "Shiny %s" 这类模板拼名实体 （实测烘焙成 Shiny zombie_horse Trophy，纯 en_us 扫描会整类漏掉）。 多个实体撞同一串烘焙名且译名不同的 33 条按老规矩丢弃——宁显英文不张冠李戴。 生成器 scripts/gen_trophy_names.py + 快照 scripts/trophy_entity_names.json，单一真源。

• 格式串对抗（用 Minecraft 自己的 FORMAT_PATTERN 逐键比对英文原文）：

  • 修 7 条结尾裸 %：MC 的格式正则会匹配到字符串结尾并抛 TranslatableFormatException（原版自带的反例键就是 translation.test.invalid = "hi %"）， Create 随机填充、railcraft 轨道提示、reliquary 配置项等；
  • 修 20 条致命格式错：译文多出英文没有的参数（silentgear 蓝图书、oritech 无人机、 integrateddynamics 签名/输入类型）、把 %s 降级成 %d/%f 导致类型对不上 （modular routers 投掷器/调整值、silentgear 修理包与采掘等级、EI 循环时间）、 以及参数顺序搞反（curios 加/删栏位把「数量」和「类型」对调、ftbchunks 把玩家名 和区块数对调、ftbquests 队伍名与奖励数对调、MI 超频把倍率当刻数）；
  • 修 8 条非法 § 颜色码（§ 后面跟中文 → 那个字被渲染器吞掉）：气动工艺 「向左/右§侧展开」「§喷溅型」、实体过滤帮助、mekanistic routers 模块标题等；
  • 修 十余条参数被译文吞掉： DimStorage 储量/液体/亮度/温度数值整个不显示、JourneyMap 路径点 Id、 刷怪塔锯片升级把上限写死成 10、artifacts 触发几率、工业先锋镭射透镜颜色前缀、 MineColonies 用了全角 ％s 导致界面直接显示「％s」、 以及 misc.refinedstorage.no_permission.open 的译文竟然是「64k存储元件」这么个 完全无关的物品名。

• 精致存储木桶/箱子的木头名（1517 条）：反编译 sophisticatedstorage 1.5.80 确认 getWoodDisplayName() 用 translatableWithFallback("wood_name.sophisticatedstorage.<木头>", 美化后的注册名)， 而 jar 里只定义了 11 种原版木头的键 → 模组木头全部回退成英文 （「限类Jackfruit木桶 I」）。译名不另起一套，直接从该木头的木板名推导 （橡木木板→橡木、竹板→竹、绯红菌板→绯红菌），单一真源。 模组注册 WoodType 有两种风格，键名跟着变，两种都发： new WoodType("productivetrees:red_banana") → ….productivetrees.red_banana、 new WoodType("bloom") → ….bloom（deeperdarker 繁花木就是裸名那种）。 裸名撞车且译名不一致的 5 条丢弃（alder / ironwood / mangrove / red_bamboo / rowan）， 宁显英文不张冠李戴。生成器 scripts/gen_wood_names.py + 快照 scripts/wood_planks_names.json。 ⚠️ 同时撤回上一版把 %s木桶 补成 %s%s木桶 的改动：第二个参数经字节码确认 只是一个空格分隔符，中文不需要，补上去只会变成「限类Pink Ipe 木桶 I」。

• 任务书术语全面对齐物品真名（238 处）——玩家照任务书去 JEI 搜不到东西是最伤的 bug。 新增反查扫描器 scripts/check_quest_item_names.py：每条任务在 chapters/*.snbt 里 都绑定了物品 ID（tasks[].item），拿 ID 反查物品中文真名，标题就该用这个名字。 4638 条任务、4168 条绑了物品 → 164 条标题对不上 → 修 161 条（故意保留 3 条，理由见下）。

  • Extreme Reactors 整套自造材料名任务书另起了一套词（47 处）：蓝晶→青氰、 血铀→蓝钚、荒谬石→谑质、疯狂石→狂质、乐铬石→谬素、无用石→虚素、 苯托石→蓝锥矿、罗辛石/罗斯诺石→赤锶、流体化机→流化器、再加工器→再处理器。
  • Generator Galore：15 种材料的「X生成器」→「X发电机」共 31 处， 附魔生成器→魔咒发电机（通用说法「圆石生成器/凋灵生成器」已保护，未误改）。
  • 标题批量对齐（150 条）：蒸汽烤箱→蒸汽炉、闪电炸弹→雷击炸弹、颜色应用器→染色器、 锻压台→锻造锤、粉碎机→碎石机、精钢精华块→究极精华块、振金合金锭→振金锭、 ATM 合金锭→ATM锭、凋灵建造者→凋灵生成器 等。
  • 半中半英没翻完的：「血液 Brooms」→血能扫帚、「The 充能球」→充能台。
  • 上游英文自己拼错、中文跟着错的（精确匹配抓不到，靠模糊比对捞出来）： Galadorian Drills（正确 Galgadorian）→ 中文音译成「加尔加多里安钻头」， 实为混合晶化金属钻头；Cockatrice Specter（正确 Scepter）→「鸡蛇幽魂」实为鸡蛇节杖； Necronomicom→亡灵律典；Grimore→唤魔者典籍；Chasis→轴向底盘；Adapt→水下适性模块。 正文里同名的 12 处一并对齐（只改标题不改正文＝又一处对不上）。
  • 中文另起了一套译名：闪电龙钢→龙霆钢、龙族胸甲→神龙护胸、混沌胸甲→混沌护胸、 基础（龙族）核心→基础龙芯、彩虹镀层→彩虹外壳。
  • 故意保留 3 条：铁路工艺（RailCraft 是模组名）、制造硫酸（动作描述，绑的硫磺是原料）、 凋灵头颅卷轴（物品是通用「法术卷轴」，标题点明法术更有用）。
  • 扫描器踩过的坑已写进注释：tasks: [{ 同行写法会让行级正则漏九成任务； 英文标题不设门槛会让「锁链盔甲」这类概括标题全变误报； &z 这种非法颜色码不剥掉，会吃掉英文词边界（&zRainbow Plating 因此整条漏检）。

• 修任务书 3 类会误导操作的硬错误：

  • 维度写错（5 条）：The Other（异界）被写成「彼岸」/「其他世界」——彼岸是 The Beyond，是另一个维度，照着找会跑错地方。反向 0 条。
  • 配方写错：英文 "8 Insanite Ingots and 1 Block of Inanite"，中文两个都写成 「狂质」，照着合不出来；连 "Inanite not Insanite" 都译成了「狂质而不是狂质」。 按 Insanite=狂质 / Inanite=虚素 重写。
  • 张冠李戴：Magentite（玫磁）被当成 Magnetite 译为「磁铁矿」（真实矿物， 与游戏内容无关）；副标题「粉碎…钚矿石」实为 Blutonium 锭，非矿石。

• 发布前体检（3445 条进度文本 + 全包 21 万条值的机械筛查）：

  • 修 9 处编码损坏（mojibake）：aether 的台阶 lore 里 building's 的撇号被存成了 ’（UTF-8 当 Latin-1 解读的典型残迹），玩家看到的是「去构建’s 屋顶吧」。
  • 进度文本对齐既定译名：Railcraft→铁路工艺（2 处）；补翻 CAMPFIRE LIT→营火已点燃。
  • 121 条句末半角 !/? 改全角（中文排版规范，也是「劣质翻译」最直观的观感来源）。 只转「中文 + 半角标点 + 句尾/中文」且跳过含代码/宏/URL 的值 —— railcraft 路由脚本示例 Color=黑色,红色 里的逗号是语法分隔符，神秘农业手册通篇用半角句点，都留待整体处理。
  • 奖杯生成器加台词过滤：entity. 前缀不代表是实体名——MineColonies 用 entity.<职业>.<消息> 存工人台词、The Bumblezone 用 bee_queen.<事件> 存蜂后对白， 混进来会造出「复活节快乐!奖杯」这种垃圾键。按「实体名必是短名词、无句子标点」过滤后 2.56 万 → 2.52 万条，服务器实测的 52 种烘焙名仍 52/52 全覆盖。

• 「石」字滥用清查（MC 里「石头」是特指方块，「石」不能随手加）：全量比对英文原文， 找出中文用了「石」但英文毫无石/矿物概念的键，剔除矿物学正名（橄榄石 Peridot、 绿松石 Turquoise、金绿柱石 Heliodor、蓝柱石 Euclase、硝石 Saltpeter、圆粒金刚石 Bort、 符石 Sigil、石斑鱼 Grouper、石中剑 Caliburn、石化蜂蜜 Petrified Honey 等）后，实修：

  • Chipped 的 155 个 Column 全译成「柱石」 → 统一为「柱」。整合包其余模组 （Create 安山岩柱 / Rechiseled 紫水晶柱 / Synergy 耐火黏土柱…）与原版 （石英柱 / 紫珀柱）都用「柱」，只有 Chipped 例外；且套在非石头材质上直接读不通 （切制冰柱石 / 泥土柱石 / 粗铜柱石），石头材质则叠字（切制石头柱石）。
  • Frosted Ice「霜冰石」→「霜冰」：它是冰不是石，且与同模组 Icestone（真的是石头， 译「冰石」）撞得更晕。
  • Pillar「白金柱石」→「白金柱」：同族 Pillar Top 本来就译作「浮雕顶柱」，自相矛盾。

• 铁路工艺 Crusher：碎石机 → 粉碎机：它不止能碎石头，而且 MC 里「石头」是特指的 方块名，叫碎石机会误导。从物品真源改起，不是只改任务书： block/container.railcraft.crusher、JEI 配方分类（碎石→粉碎）、进度描述、 Patchouli 导览书（该页本来就自相矛盾：标题写粉碎机、正文写碎石机； 顺手修正文里写反的尺寸 2×3×2 → 3×2×2），以及任务书标题。 注意「碎石螨 / 碎石盾牌 / 碎石小径 / 神化 stonebreaker」是别的东西，未触碰。

• Oritech 统一为「奥瑞科技」：本包 oritech 界面侧（oracle_index.title.oritech / advancements.oritech.begin / key.oritech.hotkey_category）本来就是「奥瑞科技」， 是任务书被统一成了「奥日科技」、创造栏还留着「Oritech 机械」这种英文品牌形式，三处分家。 以界面真源为准全表面收敛：任务书 9 处、创造栏 4 个页签、强化开关 / 涂装说明 / Jade 插件名， 以及 oritechthings（「Oritech Things」→奥瑞科技扩展）与 datanessence 的合金页。

• 地名对齐结构罗盘 / 原版：「地牢」→「合金地牢」（结构罗盘就叫这个）、 「深暗生物群系」→「深暗之域」、「堡垒」→「堡垒遗迹」（4 处；「下界堡垒」还会与 下界要塞 Nether Fortress 混淆，英文原文本就没有「下界」限定词）。

• ATM 自带 tooltip 机翻修复：拉官方 AllTheMods/ATM-10 的 tooltips.js 逐行比对—— These arent the ingots you are looking for 是星战欧比旺心灵控制梗，直译丢了挥手动作 → 「（挥了挥手）这不是你要找的锭」；Look for the [Silent X Plate] 对齐物品真名； Disabled for Fake Player→「对假玩家无效」；战利品袋的 Lunar Monstrosity→「月藤巨物」。 同目录另两个手写脚本也逐行比对过（Mekanism-Tooltips 94 行 / RecipeViewer 184 行，0 漏翻）， 修 RecipeViewer 一处颜色码整体错位（「末地」被染成深灰、末尾物品丢了紫色）。

• 消除 kubejs / atm10_localization 两命名空间的 40 条同键冲突：同一个 key 两处取值不同， 谁生效取决于命名空间加载顺序（字母序靠后的 kubejs 赢），玩家因此看到 「寂静Allthemodium板」。其中 10 条是被遮蔽那份把一堆硫磺写成「炼金硫**%s**」—— 物品名带 %s，一旦生效就是格式化炸弹。已先修生效那份的确凿错误 （全合金螺栓→ATM螺栓、全合金钻头→ATM钻头，神秘农业等级名对齐官方译名 下级/初级/中级/高级/终极），再把被遮蔽那份同步过去，冲突归零。

• 修 generatorgalore.screen.generation_rate：英文 Rate: %sFE/t 被翻成「燃料类型」， 与同界面的 Fuel type 撞车 → 「产能速率」。

• 把这次踩的坑变成硬检查（scripts/check.py 第 6 节，打包时自动跑）： 译文的占位符集合必须 ⊆ 英文原文的（可以少，绝不可以多；「少」是译者的合法选择， 禁止擅自补回来）、同序号参数不许把 %s 降级成 %d/%f、禁止结尾裸 %、 禁止英文原文没有的非法 § 码。真源 scripts/upstream_format_en_us.json。

• 品牌名被按词典义机翻（8 条）：作者社交链接按钮 Discord→「不和」 （SFM 工厂管理器与 Observable 两处）、Ko-fi→「咖啡相伴/天堂之路」 （mss/mes/mns/mvs 四个模组）、Patreon→「赞助」。这类是点进去要能对上的平台名， 一律还原英文——跟「不执着保留英文品牌名」不矛盾：玩家认的是译名，平台认的是原名。

• LICENSE / 各源文件加入作者署名（Copyright © 2026 星野夢華）。

• 安装器：三平台、自动备份 / 恢复、options.txt 自动启用、可选拼音搜索、 实例目录自动检测失败时支持手动输入路径（含清洗复制/拖拽带来的引号与转义空格，配套 CI 回归测试）。

• 质量基建：踩过的雷转为 CI 硬检查（协议值 / 生成器漂移 / 旧译名残留 / 服务端模块安全）； 安装脚本在 macOS / Windows / Linux 三系统跑端到端测试。

• 任务书「正文」也照绑定物品反查了一遍（新扫描器 scripts/check_quest_desc_terms.py）： 上一轮只对齐了标题，正文是盲区——实测大量任务标题写着物品真名、正文里另起一个名字， 玩家照正文去 JEI 搜不到东西。做法是拿该任务绑定物品的中文真名，在标题/副标题/正文里找 「只差一个字」的变体（作用域必须限定在这条任务绑定的那几个物品；拿全包 6 万条物品名去比全是噪声）。 346 条候选逐条核对，坐实并修 89 处，例如： 「生命补片」正文写「生命幻片」、「虚空模块」写「真空模块」（同一段里还把「销毁模块」也叫成了「虚空模块」）、 「耀光下界书架」写「发光下界书架」（4 处）、「灵魂触摸幽匿书架」写「灵魂触碰」（8 处）、 「真空冷冻机」写「真空冷却机」（6 处）、「自动合成仓」写「自动合成器」、「龙霜/龙炎锻炉」混称「龙息锻炉」、 「魔力提升护身符」写「法力」（新生魔艺全模组统一用「魔力」）、「传送机」写「传送器」、 「符文附魔台」写「符文附魔器」、「铸件台」写「铸造台」、「粉碎机」写「破碎机」、 「分子装配室」写「分子装配器」、「离魂匕首」写「灵魂匕首」、「末影粉」写「末影尘」、 「寒风境云/金黄境云」写「冷境云/金色境云」等。误报（如「双足飞龙镐」「石英硫母岩」本就是真名）已剔除。

• 修任务书 delta 之间的 11 处重复键：_atm_terms_fix.snbt 与各模组 delta 对同一个 key 给了不同值， 哪份生效取决于合并顺序——已对齐的新标题被旧文件盖回去（「终极磁盘接口」被盖成「究极磁盘接口」、 「样板终端」被盖成「样板网格」、「宝石柜」被盖成「宝石匣」等）。按物品真名保留唯一一份， 并把「delta 不得有重复键」做成 scripts/check.py 第 7 节硬检查。

• 修 Windows 安装器在「就地解压」后再运行会崩：用户把压缩包内容直接解压覆盖到实例根目录、 随后又运行安装脚本时，脚本目录与实例目录是同一层，Copy-Item 把文件复制到自己头上， 抛 Cannot overwrite the item ... with itself。安装器现在会识别这种装法、跳过复制只补 options.txt， 并明确告知这种装法没有备份可回退。macOS/Linux 侧同步加固。

• 修安装器在「全新未启动过的实例」上死循环：options.txt 是 Minecraft 退出时才写的， 刚装好的整合包根本没有这个文件，而安装器把它当成识别实例的必要条件 → 无论用户输什么路径 都判定「不是实例」，反复追问。现在按 mods/ + jar 数量识别实例（ATM10 有 400+ 个 jar， 汉化包自己的 mods/ 只有 1 个，可靠区分）；没有 options.txt 时改由整合包自带的 DefaultOptions 接手——config/defaultoptions/options.txt 里已预置资源包与中文语言， 首次启动游戏时自动生效。

• Windows 路径鲁棒性：双击安装-Windows.bat 改为纯 ASCII + CRLF，并在 chcp 之前 取好 %~dp0（cmd 按字节偏移重读批处理文件，中途切代码页会在非 ASCII 路径下错位）； install.ps1 所有路径操作改用 -LiteralPath（含空格、中文、方括号的路径都不会被当通配符）。 测试覆盖含中文+空格的实例路径。

• 修压缩包里的中文文件名在 Windows 自带解压下变乱码：macOS/Linux 自带的 Info-ZIP 不置 UTF-8 标志位（general purpose bit 11），Windows「提取全部」就按系统代码页去解， 双击安装-Windows.bat 到用户手里成了乱码——而那正是要双击的文件。改用 scripts/mkzip.py 打包（Python zipfile 会自动置位），并另附一个 ASCII 别名 install-windows.bat 兜底。

• 发布包改用 ASCII 文件名：atm10-zh_cn-client-vX.zip / atm10-zh_cn-server-vX.zip （中文压缩包名/目录名在 Windows 各解压软件之间编码不一致，用户拿到手就是乱码）。

• README 重写安装章节：新增「我该下载哪个包？」——明确回答单人玩家只装客户端包 （单人时客户端自带内置服务端，蜂笼迁移脚本也已随客户端包附带）；分步图示两种装法的区别与后果。

• 减小底本在包内的存在感：删掉随包分发的两份 BBSMC 原始说明（含广告条款、 自动汉化工具宣传、以及会把本包 bug 引流到底本反馈渠道的内容），改为自撰的 致谢与技术说明.md——保留 BBSMC 底本致谢与 CFPA 的 CC BY-NC-SA 4.0 署名， 说明 VaultPatcher / data 覆盖 / KubeJS 三类改动的原理，反馈渠道指向本项目 Issues。

• 主菜单按钮的中文放大加粗：原字号在游戏内实际显示尺寸下偏小、字重偏细，可读性不足。文字是烤进 PNG 的 （996×234，FancyMenu 直接贴图，语言文件够不着），改为字高 49px → 62px（+27%）、 字重由常规提到中粗（Hiragino Sans GB W6）。底边仍锚在 y=132，与下划线和图标的 相对关系不变。顺带把水平位置统一居中于下划线——第一版逐图沿用英文原文的中心， 导致 2 字标签（选项/退出）与 4~5 字标签（单人游戏/租用服务器）中心相差近 60px， 放大后错位更扎眼。 这批图第一版是手工渲染、没留脚本，反馈来了无从改起；现补 scripts/gen_menu_buttons.py， 擦除矩形是常量因而可反复重跑（实测两次输出 md5 一致），下次调字号只改一个数。 改动需完整重启游戏才生效（贴图不走 F3+T 重载）。

• 再修 5 处任务正文术语：powah:energizing_orb 的中文真名是充能台，正文却通篇写 「充能球」（6 处，标题是对的所以更容易误导）；另有 the Bumblezone「结晶炮」写成「水晶炮」、 「雷电权杖」写成「闪电权杖」、模块化路由器「投掷模块」写成「抛投器模块」。 这几条扫描器本来就报了，是在人工分诊时按「变体全书只出现 1 次 = 句子碎片」二次过滤掉的 —— 这个筛子不成立，单次出现的真错误照样存在。现已把去重后的两百多组候选整份读完， 并把这条教训写进 scripts/check_quest_desc_terms.py 的说明里。

• 修 PotionsMaster 矿石透视药水的中文被模组顶掉：本包早已备齐这 154 个动态键 （22 种矿 × 7 条：粉、煅烧粉、效果、药水、喷溅、滞留、药箭），一个不缺，但游戏里仍显示 Potion of Allthemodium Sight。反编译 DynamicLanguageProvider 查明原因：它是一个 资源重载监听器，在语言表建好之后用反射拿到 Language 的存储 Map，再用 Map.put （不是 putIfAbsent）把自己生成的英文写进去——资源包的译文被原地覆盖。日志实锤： Successfully found translation storage with 234869 entries → Successfully injected 154 dynamic language entries for 22 ores。 它还有个 injected 静态开关，每次启动只注入一次，所以启动后按一次 F3+T 重载资源， 语言表会按资源包重建而模组不再注入，中文就回来了——这也是「时灵时不灵」的由来。 修法：新增 VaultPatcher 模块 potionsmaster_dynamic_lang.json，把它注入时用的 key 模板 改掉（item.minecraft.potion.effect. → vphanhua.dropped.potion. 等 7 条）， 让那 154 条英文落进废键，资源包的中文得以保留。仅客户端，未列入服务端模块清单。

• 任务书图片艺术字全面中文化（154 张）：ATM 的章节顶上挂的是图片，文字直接画在 PNG 里， 语言文件够不着。原图是整合包自带的散装文件（kubejs/assets/atm/textures/questpics/）， 而资源包的加载顺序排在 KubeJS 之后，所以本包放同路径的图即可覆盖。 任务书里带文字的图片远不止章节标题——章节内还有大量分区标签、生物名牌、阶级图。 按「章节实际引用的 571 张图」逐张过，共 154 张含文字并已全部重绘为中文，包括： 章节标题 31 张、通用机械 24 张（一~四级矿物处理 / 裂变聚变反应堆 / 通用装甲 / 感应矩阵…）、 冰与火 21 张（生物名牌，取模组 lang 官方译名：鸡蛇 / 骏鹰 / 铜羽泽鹗 / 翼蚺 / 电龙…）、 魔法使 12 张（石中剑 / 克拉伦特 / 摩根 / 赤之黑键…）、灾变 9 张（Boss 名同上）、 沉浸工程 7 张、机械动力 7 张、嗡嗡领域 6 张、深暗之园 6 张、禁忌与奥秘 5 阶、 更深更暗 5 张、神化 6 张（阿卡那 / 位阶 / 量子化 / 灌注 / 印记 / 世界层级）等。

  不动的：building_tips/building_title_* 26 张是建筑师本人的 ID（人名，不该翻）； 另有一批只是图标没有文字（书架插图、锻造台图标、木框等）——同一本任务书里中英横幅混杂比字体风格不完全一致更难受。

  写什么字有单一真源：每张标题图都只被一个章节引用（生成时会重新核验）， 直接取那一章已有的中文标题，侧边栏 / 章节标题 / 横幅三处永远一致。 例：机械动力 / 通用机械 / 暮色森林 / 神秘学 / 沉浸工程 / 工业先锋 / 龙之进化 / 新生魔艺 / 嗡嗡领域 / 深暗之园 / 奥瑞科技 / 气动工艺 / 禁忌与奥秘 / 动态联合……

  怎么画：不逐张手调配色（调不过来也不可复现），而是从原图采样。 关键一点：ATM 的标题字大多不是纯色，而是「文字当遮罩、底下是一张材质图」—— APOTHIC 是裂纹石头、UNDERGARDEN 是长苔石、FIRE DRAGON 是岩浆岩、 EXTENDED AND ADVANCED AE 干脆是用方块贴图拼出来的立体字。 所以填充不能塌成一个颜色或一条渐变（那样纹理和方块效果就全没了）， 而是按行提取原字内部的像素序列、横向平铺成一张与画布同大的材质板， 再用中文字形当遮罩去取色——中文看起来就像用同一种材料刻出来的。其余细节： 描边色取「不透明但四邻有透明像素」那一圈的中位色；填充按行切片取中位色得到一条 竖向渐变再重采样到中文上（原图金色渐变，中文也是金色渐变）；尺寸以原图内容框 为基准而非整块画布，避免中文比原文大一圈撑爆版面。 逐行中位色本身是抖的（像素画一行里深浅块交替），且源色带常比目标字高矮， 直接最近邻拉伸会在笔画上拉出一道道横纹；所以先滑动平均抹平、取样时再线性插值。 另外只取最高的那一条文字带采样——不少原图是两行且两行异色 （APOTHIC 灰 / ENCHANTING 紫、DRACONIC / EVOLUTION、INDUSTRIAL FOREGOING 加副标）， 整块一起采会把「上灰下紫」当成渐变，映到一行中文上就是拦腰一道色带。 少数图除文字外还有装饰（神秘学两侧的怪、气动工艺右侧图标、暮色森林压在石砖带上的字）， 单独标出「只有英文字的那个框」，只在框内替换、框外原样保留；石砖带那张从下方 干净的砖行取纹理平铺补洞。另有 4 张自动采样会采到底纹导致发灰，给了显式配色。

  字形用 Minecraft 自己的字：早期版本拿系统黑体渲染，矢量平滑字形跟原图的像素英文 完全不搭。正解是用 GNU Unifont——Minecraft 渲染中文时用的就是它，16×16 点阵， 整合包 assets 里自带（minecraft/font/unifont.zip），不需要任何外部字体。 按它的 .hex 位图在 1 倍尺度拼字，再按整数倍最近邻放大到目标框；描边也在 1 倍 尺度膨胀后一起放大，所以描边同样是方块状。这样中文与原图的像素英文是同一套观感。 生成器 scripts/gen_quest_banners.py 参数全部常量化、可重跑。需完整重启游戏才生效。

• 按键绑定界面：补齐 4 个显示原始键名的按键。用 options.txt 里的 key_* 反查出 全部 494 个已注册按键逐一比对，找出 5 个连英文都没有的（模组注册了按键却忘了写 语言条目，属上游漏写），其中 4 个本包也没补： key.ae2.wireless_exp_encoding_terminal（→ 打开无线拓充样板编码终端）、 key.ponder.ponder（→ 思索）、key.kubejs.kubedex（→ 打开 Kubedex）、 key.industrialization_overdrive.terminal_mode_switch（→ 切换终端模式）。现已全覆盖。

• 修 ExpandedAE 与 ExtendedAE 两个模组的中文撞名：本包给 ExpandedAE 补的译名用了 「扩展」，而「扩展」是另一个模组 ExtendedAE 的译名——ME扩展驱动器、ME扩展IO端口 两边一字不差，JEI 里根本分不出是哪个模组的东西。ExpandedAE 自带的中文本来就用「拓充」 （拓充样板供应器），本包补的部分统一改回「拓充」：拓充合成单元 / ME拓充驱动器 / ME拓充IO端口 / 拓充样板编码终端 / 无线拓充样板编码终端。

• 统一 ExpandedAE 并行处理单元一族的命名：本包补的 19 条里混了三套说法 （并行处理单元 / 合成协处理器 / 合成并行处理单元），还有一条多了个空格。 AE2 原版 block.ae2.crafting_accelerator（Crafting Co-Processing Unit）就叫 「并行处理单元」，全部照它统一为 <N>x并行处理单元 / <N>K并行处理单元。

已知限制

• Sodium「粒子效果」里的原版粒子名无法汉化：sodium-extra 0.9.3 自身问题 （它内置的原版粒子中文也渲染不出来），资源包无法干预；模组自定义粒子不受影响。
• 玩家奖杯（击杀玩家掉落）名字是玩家 ID，本就不该翻译。
• 用命名牌改过名的生物，掉落奖杯会沿用你起的名字（CustomName 优先），不受本包影响。