别再让AI手搓3D引擎：GameBlocks把游戏系统拆成74块

📝

GameBlocks 不是传统游戏引擎，而是面向 Codex、Claude Code 的本地 Skill，包含 74 个浏览器 3D 游戏 ES Module 和 16 个可玩 Demo，让 AI 不再重推空间数学。

核心问题

只靠提示词让智能体写 3D 游戏，最先坏掉的常不是画面，而是方向：前后轴颠倒、相机与角色不同步、碰撞坐标和屏幕所见不一致。GameBlocks 不让 Agent 重推空间数学，而是给它可阅读、复制、改造的实现。

这不是”装完就能做游戏”的引擎，也不是 npm 组件库——而是面向 Codex、Claude Code 的本地 Skill，加上 74 个浏览器 3D 游戏 ES Module。仓库以 16 个可玩 Demo 展示射击、飞行、竞速、塔防、解谜等用途。

层级	功能
Math	统一空间语义，右手坐标系，WorldBasis 坐标真相源
Actor Motion	输入→运动意图，角色/车辆/飞行器/蛇形移动控制
Behavior	可组合 AI：网格规划器、路径导航器、WaypointDriver、战斗行为导演
Gameplay	规则状态机：CombatPlay、FlightPlay、RaceCheckpointLapPlay、SnakePlay、WaveSpawnDirector
Camera & UI	四种相机 Rig、DOM HUD 数据绑定、小地图投影、航向相对雷达、飞行座舱 HUD
World	Arena/自然环境/赛道/棋盘环境生成，Rapier 碰撞，地形采样器，出生区域采样
Object/Factory/Effects	弹体、补给、HP 栏、特效、对象池，`disposeObject3D` 递归释放资源

1	input → planMovement → resolver → commitMovement → model/camera/UI

控制器先计算”想移动多少”，不直接假定它真的移动；多个角色把 intent 排入 KinematicBatchResolver，由 Rapier 角色控制器统一处理自动踏阶、坡度、贴地、碰撞过滤和 grounded 查询，再把 resolved movement 提交回权威状态。

这解决了常见的”三份真相”：逻辑位置、物理刚体、Three.js 模型各自更新。模型、Camera 和 HUD 只读提交后的状态。

1
2
3

git clone https://github.com/xt4d/GameBlocks.git
cd GameBlocks
mkdir -p ~/.codex/skills/gameblocks

Claude Code 用户只需把目标目录改为 ~/.claude/skills/gameblocks。

本文转载自微信公众号「小K」。