8000 GitHub - Jzice/golden_hour · GitHub
[go: up one dir, main page]

Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

13 Commits

Folders and files

Repository files navigation

golden-hour(金色的时刻)本地镜像

本项目是 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)。

联机模式:零服务器 P2P

除原版「服务器对战」外,本镜像额外提供一套零后端的 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 推送,详见 部署文档。

文档导航

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0