McRogueFace Project History

A chronological record of McRogueFace development from inception to present.

Table of contents

1. Origins (February 2023)
2. Foundation Year (2024)
   1. Q1 2024: 7DRL Game Jam
   2. Q2-Q3 2024
   3. Q4 2024: Roguelike Tutorial Implementation
3. Recent Development (Last 6 Months)
   1. December 2025
   2. January 2026 (Current Month)
4. Version History
5. Features Completed (vs Original Roadmap)
6. Development Philosophy Evolution
   1. What Was Deferred
   2. What Was Abandoned
7. Contributing to History

Origins (February 2023)

McRogueFace began as an experimental proof-of-concept combining SFML graphics with embedded Python and libtcod roguelike utilities.

Initial Commit: February 23, 2023

• Combined rendering proof-of-concept
• Linux-only, experimental architecture

Foundation Year (2024)

Q1 2024: 7DRL Game Jam

The 7-Day Roguelike Challenge 2024 transformed McRogueFace from experiment to engine.

February 2024:

• Major refactor to Python 3.12
• CMake build system
• libtcod and SFML built from source

March 2024 (7DRL Week):

• UIGrid tilemap rendering
• Entity system implementation
• Scene switching API
• Mouse and keyboard input
• Timer system
• Caption text rendering
• Window scaling
• Crypt of Sokoban - first complete game built with McRogueFace

Post-7DRL Stabilization:

• RAII memory management for Python objects
• Standardized handling: Texture, Color, Vector, Font

Q2-Q3 2024

Incremental improvements and API refinement between jam events.

Q4 2024: Roguelike Tutorial Implementation

October 2024:

• Complete API reference documentation
• Tutorial Python implementations (Parts 0-6)
• Documentation macro system (MCRF_* macros)
• Profiling system with F3 overlay
• Headless mode with --headless --exec

November 2024:

• Python 3.14 migration
• UI hierarchy foundations (parent/child relationships)
• Drawing primitives: UILine, UICircle, UIArc
• Geometry module for orbital mechanics
• Grid layer system with dirty flags
• Chunk-based rendering for large grids
• RenderTexture caching
• Developer console (ImGui overlay)
• Self-contained venv support for pip packages
• libtcod-headless fork integration

Recent Development (Last 6 Months)

December 2025

Performance & Architecture:

• EntityCollection iterator optimization: O(n²) → O(n), 100× speedup
• SpatialHash for O(1) entity spatial queries
• Animation property locking (prevents conflicts)
• Benchmark extended to 5000 entities

API Improvements:

• Scene API with module-level properties
• click → on_click rename for consistency
• Sound/Music classes
• Keyboard state queries
• Version info exposure

Research Features:

• TurnOrchestrator for multi-turn LLM simulation
• Action parser/executor for LLM agents
• WorldGraph for deterministic room descriptions
• VLLM integration demos

Quality of Life:

• mcrfpy.step() for synchronous headless execution
• Grid camera defaults and center_camera() method
• 14-part tutorial Python files

January 2026 (Current Month)

Week 1 (Jan 1-5):

• Timer refactor: stopwatch semantics, mcrfpy.timers collection
• Scene transitions via Scene object
• Animation fixes (0-duration edge case, integer values)
• Easing functions as enum
• .animate helper method
• Vector improvements (indexing, tuple comparison, floor)
• Position handling: always mcrfpy.Vector, accepts tuples/iterables

Week 2 (Jan 6-10):

• Code editor window with lockable positions
• mcrfpy.Mouse class (symmetry with mcrfpy.Keyboard)
• Timer background execution
• Scene object as Python parent support
• Grid.at() segfault fix
• Windows build (mingw cross-compilation)
• Version bump: 0.2.1-prerelease-7drl2026
• Input enums (replacing strings)
• Pathfinding separation: A* and Dijkstra

Week 3 (Jan 11-14):

• HeightMap system - complete procedural generation toolkit:
  • Core class with scalar operations
  • Query methods, threshold operations
  • Terrain generation (dig_hill, dig_bezier)
  • Kernel transforms, combination operations
  • Noise algorithms with parameters
• BSP (Binary Space Partitioning):
  • Procedural dungeon generation
  • Room adjacency graphs
  • Safety features and API improvements
• Dijkstra-to-HeightMap conversion
• Alignment system - reactive UI positioning
• Test suite modernization with pytest and mcrfpy.step() pattern

Version History

Features Completed (vs Original Roadmap)

The following features from the original roadmap are now complete:

• ✅ Pathfinding API - A* and Dijkstra with HeightMap integration
• ✅ Animation System - Property animations with easing, callbacks, locking
• ✅ Performance Profiler - F3 overlay, benchmark logging, dirty flags
• ✅ Debug Console - ImGui-based Python REPL overlay
• ✅ FOV System - Thread-safe with configurable algorithms

Development Philosophy Evolution

From the Strategic Direction wiki:

“Fix foundation systems before expanding features.”

The project evolved from feature-focused development to a foundation-first approach:

1. Target Audience: Beginners, game jam participants, researchers
2. Core Principle: “Batteries included but removable”
3. v1.0 Criteria: Performance, stability, and documentation—not feature count

What Was Deferred

Per strategic direction, these are intentionally deferred until after v1.0:

• Python wheel packaging
• Shader support
• Particle systems
• Multi-window support

What Was Abandoned

These ambitious features were deemed misaligned with the beginner-focused mission:

• Living world MMO features
• Full ECS rewrites
• 50,000-tile ecosystems

Contributing to History

This document is maintained by the GoblinCorps team. For corrections or additions, please file an issue at the GoblinCorps fork.