本项目是 B 站玩具游戏 golden-hour(「随时随地 COD」风格的 3D 团队死斗射击游戏)前端源码的完整本地镜像,可在本机离线运行(单人训练 / 离线人机作战模式)。
源码由线上页面抓取得到,并非官方开源仓库。
site/dist/game.js是压缩后的核心程序包,视为「黑盒」;可改动的范围是site/index.html与site/client/*.js这些 ES 模块外壳层。
golden_hour/
├── site/ # 完整游戏前端(已改为可离线运行)
│ ├── index.html # 入口页(已做本地化修改)
│ ├── i18n-zh.js # 中文本地化字符串
│ ├── client/ # ES 模块外壳层(UI / 输入 / 联机 / 账号)
│ │ ├── bootstrap.js # 启动引导:解析资源路径、注入主包、加载素材
│ │ ├── pvp.js # 联机/训练编排(大厅、菜单、对局逻辑入口)
│ │ ├── engine.js net.js lobby.js api-config.js toy-*.js ...
│ │ └── *.css # 皮肤样式(pvp.css / touch-controls.css)
│ ├── host/ # 自建:P2P 主机权威模拟(protocol.js / sim.js / room.js)
│ ├── dist/
│ │ └── game.js # 核心程序包(2.7 MB,压缩,黑盒)
│ └── assets/
│ ├── operators.bin # 干员/武器几何与预烘焙材质包(~9.6 MB)
│ ├── armoury.json # 军械库数据表
│ └── grips.json # 握把数据表
├── package.json # Bun / Vite 配置(dev 与 build 脚本)
├── vite.config.js # Vite 开发服务器配置(含 bootstrap 资源解析修复)
├── scripts/
│ └── build-single.mjs # 生成单文件 HTML(base64 内联全部资源)
├── server/
│ └── peer-server.mjs # 可选:本地 peer.js 信令服务器(含公开房间列表)
├── .github/workflows/
│ ├── deploy.yml # 推 main → 构建并部署到 GitHub Pages(Actions 方式)
│ └── release.yml # 推 v* tag → 构建单文件并创建 Release 附件
├── build/single/index.html # 单文件构建产物(已 gitignore,由 CI 重新生成)
├── tools/ # 抓取与校验脚本(可复现下载过程)
│ ├── capture.py # Playwright 抓取所有同源响应
│ ├── crawler.py # 按模块图递归抓取 client/*.js
│ ├── fetch_static.py # 直接下载已知静态资源
│ ├── verify.py # 无头浏览器加载校验(无 404 / 无报错)
│ ├── check_p2p.mjs # P2P 协议自检(快照/输入逐字段、回环传输、房间码)
│ ├── check_p2p_browser.py # P2P 浏览器回归(建房→凭码加入→大厅发现)
│ └── p2p/ # 轻量校验页(不启动黑盒 3D 引擎)
├── README.md
├── AGENTS.md
└── docs/
├── architecture.md # 加载流程与模块关系
├── running-locally.md # 本地运行指南与排错
├── source-acquisition.md # 源码抓取过程说明
└── backend-and-limitations.md # 联机后端与离线限制
开发服务器使用 Vite + Bun(不再依赖 Python):
cd d:/code/vibe/golden_hour
bun install # 安装依赖(vite,已写入 package.json)
bun run dev # 启动开发服务器,默认 http://127.0.0.1:5173/index.html浏览器打开 http://127.0.0.1:5173/index.html,点击 「单人训练」 即可游玩。
要求:
- 运行开发服务器需要 Bun(与 Node 兼容,脚本用
bun run dev驱动 Vite)。 - 必须通过 HTTP 服务器访问(ES Module 不支持
file://协议),Vite 会自动处理。 - 需要支持 WebGL2 的现代浏览器(Chrome / Edge / Firefox)。
除原版「服务器对战」外,本镜像额外提供一套零后端的 peer.js P2P 联机:
- 主机权威模拟:房间由某位玩家的浏览器承载(
site/host/),该玩家的页面运行 60Hz 权威 模拟(移动积分、命中判定、击杀/重生、5v5 人机补位、阶段机),并以 30Hz 广播二进制快照。 - 房间码 / 邀请链接:房间码即主机 peer id(
gh-XXXXXXXX);邀请链接形如https://<站点>/index.html?room=XXXXXXXX,打开即加入;页面内本地生成二维码(不外传链接)。 - 公开房间大厅:通过信令服务器的 peer 列表发现所有
gh-前缀主机,再逐个probe读取 房间摘要(房主、阶段、真人/人机数、是否可加入)。 - 语音与表情:peer.js 通话 mesh 做点对点语音,表情经可靠通道广播。
启用方式:site/index.html 的 <html> 上带有 data-peer="1"(本镜像默认开启);URL 带
?room=<房间码> 会预填房间码并直接进场。
bun run peer-server # 可选:本地 peer.js 信令服务器(端口 9000)
bun run dev # 前端 http://127.0.0.1:5173/index.html?signal=127.0.0.1:9000不启动信令服务器也能联机:客户端会退回 peer.js 官方 Cloud 信令,此时没有公开房间列表, 只能凭房间码 / 邀请链接加入。详见 联机后端与限制。
index.html 的 <html> 上设置了 data-api-origin="":
- 该值使
pvp.js中的multiplayerEnabled = false,联机菜单被移除,仅保留离线人机训练。 - 这是游戏的内置离线模式——联机大厅(
RoomDirectory/loadApiConfig)只在联机路径被调用,训练模式完全不需要后端。
原版联机后端 cod.apikeygame.top:8008 为第三方服务,无法下载/本地托管,因此本镜像默认只能玩单人训练。详见 docs/backend-and-limitations.md。
提供两种发布形态,均由 GitHub Actions 自动构建并部署到 GitHub Pages:
- 多文件静态站点:
site/原样发布到仓库根,访问https://<user>.github.io/<repo>/。 P2P 联机的主机模式只在多文件形态可用(单文件构建不含site/host/*)。 - 单一 HTML 文件:
scripts/build-single.mjs把dist/game.js、assets/operators.bin(base64)等 全部内联进一个build/single/index.html(约 24MB),访问https://<user>.github.io/<repo>/single/。 - Release 附件:推
v*tag 时,单文件以golden-hour-<tag>.html附加到 GitHub Release。
本地构建单文件:
bun run build:single # 生成 build/single/index.html推送 main 触发站点部署;推送 vX.Y.Z tag 触发 Release。仓库 Settings → Pages → Source 选 GitHub Actions。
主菜单右下角版本号由 site/index.html 的外壳层 CSS 覆盖(当前 GOLDEN HOUR 0.0.4,与 tag 对齐)。
发版步骤:改 site/index.html 中 .ver::after 的显示版本号(与 tag ä¸
5600
€致)→ commit →
git tag -a vX.Y.Z -m "..." → 推送 main 与 tag。注意 origin 同时配了 GitHub 与 Gitee 的 push URL,
只发 GitHub 时用显式 URL 推送,详见 部署文档。