开源 · MIT · 零构建 · 原生 ESM

浏览器 3D 游戏的积木代码

74 个简洁、自解释的模块,覆盖坐标系、角色运动、相机机位、玩法状态与世界构建——供编码代理组合、改写、举一反三,而不必从零推导脆弱的 3D 行为。

↑ 这条蛇由真实模块 SnakeMotionController + SnakePlay 驱动 · AI 自动游玩
74模块
7类别
3依赖档位
MIT许可

为什么用 GameBox

自然语言对精确的 3D 行为是薄弱接口:提示词把空间变换压成语言 token,微小歧义就会导致方向反转、运动不稳,或让游戏状态与画面不再一致。

GameBox 把脆弱的 3D 与玩法模式转成语义清晰、可检视的实现。代理无需从零推导,而是从这些积木举一反三,构建空间精确的 3D 游戏。

三档依赖 · 按需取用

纯逻辑

零依赖,纯 JS 数据结构,可直接在浏览器里跑。

three

仅依赖 three.js,加载即可渲染。

three + Rapier

需 three,并在运行时注入 Rapier 物理世界。

7 大类 · 74 模块

按能力分组浏览,每个模块都标注依赖档位与相对路径。

如何使用

GameBox 是「源材料」,不是要装的框架——挑你要的模块复制进项目,保留相对目录结构即可。

1

以 WorldBasis 为地基

用 modules/math/WorldBasis.js 作为玩法空间坐标(前/右/上轴、平面移动、朝向、控制变换)的唯一真理来源。

2

从目录里选模块

浏览目录,优先复用现有模块,尤其是运动控制器和相机机位。

3

保留结构复制进项目

把选中的模块按相对目录结构复制进你的源码目录,import 才不会断;完全满足就原样用,部分满足就在其上改,不要从头重写。

4

记录用法

创建 gamebox_usage.md 记录所选模块、用途、复用/改写状态、关键改动与集成方式。

安装为本地 skill

把 gamebox 复制进你的编码代理 skills 目录,当任务涉及浏览器 3D 游戏开发时便会自动发现它。

Codex
  1. 克隆仓库到本地
    git clone https://github.com/shushuitie2017/GameBox
  2. 复制到 skills 目录
    mkdir -p ~/.codex/skills/gamebox && cp -R gamebox/. ~/.codex/skills/gamebox/
  3. 调用

    在 Codex 输入框键入 /gamebox 或 $gamebox,或让它在任务匹配时自动加载。

Claude Code
  1. 克隆仓库到本地
    git clone https://github.com/shushuitie2017/GameBox
  2. 复制到 skills 目录
    mkdir -p ~/.claude/skills/gamebox && cp -R gamebox/. ~/.claude/skills/gamebox/
  3. 调用

    在 Claude Code 输入框键入 /gamebox,或让它在任务匹配时自动加载。

社群

扫码加入 GameBox 开源社群,一起交流。

社群

微信群二维码有时效,若已失效,请到 GitHub Issues 留言获取最新入群方式。