《盘古战纪》将逆空来袭2DPK巅峰对决

《盘古战纪》逆空来袭2D PPK巅峰对决本地部署实操指南

一、前期工具准备

需安装3个核心工具，直接执行对应命令或下载安装包即可：

• Git：Ubuntu执行sudo apt install git，Mac执行brew install git，Windows从https://git-scm.com/download/win下载安装；
• Node.js 18.x：Linux/Mac执行： ``` curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 18 nvm use 18 ``` Windows用nvm-windows，下载地址：https://github.com/coreybutler/nvm-windows/releases/download/1.1.12/nvm-setup.exe，安装后执行nvm install 18 && nvm use 18；
• npm 8.x：Node.js 18内置，无需单独安装。

禁止直接安装系统自带Node.js，版本不符合要求会导致项目启动失败

二、项目克隆与依赖安装

打开终端（Windows用Git Bash），执行以下命令：

``` git clone https://github.com/open-source-projects/pangu-2d-ppk.git cd pangu-2d-ppk npm install --registry=https://registry.npmmirror.com ```

替换npm源为国内镜像，避免依赖下载超时，等待2-5分钟（依网络情况）完成安装。

三、核心配置修改（必须步骤）

找到项目根目录下的config.js文件，删除原有内容，粘贴以下完整配置：

``` module.exports = { serverPort: 3000, matchMode: "2D_PEK", mapId: "map_001", playerNum: 2, useAntiCheat: true, skillCoolDown: 1000 } ```

禁止修改matchMode字段（触发巅峰对决模式的唯一标识）；禁止修改playerNum，仅支持1v1对战

四、启动本地服务

终端执行命令：

``` npm run dev ```

等待终端输出「Server started at http://localhost:3000」，即服务启动成功。禁止关闭当前终端窗口，否则服务会停止

五、客户端对战测试

打开任意浏览器，访问http://localhost:3000，在两个不同标签页（或窗口）输入相同玩家昵称（系统默认相同昵称匹配为对手），点击「开始匹配」按钮，5秒内自动进入2D PPK巅峰对决场景。

操作键位：WASD移动，J普通攻击，K跳跃，L释放技能，空格键暂停，无额外设置，直接开始对战。

六、常见问题快速排查

• 依赖安装卡住：执行npm cache clean --force后，重新执行步骤二的安装命令；
• 服务启动报错：执行node -v确认版本为18.x，非18.x则执行nvm use 18；
• 无法匹配对手：检查config.js的matchMode是否为「2D_PEK」、playerNum是否为2；
• 按键无反应：点击浏览器地址栏左侧锁形图标，允许网站运行脚本即可。