Home

Welcome to the FantasyConsole Wiki

FantasyConsole is a polymorphic, open-source fantasy virtual machine and integrated development environment (IDE) engineered in pure Rust [SPEC.md]. It safely executes software cart layers matching both PICO-8 (.p8) and TIC-80 (.tic) runtime constraints without infringing on proprietary intellectual property borders.

       +---------------------------------------------+

       |         Command Line Interface (CLI)        |
       +----------------------┬----------------------+
                              │
       +----------------------▼----------------------+

       |                FantasyRuntime               |
       |  +---------------------------------------+  |
       |  |               CartLoader              |  |
       |  +---------------------------------------+  |
       |  |                 LuaVM                 |  |
       |  +---------------------------------------+  |
       |  |            GraphicsRenderer           |  |
       |  +---------------------------------------+  |
       +---------------------------------------------+

🚀 Key Technical Highlights

• Pure Software Rasterization: Every primitive geometry, texture blit, and font layout is computed directly on the CPU stream before flushing to the hardware abstraction layer via an SDL2 surface backend.
• Zero Allocation Physics & Loop Stability: The underlying mlua interface sandbox enforces linear argument consumption to achieve a locked, garbage-collection-safe 60 FPS runtime baseline.
• Memory Protection Isolation: Advanced scissoring boundary logic blocks memory pollution or out-of-bounds heap slicing hazards directly on the rasterization loop.

Navigate through our sidebar menu to examine low-level constraints, specialized API matrix methods, or compilation troubleshooting pathways.