# GameBlocks

**Repository Path**: xuegoo_admin/GameBlocks

## Basic Information

- **Project Name**: GameBlocks
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-29
- **Last Updated**: 2026-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![GameBlocks preview](assets/logo.jpg)

## 📖 Introduction

### What Is GameBlocks

GameBlocks helps coding agents build browser-based 3D game prototypes.

GameBlocks provides **building-block code**: concise and self-explanatory modules designed for agents to compose, adapt, and generalize from while implementing fragile 3D game systems such as coordinate frames, actor motion, and world structure.

### Why GameBlocks

Natural language is a weak interface for precise 3D behavior. Prompts and agent reasoning must compress spatial transformations into language tokens. Small ambiguities can cause inverted directions, unstable motion, or gameplay state that no longer matches what appears on screen.

GameBlocks reduces that difficulty by turning fragile 3D and gameplay patterns into inspectable implementations with clear semantics. Instead of deriving 3D behavior from scratch, agents can generalize from GameBlocks to build spatially accurate 3D games.

### For Stateful Generative Worlds

GameBlocks focuses on the stateful layer of a world rather than visual aesthetics. The vision is that [world-rendering models](https://www.worldlabs.ai/blog/taxonomy-of-world-models) will increasingly lift the burden of visual generation.

In that future, GameBlocks provides the structured interactive state that those models can render from, update, and keep consistent as agents and players act inside the world.

References: [Moonlake](https://moonlakeai.com/blog/why-world-models-need-structure-not-just-scale), [Game Cartridges](https://x.com/AlbyHojel/status/2057193508822536459), [Project Eden](https://www.tripo3d.ai/research/project-eden).


## 🤖 Use in Agents

GameBlocks can be used as a local skill so a coding agent can discover it when a task involves browser-based 3D game development.

### Codex

1. Clone the repository locally.

2. Run this command from the repository root (to copy `gameblocks` to the skills folder):
```bash
mkdir -p ~/.codex/skills/gameblocks && cp -R gameblocks/. ~/.codex/skills/gameblocks/
```
3. Restart the Codex app (optional).

4. In the Codex chatbox, invoke the skill by typing `/gameblocks` or `$gameblocks`, or let it load automatically when the task matches the skill description.

### Claude Code

1. Clone the repository locally.

2. Run this command from the repository root (to copy `gameblocks` to the skills folder):
```bash
mkdir -p ~/.claude/skills/gameblocks && cp -R gameblocks/. ~/.claude/skills/gameblocks/
```
3. Restart the Claude app (optional).

4. In the Claude Code chatbox, invoke the skill by typing `/gameblocks`, or let it load automatically when the task matches the skill description.

## 🎬 Demo

### Playable Games

| Preview | Title | Link |
| --- | --- | --- |
| <a href="https://gb-archery-hunting.vercel.app/"><img src="assets/previews/archery-hunting.jpg" alt="Archery hunting" width="160"></a> | **Archery Hunting** | [https://gb-archery-hunting.vercel.app/](https://gb-archery-hunting.vercel.app/) |
| <a href="https://gb-jet-dogfight.vercel.app/"><img src="assets/previews/jet-dogfight.jpg" alt="Jet dogfight" width="160"></a> | **Jet Dogfight** | [https://gb-jet-dogfight.vercel.app/](https://gb-jet-dogfight.vercel.app/) |
| <a href="https://gb-desert-shooter.vercel.app/"><img src="assets/previews/desert-shooter.jpg" alt="Desert shooter" width="160"></a> | **Desert Shooter** | [https://gb-desert-shooter.vercel.app/](https://gb-desert-shooter.vercel.app/) |
| <a href="https://gb-marble-puzzle.vercel.app/"><img src="assets/previews/marble-puzzle.jpg" alt="Marble puzzle" width="160"></a> | **Marble Puzzle** | [https://gb-marble-puzzle.vercel.app/](https://gb-marble-puzzle.vercel.app/) |
| <a href="https://gb-pirate-seas.vercel.app/"><img src="assets/previews/pirate-seas.jpg" alt="Pirate seas" width="160"></a> | **Pirate Seas** | [https://gb-pirate-seas.vercel.app/](https://gb-pirate-seas.vercel.app/) |
| <a href="https://gb-snake-clash.vercel.app/"><img src="assets/previews/snake-clash.jpg" alt="Snake Clash" width="160"></a> | **Snake Clash** | [https://gb-snake-clash.vercel.app/](https://gb-snake-clash.vercel.app/) |
| <a href="https://gb-space-shooter.vercel.app/"><img src="assets/previews/space-shooter.jpg" alt="Space shooter" width="160"></a> | **Space Shooter** | [https://gb-space-shooter.vercel.app/](https://gb-space-shooter.vercel.app/) |
| <a href="https://gb-submarine-exploration.vercel.app/"><img src="assets/previews/submarine-exploration.jpg" alt="Submarine exploration" width="160"></a> | **Submarine Exploration** | [https://gb-submarine-exploration.vercel.app/](https://gb-submarine-exploration.vercel.app/) |
| <a href="https://gb-endless-runner.vercel.app/"><img src="assets/previews/endless-runner.jpg" alt="Endless runner" width="160"></a> | **Endless Runner** | [https://gb-endless-runner.vercel.app/](https://gb-endless-runner.vercel.app/) |
| <a href="https://gb-voxel-survival.vercel.app/"><img src="assets/previews/voxel-survival.jpg" alt="Voxel survival" width="160"></a> | **Voxel Survival** | [https://gb-voxel-survival.vercel.app/](https://gb-voxel-survival.vercel.app/) |
| <a href="https://gb-robotic-arm.vercel.app/"><img src="assets/previews/robotic-arm.jpg" alt="Robotic arm" width="160"></a> | **Robotic Arm** | [https://gb-robotic-arm.vercel.app/](https://gb-robotic-arm.vercel.app/) |
| <a href="https://gb-castle-defense.vercel.app/"><img src="assets/previews/castle-defense.jpg" alt="Castle defense" width="160"></a> | **Castle Defense** | [https://gb-castle-defense.vercel.app/](https://gb-castle-defense.vercel.app/) |
| <a href="https://gb-tower-defense.vercel.app/"><img src="assets/previews/tower-defense.jpg" alt="Tower defense" width="160"></a> | **Tower Defense** | [https://gb-tower-defense.vercel.app/](https://gb-tower-defense.vercel.app/) |
| <a href="https://gb-mech-arena.vercel.app/"><img src="assets/previews/mech-arena.jpg" alt="Mech arena" width="160"></a> | **Mech Arena** | [https://gb-mech-arena.vercel.app/](https://gb-mech-arena.vercel.app/) |
| <a href="https://gb-drone-delivery.vercel.app/"><img src="assets/previews/drone-delivery.jpg" alt="Drone delivery" width="160"></a> | **Drone Delivery** | [https://gb-drone-delivery.vercel.app/](https://gb-drone-delivery.vercel.app/) |
| <a href="https://gb-moon-racing.vercel.app/"><img src="assets/previews/moon-racing.jpg" alt="Moon racing" width="160"></a> | **Moon Racing** | [https://gb-moon-racing.vercel.app/](https://gb-moon-racing.vercel.app/) |

### Gameplay Video

https://github.com/user-attachments/assets/98d22d80-06b6-49ac-8b33-2215ccb42222


## 📜 License

GameBlocks is released under the [MIT License](LICENSE).