Peacock快速入门教程：5个步骤从零部署你的HITMAN暗杀世界私服

Peacock快速入门教程：5个步骤从零部署你的HITMAN暗杀世界私服

【免费下载链接】PeacockThe Peacock Project is a HITMAN™ World of Assassination trilogy server replacement.项目地址: https://gitcode.com/gh_mirrors/pe/Peacock

Peacock 是一个免费的 HITMAN™ World of Assassination（杀手系列三部曲）私服服务器替代方案，核心目标是游戏保存——即使官方服务器停止服务，你依然可以在本地运行自己的暗杀世界。本教程带你用 5 个步骤，从零部署 Peacock 私服，无需游戏开发经验。

第1步：安装 Node.js 运行环境 🛠️

Peacock 服务器基于 Node.js + TypeScript 开发，需要满足以下版本要求（见 package.json 中的 engines 字段）：

组件	要求版本	说明
Node.js	22.x（推荐 22.9.0+）	支持 20.x，推荐最新 22 版本
Yarn	4.x	通过 corepack 自动启用，无需单独安装
操作系统	Windows / Linux / macOS	服务器端跨平台

💡小贴士：安装 Node.js 时建议选择 LTS 版本，装完后在终端输入node -v验证版本号以 22 开头即可。

第2步：克隆 Peacock 仓库 📦

在终端中执行以下命令，将仓库克隆到你喜欢的位置：

git clone https://gitcode.com/gh_mirrors/pe/Peacock

克隆完成后，进入项目目录：

cd Peacock

项目结构一览，帮你快速认识这个"暗杀世界"：

• components/—— 服务器核心代码：菜单系统、合同路由、玩家档案、多人联机
• contractdata/—— 全部 20+ 个地图区域的合同、挑战、精通数据（如 PARIS、SAPIENZA、BANGKOK）
• static/—— 游戏内页面模板与配置（菜单、仪表盘、商店数据等）
• patcher/—— 游戏客户端内存补丁工具的源码（C# 版）
• packaging/—— 构建、打包与部署工具

第3步：安装依赖 ⚡

⚠️ 在 Windows 上，请以管理员身份打开终端。

在项目根目录依次执行：

corepack enable yarn install

第一条命令启用 Yarn（项目锁定 Yarn 4.13.0，corepack 会自动匹配正确版本）；第二条命令安装全部依赖，通常 1~3 分钟完成。看到进度条走完、无红色报错，就说明安装成功了。

第4步：启动 Peacock 服务器 🚀

你有两种方式启动服务器：

方式一：开发模式启动（推荐新手）

yarn run-dev

这会通过 devLoader.mjs 以热重载方式启动，改代码即时生效，适合边跑边学。

方式二：生产构建启动

yarn build yarn start

构建脚本会将整个服务器打包为单个chunk0.js文件，之后只需node chunk0.js即可运行——这也是官方发布包的工作方式（见 Start Server.cmd）。

启动后服务器默认监听localhost，会对外提供认证、在线配置、静态资源、合同数据等全套接口。你可以打开浏览器访问http://localhost验证服务是否正常响应。

📌 服务器版本与游戏版本对应关系定义在 ServerVersionConfig.json 中，部署多版本私服时可按需修改GAME_VER字段。

第5步：让游戏客户端连接你的私服 🎯

光有服务器还不够，还需要把本地游戏"指"向你的私服：

1. 运行补丁程序：项目根目录附带PeacockPatcher.exe（源码位于 patcher/），运行它会自动修补游戏客户端，将网络请求重定向到本地服务器。macOS 用户可参考 patcher-darwin/ 下的 C++ 实现自行编译。
2. 启动游戏：正常打开 HITMAN World of Assassination，游戏将连接到你的 Peacock 私服。
3. 进入 Peacock 菜单：游戏主菜单中会出现专属的 Peacock 选项页，可开关各种私服特性（如离线游玩、自定义合同、进度同步），配置由 options.json 驱动。
4. 开始暗杀：浏览仪表盘选择地图（萨皮恩扎、巴黎、莫斯科……），你的进度会保存在本地玩家档案中，支持从官方进度同步（见 USER_PROFILES.md）。

常见问题 FAQ 💬

Q1：yarn install报权限错误怎么办？Windows 请确认使用了管理员终端；Linux/macOS 不要使用sudo，先检查 Node 和 npm 缓存目录权限。

Q2：服务器启动后游戏连不上？先确认补丁程序已成功运行（会弹出成功提示）；再确认服务器仍在运行、防火墙未拦截本地端口；最后核对游戏版本与 ServerVersionConfig.json 中的GAME_VER是否匹配。

Q3：Peacock 私服是免费的吗？有法律风险吗？Peacock 基于 AGPL-3.0 开源协议免费授权，主要用于游戏保存和单机研究。本项目与 IO Interactive 官方无关，请仅用于自己合法拥有的游戏副本。

Q4：我可以修改合同数据做自定义关卡吗？可以！contractdata/ 下每个 JSON 文件对应一个合同或挑战集，配合 ESCALATION_GUIDELINES.md 的编写规范，你就能创造专属暗杀任务。

总结 ✅

步骤	命令/操作	耗时
1️⃣ 安装 Node.js 22	官网下载安装	5 分钟
2️⃣ 克隆仓库	git clone	2 分钟
3️⃣ 安装依赖	corepack enable+yarn install	3 分钟
4️⃣ 启动服务器	yarn run-dev	1 分钟
5️⃣ 补丁并进入游戏	运行 PeacockPatcher.exe	2 分钟

不到 15 分钟，你就拥有了一个属于自己的 HITMAN 暗杀世界。祝暗杀愉快，Agent 47 🐧

【免费下载链接】PeacockThe Peacock Project is a HITMAN™ World of Assassination trilogy server replacement.项目地址: https://gitcode.com/gh_mirrors/pe/Peacock