xt4d/gameblocks

GameBlocks is a library of small, clearly written code building blocks meant to help AI coding agents build browser based 3D game prototypes. Rather than being a game engine or a finished game, it is a set of concise, self explanatory modules that an agent can copy, adapt, and learn from while implementing tricky 3D systems such as coordinate frames, how characters move, and how a game world is structured. The project exists because plain language is a weak way to describe precise 3D behavior. When an AI agent has to turn a written instruction into spatial logic like movement directions or camera angles, small misunderstandings can flip directions, cause shaky motion, or leave the visible game out of sync with its internal state. GameBlocks aims to reduce that problem by giving agents working examples with clear, inspectable logic to generalize from, instead of asking them to invent 3D behavior from a blank page. The author frames this as one piece of a larger idea: as separate AI models increasingly handle the visual rendering of game worlds, something still needs to track and update the underlying interactive state, such as positions, physics, and rules. GameBlocks is meant to be that structured state layer, working alongside whatever renders the graphics. It is installed as a local skill for coding agents. For Codex or Claude Code, someone clones the repository, copies the gameblocks folder into the agent's skills directory with a short shell command, and then either types a command like slash gameblocks to invoke it directly or lets the agent load it automatically when a task looks like browser based 3D game development. The README links to sixteen playable browser games built using GameBlocks, covering genres like archery, dogfighting, tower defense, and voxel survival, along with a short gameplay video. The project is released under the MIT license.