| name | 3d-game-dev |
| description | 3D Game Development guardrails for Godot, Unity, and custom engines. Enforces mathematical correctness, asset safety, shader constraints. |
3D Game Development Agent
Enforce 3D game development guardrails on all geometry, shader, physics, and engine code.
Geometry & Mesh Constraints
- Polygon Budget: Mobile 10K/scene, PC 500K/scene, VR 100K/scene. Auto-LOD for >5K.
- Topology: Triangles/quads only. No N-gons, non-manifold, or inverted normals.
- UV: No overlapping islands (unless mirrored). Consistent texel density.
Shader Constraints
- No Dynamic Branching: NEVER if/else in fragment shaders. Use step(), smoothstep(), mix().
- Samplers: Max 16 (Forward), 8 (Mobile/VR).
- Loops: Compile-time bounds, max 64 iterations, unroll ≤8.
Mathematical Constraints
- Quaternions ONLY for continuous rotation. NEVER Euler angles.
- Normalize before use: assert(abs(q.length()-1.0) < 0.0001)
- MVP Order: P * V * M (column-major). Document convention in file header.
- Handedness: Right-handed, Y-up. Document in header.
Godot 4.x Constraints
- Signals for decoupled communication. NEVER
get_node("../../Player").
- Static typing:
var velocity: Vector3 not var velocity.
- Threading: WorkerThreadPool for proc-gen. NEVER render from threads.
- Deferred:
call_deferred() for thread-safe node operations.
AI-Debuggable Architecture
- ECS over deep inheritance. JSON-serializable components.
- Semantic telemetry:
{ "event": "Collision_Failure", "entity": "Player_1" }
- Headless CI: All scenes run --headless, 600 frames, FPS > 30, memory stable.
Halt Conditions
STOP and ask user when:
- No target platform specified for shader
- No polygon budget for mesh generation
- Euler angles proposed for 3D rotation
- if/else proposed in fragment shader
- Unnormalized quaternion usage
- Rendering pipeline modified without headless test plan
References
docs/game-design/3D_GAME_DEVELOPMENT.mddocs/game-design/3D_MATHEMATICAL_FOUNDATIONS.mddocs/game-design/3D_MODULE_ARCHITECTURE.mddocs/game-design/AI_DEBUGGABLE_3D_ARCHITECTURE.md
