Creating Your Own Game with robos-crpg
A complete engineering masterclass and living documentation section on building, extending, and autonomously verifying party-based tactical isometric cRPGs using Godot 4.3, D&D 5e SRD rules, and the RobOS AI governance harness.
Figure 1: Tactical Isometric RPG Architecture Codex — Complete game loop, party management, combat resolution, and scene portal flow.
Table of contents
1. TOC
Documentation Chapters & Technical Modules
This guide has been expanded into a comprehensive multi-chapter engineering curriculum. Select any module below to dive into code samples, architecture schematics, and implementation standards:
Godot 4 Architecture for Programmers
The mental model for software engineers: SceneTree hierarchy, Node2D, CharacterBody2D, Y-Sort depth pipeline, and persistent autoload singletons.
Scenes, Level Transitions & Door Portals
Structuring location scenes, building two-way DoorPortal components with Area2D, coordinate offsets, and dynamic companion spawning.
2560×1440 Maps & Isometric World Layers
Rendering 2560×1440 plates, applying the Foundation Footprint rule to colliders, camera limit clamping, and two-tier click-to-move pathfinding.
Items, Inventory & D&D 5e Equipment
Zero-hardcoding JSON schemas, GroundItem pickup triggers, container footlockers, and D&D 5e Armor Class (AC) and damage calculations.
Infinity Engine Traps & Hazards System
Concealed traps, Rogue modal Find Traps skill, 2nd-level divination spell sweeps, pulsing red danger outlines, Thieves' Tools disarms, and fumble detonation.
Custom Boss Encounters & Multi-Phase Logic
Building multi-phase boss state machines: cutscenes, Phase 1 combat, 50% HP necrotic invulnerability shields, summoned minion waves, and victory fanfares.
Modding Engine, Manifests & Data Overrides
Zero-code Mod Loader architecture: mod.json manifests, registering custom traps, spells, items, and monsters without modifying core source files.
Automated Cucumber BDD & Xvfb Framebuffers
Headless verification harness: driving Godot via REST (:18090), virtual display :99, 1080p MP4 proof-of-work video recording, and GameState telemetry.
Interactive eLearning & Training Modules
Interested in a hands-on, self-paced curriculum with quizzes, interactive code playgrounds, and a verifiable completion certificate?
- 🎓 cRPG Game Builder & Tactical Engine Academy (Self-Paced Training Module) — 7 modules, practical labs, and interactive knowledge checks covering custom maps, items, traps, boss scripting, and Cucumber BDD.
electron packages/crpg-game-builder-elearning- ⚔️ Tactical cRPG Architecture & Masterclass — Full deep-dive into D&D 5e SRD implementation, Infinity Engine systems, and turn-based tactical combat.
electron packages/robos-crpg-elearningArchitectural Rules & Standards Reference
| Architecture Rule | Implementation Standard | Why It Matters |
|---|---|---|
| **Zero-Hardcoding** | All item, enemy, trap, and dialogue data lives in `data/v1/*.json` or `mods/` | Ensures tests, UI, and Godot stay 100% synchronized without drift. |
| **Layer 1 Colliders** | Place `StaticBody2D` only on physical foundation footprints (bottom 30%) | Allows natural 2.5D depth sorting with `y_sort_enabled = true`. |
| **Camera Limits** | Call `set_camera_limits()` on map load | Prevents revealing black margins outside 2560×1440 plates. |
| **Dual Testing** | Write Normal tests for fast iteration; Full Playthroughs for CI/CD | Guarantees genuine game completability without sacrificing test speed. |
| **Single Responsibility Singletons** | Route state through `GameState`, rolls through `CombatManager` | Prevents tangled scene coupling and makes state injection trivial. |
| **Modular Modding** | Place extensions in `mods/ | Enables community content packs and custom hazards without touching core code. |
| **Technical Documentation Diagrams** | Include Gemini 3.8 AI-generated schematics alongside Mermaid syntax | Ensures documentation is crystal-clear, developer-friendly, and professional without AI bling. |