向Peacock贡献代码:从本地化翻译到自动化工作流,7步成为HITMAN私服开发者

发布时间:2026/8/22 13:01:39
向Peacock贡献代码:从本地化翻译到自动化工作流,7步成为HITMAN私服开发者 向Peacock贡献代码从本地化翻译到自动化工作流7步成为HITMAN私服开发者【免费下载链接】PeacockThe Peacock Project is a HITMAN™ World of Assassination trilogy server replacement.项目地址: https://gitcode.com/gh_mirrors/pe/PeacockPeacock是《HITMAN™ 世界暗杀组织》三部曲的私服替代服务器HITMAN World of Assassination server replacement用 TypeScript 重写以游戏存档为目的同时为游戏增加新功能与内容。本文带你完整走通 Peacock 的开源贡献流程从本地化翻译到自动化工作流只需 7 步即可提交你的第一个 Pull Request成为 HITMAN 私服开发者。第 1 步快速搭建 Peacock 本地开发环境 ️Peacock 是 Node.js Yarn 的 TypeScript 单体仓库环境准备只需 4 个命令安装 Node.js项目要求 20.x 或 22.x详见 package.json 的 engines 字段克隆仓库git clone https://gitcode.com/gh_mirrors/pe/Peacock在项目根目录执行corepack enable启用 Yarn 包管理器运行yarn install安装全部依赖。官方推荐 WebStorm非商用免费作为 IDEVSCode 也完全可用。开发文档见 readme.md。第 2 步认识项目结构找到你的第一个任务 仓库主要目录一目了然components/— 服务端核心逻辑菜单、契约路由、排行榜等contractdata/— 各地图契约与挑战数据JSONstatic/— 游戏内界面模板数据resources/— 本地化语言包与重建脚本patcher/、patcher-darwin/— Windows / macOS 内存补丁器webui/— 开发者 Web 管理界面新手找任务有两条路在 Issues 区翻找 bug 报告模板见.github/ISSUE_TEMPLATE/bug_report.md和功能建议.github/ISSUE_TEMPLATE/feature_request.md或者直接上手最友好、门槛最低的本地化翻译。第 3 步编辑 locale.json 完成本地化翻译 Peacock 的所有自定义字符串集中在一个文件resources/locale.json近 4000 行。它按语言分组目前已内置english、french、german、italian、japanese、polish、russian、spanish共 8 种语言。格式就是普通的键值对例如{ english: { UI_PEACOCK_KOATS_CONSPIRACY: The KOats Conspiracy }, japanese: { UI_PEACOCK_KOATS_CONSPIRACY: ... } }官方给出的翻译规则来自 readme.md新增字符串必须为所有语言都填写英文版本翻译现有字符串只需翻译你负责的语言即可。第 4 步推送改动并提交 Pull Request 翻译完成后推送分支、发起 PR 即可。Peacock 的 PR 模板.github/pull_request_template.md只要求两部分Scope说明你改了哪些内容并关联对应 IssueTest Plan说明你如何验证改动生效。提交后系统会根据你改动的文件自动附加一份 Checklist全部勾选后点击 Ready for review 进入人工评审。第 5 步理解 CI 自动化工作流如何守护你的代码 Peacock 的 CI 全部定义在.github/workflows/目录核心有三条工作流触发时机作用build.ymlPR / 推送到 master 或版本分支在 CI 中执行yarn buildyarn optimize打包 Windows / Linux 版本tests.yml代码变更时运行tests/目录下的 Vitest 单元测试codeql.yml定期扫描CodeQL 安全代码审计也就是说你提交的 PR 会自动完成构建、测试与安全扫描评审人看到的绿勾就是质量背书。本地自测可以运行yarn lint、yarn typecheck和yarn prettier:check提前排雷。第 6 步见证自动化工作流重建语言包 ✨这是 Peacock 最巧妙的自动化设计。你不需要本地编译任何 RPKG 语言包——流程全自动你提交 PR 修改resources/locale.json并通过评审合并到 masterlocale.yml工作流被文件变更自动触发在 CI 上下载rpkg-cli与HMLanguageTools工具链运行yarn rebuild-locale即resources/rebuildLocale.cjs脚本把 8 种语言注入 H2/H3 的本地化数据结构机器人PeacockBot自动提交更新后的resources/dynamic_resources_h2.rpkg和dynamic_resources_h3.rpkg。后续打发布标签时locale-mod.yml还会自动把最新字符串同步到 peacock-strings 模组仓库供模组分发使用。整个过程开发者零操作。如果确需本地手动重建如测试只要把rpkg_cli.exe、HMLanguageTools.exe和ResourceLib_*.dll放入resources文件夹再执行yarn rebuild-locale即可生成的 RPKG 不要手动提交留给自动工作流处理。第 7 步遵守贡献红线顺利合并你的 PR ✅最后记住 Peacock 的两条硬性规范禁止 AI 生成内容readme 中明确声明不接受由大语言模型或生成式 AI 参与创作的任何代码、文档、PR、Issue 和评论详见 readme 的 AI Usage Guidelines 章节评审归属.github/CODEOWNERS指定了各模块评审人例如resources/目录含本地化由 AnthonyFuller 负责.github/workflows由 RDIL 负责——翻译 PR 会被自动指派给对应负责人。总结一张图看懂 7 步贡献路径 搭环境 → 找任务 → 改 locale.json → 提 PR → CI 自动验证 → 合并后自动重建语言包 → 守规范等合并从环境搭建到 PR 合并翻译类贡献全程无需编译游戏资源是最适合新手的切入点而熟悉components/代码后你完全可以向 HITMAN 私服社区提交新功能。Peacock 采用 AGPL-3.0 开源协议感谢每一位为游戏存档与进化贡献力量的开发者。【免费下载链接】PeacockThe Peacock Project is a HITMAN™ World of Assassination trilogy server replacement.项目地址: https://gitcode.com/gh_mirrors/pe/Peacock创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考