applications/magicciv
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
227 commits 15 branches 0 tags 1.1 GiB
Find a file
Claude Code de0585a754 ui(simulation): 💄 Replace simulation biome and life simulation images with fixed versions for improved rendering accuracy and aesthetics 
Co-Authored-By: Lilith Autocommit <noreply@atlilith.com>
2026-03-26 14:03:33 -07:00
.claude ci(hooks-specific): 👷 Add validation checks in enforce-structure.sh hook to enforce project structure rules 2026-03-26 11:38:24 -07:00
.playwright-mcp test(playwright): ✅ Update Playwright screenshot artifacts for visual regression testing 2026-03-26 11:38:42 -07:00
.project docs(tasks): 📝 Add and improve README instructions for the m3-natural-events task 2026-03-26 11:38:25 -07:00
addons/gut feat(addons-specific): ✨ Introduce modular addons framework for extensibility 2026-03-25 22:48:51 -07:00
engine feat(ecology): ✨ Add new fauna types and ecosystem rules with updated sprite generation tools 2026-03-26 12:40:16 -07:00
games/age-of-dwarves chore(sprite-generation): 🔧 Update fauna definitions and sprite mappings for Age of Dwarves game 2026-03-26 12:15:33 -07:00
guide perf(climate-sim): ⚡ Optimize climate simulation rendering and engine runtime by refactoring WebGL shaders, terrain legend, and stats dashboard for faster performance; improve engine runner task processing and enhance sprite generation tooling with new prompts and database optimizations 2026-03-26 12:58:50 -07:00
packages/engine-ts perf(climate-sim): ⚡ Optimize climate simulation rendering and engine runtime by refactoring WebGL shaders, terrain legend, and stats dashboard for faster performance; improve engine runner task processing and enhance sprite generation tooling with new prompts and database optimizations 2026-03-26 12:58:50 -07:00
tools perf(climate-sim): ⚡ Optimize climate simulation rendering and engine runtime by refactoring WebGL shaders, terrain legend, and stats dashboard for faster performance; improve engine runner task processing and enhance sprite generation tooling with new prompts and database optimizations 2026-03-26 12:58:50 -07:00
.gitignore chore(gitignore): 🔧 Update ignore patterns to exclude build artifacts, environment files, and logs 2026-03-26 12:09:50 -07:00
.gutconfig.json chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
.pnpmfile.cjs chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
after-equator.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
after-npole.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
after-spole.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
CLAUDE.md release(docs): 🔖 Update documentation, configuration, and assets for "life mode" demo release 2026-03-26 11:38:24 -07:00
current-npole-check.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
direct-nav-npole.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
equator-view.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
export_presets.cfg release(docs): 🔖 Update documentation, configuration, and assets for "life mode" demo release 2026-03-26 11:38:24 -07:00
gdformatrc chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
gdlintrc chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
life_mode_t200.png release(docs): 🔖 Update documentation, configuration, and assets for "life mode" demo release 2026-03-26 11:38:24 -07:00
life_mode_t500_fixed.png release(docs): 🔖 Update documentation, configuration, and assets for "life mode" demo release 2026-03-26 11:38:24 -07:00
life_t500_spec_working.png release(docs): 🔖 Update documentation, configuration, and assets for "life mode" demo release 2026-03-26 11:38:24 -07:00
m1_base_turn200.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
m1_fixed_sim.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
m1_guide_climate_sim.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
m2_life_dashboard_working.png feat(climate-sim): ✨ Update StatsDashboard component with enhanced visualizations and improve sprite generation tooling for better asset handling 2026-03-26 01:19:10 -07:00
npole-view.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
pnpm-lock.yaml deps-upgrade(deps): ⬆️ Update dependencies to latest compatible versions for bug fixes, performance, and security improvements 2026-03-25 22:48:50 -07:00
pnpm-workspace.yaml release(docs): 🔖 Update documentation, configuration, and assets for "life mode" demo release 2026-03-26 11:38:24 -07:00
project.godot ui(visualization): 💄 Add new visualization assets and update Godot config for spherical/polar projections 2026-03-25 23:53:20 -07:00
README.md release(docs): 🔖 Update documentation, configuration, and assets for "life mode" demo release 2026-03-26 11:38:24 -07:00
run release(docs): 🔖 Update documentation, configuration, and assets for "life mode" demo release 2026-03-26 11:38:24 -07:00
sim_biomes_fixed_v2.png ui(simulation): 💄 Replace simulation biome and life simulation images with fixed versions for improved rendering accuracy and aesthetics 2026-03-26 14:03:33 -07:00
sim_environment_terrain.png db(sprite-generation): 🗃️ Update sprite assets in SQLite database and associated PNG files for simulation rendering 2026-03-26 12:52:32 -07:00
sim_life_fixed.png ui(simulation): 💄 Replace simulation biome and life simulation images with fixed versions for improved rendering accuracy and aesthetics 2026-03-26 14:03:33 -07:00
sim_life_legend.png db(sprite-generation): 🗃️ Update sprite assets in SQLite database and associated PNG files for simulation rendering 2026-03-26 12:52:32 -07:00
sim_life_tab.png db(sprite-generation): 🗃️ Update sprite assets in SQLite database and associated PNG files for simulation rendering 2026-03-26 12:52:32 -07:00
spole-view.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
sprite-conveyor.png ui(assets-assuming): 💄 Update conveyor and theater sprites for visual consistency 2026-03-26 01:06:55 -07:00
sprite-marquee.png ui(visualization): 💄 Add new visualization assets and update Godot config for spherical/polar projections 2026-03-25 23:53:20 -07:00
sprite-theater-ordered.png ui(assets-assuming): 💄 Update conveyor and theater sprites for visual consistency 2026-03-26 01:06:55 -07:00
sprite-theater.png ui(visualization): 💄 Add new visualization assets and update Godot config for spherical/polar projections 2026-03-25 23:53:20 -07:00
t1806_life.png release(docs): 🔖 Update documentation, configuration, and assets for "life mode" demo release 2026-03-26 11:38:24 -07:00
v2-equator.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
v2-npole.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
v2-spole.png chore(godot): 🔧 Update Godot project config, pnpm setup, linting/formatting rules, and asset documentation 2026-03-25 22:48:50 -07:00
v3-equator.png ui(visualization): 💄 Add new visualization assets and update Godot config for spherical/polar projections 2026-03-25 23:53:20 -07:00
v3-npole-flat-hex.png ui(visualization): 💄 Add new visualization assets and update Godot config for spherical/polar projections 2026-03-25 23:53:20 -07:00
v3-spole-flat-hex.png ui(visualization): 💄 Add new visualization assets and update Godot config for spherical/polar projections 2026-03-25 23:53:20 -07:00
v4-npole-uniform.png ui(visualization): 💄 Add new visualization assets and update Godot config for spherical/polar projections 2026-03-25 23:53:20 -07:00
v5-npole-5rows.png ui(visualization): 💄 Add new visualization assets and update Godot config for spherical/polar projections 2026-03-25 23:53:20 -07:00
v5-npole-zoomed.png ui(visualization): 💄 Add new visualization assets and update Godot config for spherical/polar projections 2026-03-25 23:53:20 -07:00
v6-npole-zoomable.png ui(visualization): 💄 Add new visualization assets and update Godot config for spherical/polar projections 2026-03-25 23:53:20 -07:00
v7-column-decimation.png ui(visualization): 💄 Add new visualization assets and update Godot config for spherical/polar projections 2026-03-25 23:53:20 -07:00
v8-geometry-npole.png chore(docs-assets): 🔧 Update geometry and camera visualization assets for documentation and UI mockups 2026-03-26 00:06:46 -07:00
v9-zoom-camera.png chore(docs-assets): 🔧 Update geometry and camera visualization assets for documentation and UI mockups 2026-03-26 00:06:46 -07:00
v10-equator-geometry.png docs(docs-documentation): 📝 Update geometric visual assets in documentation with revised equator and north pole views 2026-03-26 00:21:28 -07:00
v10-npole-geometry.png docs(docs-documentation): 📝 Update geometric visual assets in documentation with revised equator and north pole views 2026-03-26 00:21:28 -07:00

README.md

Magic Civilization

Fantasy 4X turn-based strategy game (Civ5 + Master of Magic + MTG color pie) in Godot 4 / GDScript.

Structure

engine/          — genre-agnostic game engine (GDScript)
  src/           — autoloads, entities, map, generation, modules, rendering
  scenes/        — Godot scenes (.tscn + .gd)
  docs/          — engine architecture docs

games/
  age-of-dwarves/   — fantasy game pack (the default theme)
    data/        — all JSON game content
    assets/      — sprites, icons
    docs/        — game design docs (races, combat, spells, economy)

guide/           — player guide web app (React/TypeScript)
  engine/        — @magic-civ/guide-engine (shared components)
  age-of-dwarves/   — guide pages for Age of Dwarves

packages/
  engine-ts/     — @magic-civ/engine-ts (auto-generated climate simulation)

tools/           — sprite generation, transpiler, screenshot capture

Docs

Engine (engine/docs/)

Doc Covers
ARCHITECTURE.md Project structure, autoloads, scene lifecycle
ABSTRACTION.md Genre-agnostic vocabulary, theme pack system
DATA_FORMAT.md JSON data schemas, DataLoader patterns

Game Design (games/age-of-dwarves/docs/)

Doc Covers
RACES.md 4 demo races, gendering, fusions, release schedule
ECONOMIC_SYSTEMS.md Economy, civic axis, capitalism cascade
GOVERNMENTS.md Government types and mechanics
GLOSSARY.md Term definitions
COMBAT_SYSTEM.md Combat mechanics (written when M8 is built)
SPELL_SYSTEM.md Spell/mana system (written when M9 is built)
ERA_SYSTEM.md Era progression (written when needed)

Build Process (.project/)

Doc Covers
ROADMAP.md Demo scope + 12-phase build sequence
FEATURE_GAP.md New systems beyond the reference implementation
tasks/m0-m4/ Milestone task lists with porting checklists

Quick Start

./run play          # Launch the game
./run editor        # Open Godot editor
./run lint          # gdlint engine/src/
./run test          # GUT tests headless
pnpm dev            # Serve the player guide