Skip to content

v1.2.0 — 入门指南示例汉化 · 按区域汉化 · Linux 版

Choose a tag to compare

View all tags
@DC1024 DC1024 released this 28 Sep 15:27
· 13 commits to main since this release
v1.2.0
fbd4e47

⚠️ 本版的「② 同步最新汉化」拉不到入门指南的 welcome 文件（URL 未做百分号编码）。请下载 v1.2.1 或更新版本。

本次更新 / What's new

三条主线：入门指南示例也汉化了、可以只汉化选中的区域、提供 Linux 版。

1. 入门指南示例文件已汉化

欢迎页「入门指南」里的教程页与示例工程，正文说明文字换成了中文（33 个 .pxc，351 处文本）。

教程文字不在图片里，而在 .pxc 工程文件的文本节点上，所以本版先实现了 .pxc 容器的编解码（PXCX 文件头 + THMB/META 分块 + zlib 主数据），只替换说明文字、不动工程结构。

覆盖面 数量
Getting started/ 教程页 17
Sample Projects/ 示例工程 15
Templates/ 模板 1
  • 按同名覆盖写入数据目录的 Welcome files/，文件名保持英文 → 不会出现中英两套重复卡片，也不破坏 Steam 自动更新
  • 原文件备份到 Welcome files.bak_cn/，③ 恢复英文 一键还原
  • 备份取自官方 pack/welcome_files.zip（而不是"当前文件"）—— 否则第二次安装会把中文存进备份，「恢复英文」会还原出中文。存错的备份会自动纠正
  • 目标目录缺缩略图 PNG 时，从同一个 zip 补齐
  • 构建时对 <node …> / <bt …> / <spr …> 这类查找键标签做多重集自检，译文里改动了就拒绝生成（否则游戏找不到对应图标）

游戏内效果

2. 按选中区域汉化（默认全部）

界面新增六个复选框，默认全选 = 全部汉化。想保留英文习惯（比如已经熟悉的节点名）就把对应项取消勾选。

区域 覆盖
界面词条 words 菜单、工具栏、状态栏、设置项
面板与对话框 ui 各类面板与弹窗正文
节点名称与提示 nodes 节点名与说明
连接点名称 junctions 输入/输出端口名
中文字体 fonts 随包中文字体（不勾可能显示方块）
入门指南示例 welcome 教程页与示例工程里的说明文字
  • 取消勾选 = 不安装该文件，游戏回退内置英文；不是往本地写一份英文副本 —— 那会让已装包永远与线上清单哈希不符，每次同步都重下整包
  • 选择记录在已装 manifest.json 的 selected 字段并参与比对，所以「改了选择」不会被误判成「已是最新」
  • 取消勾选 welcome 会自动把示例还原成英文
  • 命令行等价写法：--modules words,ui / --list-modules

3. Linux 版汉化程序

Linux 版是纯 Python 标准库实现（不跑翻译引擎，也不需要编译），所以发行包里直接就是源码 + 一键脚本：

tar -xzf PixelComposer-CN-Linux.tar.gz
cd PixelComposer-CN-Linux
./install.sh              # 有 tkinter 开图形界面，没有就自动进命令行（功能一致）
./install.sh install      # 或直接一键汉化
./install.sh deps         # 看看本机缺什么
  • 路径探测覆盖 原生 Linux（$XDG_DATA_HOME/PixelComposer）与 Proton 前缀（compatdata/2299510/pfx/...）
  • Steam 库来自 STEAM_ROOT / ~/.steam / ~/.local/share/Steam / flatpak / snap / /media|/run/media|/mnt，并解析 libraryfolders.vdf
  • tkinter 缺失不影响使用 —— SteamOS 根分区只读装不上它属于常态
  • 支持 install / sync / restore / rollback / status / layouts / modules / leftovers / deps
平台 状态 数据目录
Windows ✅ 完整支持 %LOCALAPPDATA%\PixelComposer（或被重定向到游戏目录）
Linux 原生 / SteamOS ✅ 完整支持 $XDG_DATA_HOME/PixelComposer
Linux（Proton） ✅ 自动识别前缀 …/compatdata/2299510/pfx/drive_c/users/*/AppData/Local/PixelComposer
macOS（Beta） ⚠️ 路径已适配、未实机验证 ~/Library/Application Support/PixelComposer

4. 旧社区汉化包残留：只列出，不删除

装过旧社区包的话，它会把 zh/ 和 Welcome files/ 永久留在游戏根目录。新增 ⑧ 旧汉化包残留清点（--leftovers / ./install.sh leftovers）可以拿到完整清单（路径 / 大小 / 文件数）—— 实测一台机器上是 10 项 / 32.67 MB，包含旧包自己的 13.6 MB 汉化 EXE。

本工具不会替你删除任何东西，确认不需要请自行手动处理。

已知限制（新增一条）

欢迎页上的卡片标题（Introduction、Node Shortcuts…）取的是 .pxc 的文件名，程序不查语言表 —— 所以标题保持英文，但点进去以后页面里的正文是中文。这是"同名覆盖"方案的必然结果，换来的是不出现中英两套重复卡片、不破坏 Steam 更新。

验证

Windows 实机

  • 两个数据目录各 41/41 文件与 manifest.json 的 sha256 逐字节一致
  • 33 个入门指南备份与官方 welcome_files.zip 逐字节一致
  • 游戏内实测：欢迎页 → 入门指南 → 教程正文为中文，且游戏没有把文件还原回英文

Ubuntu 22.04.4 真机（伪造 Steam 库 + libraryfolders.vdf 外挂库）

  • 正确识别安装目录、从 pack/locale.zip 抽出 en 兜底
  • 按模块安装只落对应文件（--modules words,junctions → 恰好 4 个文件）
  • welcome 安装 / 取消勾选还原 / 备份自愈（污染后自动纠正）全部通过
  • 发行包内 15 个关键文件 sha256 与仓库一致（含 11 MB 字体与 .pxc）

下载

  • PixelComposer-CN-Patcher.exe — Windows 免安装，双击即用
  • PixelComposer-CN-Linux.tar.gz — 解压后 ./install.sh
Assets 4
Loading