Library

A gallery of runnable examples for McRogueFace: bite-sized playground snippets, full engine demo screens, and games. Snippet links open the code straight in the playground; demo/game source links are pinned to a specific commit.

_{Short snippets carry their source inline in the link; longer ones load the raw file pinned to engine 77dd0fc (jmccardle/McRogueFace). Demos/games pinned to engine 0.2.8. Generated by tools/build_library.py.}

Playground Snippets

282 focused, copy-paste examples covering the whole mcrfpy API. Each snippet fills the 1024x768 playground canvas.

Open in Playground opens the exact code shown here in the playground — press Run (Ctrl+Enter). Short snippets travel inline in the URL (LZString-compressed #src=); longer ones load the raw file from the pinned commit (#url=). No copy-paste either way.

Hello

Snippet	Preview	Source
Hello Frame Hello Frame - The simplest UI element		▶ Open in Playground
Hello Caption Hello Caption - Display text on screen		▶ Open in Playground
Hello Sprite Hello Sprite - Display a textured sprite		▶ Open in Playground
Hello Grid Hello Grid - Create a tile-based grid		▶ Open in Playground
Hello Entity Hello Entity - Add entities to a grid		▶ Open in Playground

Frame

Snippet	Preview	Source
Frame Colors Frame Colors - Fill and outline colors		▶ Open in Playground
Frame Opacity Frame Opacity - Transparency levels		▶ Open in Playground
Frame Outline Frame Outline - Border thickness		▶ Open in Playground
Frame Children Frame Children - Nested UI elements		▶ Open in Playground
Frame Clip Children Frame Clipping - clip_children property		▶ Open in Playground
Frame Z Index Frame Z-Index - Control rendering order		▶ Open in Playground
Frame Visible Frame Visibility - Show and hide elements		▶ Open in Playground
Frame Name Frame Name - Named elements for lookup		▶ Open in Playground
Frame Rotation Frame Rotation - Rotate UI elements		▶ Open in Playground
Frame Origin Frame Origin - Rotation pivot point		▶ Open in Playground
Frame Alignment Frame Alignment - Automatic positioning		▶ Open in Playground

Caption

Snippet	Preview	Source
Caption Styling Caption Styling - Text colors and fonts		▶ Open in Playground
Caption In Frame Caption in Frame - Text inside containers		▶ Open in Playground
Caption Dimensions Caption Dimensions - Text width and height		▶ Open in Playground

Sprite

Snippet	Preview	Source
Sprite Atlas Sprite Atlas - Browse texture atlas		▶ Open in Playground
Sprite Scale Sprite Scale - Resize sprites		▶ Open in Playground
Sprite Tint Sprite Tint - Note: Sprite tinting requires shader		▶ Open in Playground
Sprite Rotation Sprite Rotation - Rotate sprite images		▶ Open in Playground

Grid

Snippet	Preview	Source
Grid Tiles Grid Tiles - Different tile types		▶ Open in Playground
Grid Walkable Grid Walkable - Walkable vs blocked tiles		▶ Open in Playground
Grid Cell Color Grid Cell Colors - Use color layer for cell colors		▶ Open in Playground
Grid Camera Center Grid Camera Center - Pan the view		▶ Open in Playground
Grid Zoom Grid Zoom - Scale the grid view		▶ Open in Playground
Grid Layers Grid Layers - Multiple tile layers		▶ Open in Playground
Grid Point State Grid Point State - Cell properties		▶ Open in Playground
Grid Fill Color Grid Fill Color - Background color		▶ Open in Playground
Grid Camera Rotation Grid Camera Rotation - Rotate the view		▶ Open in Playground
Grid Size Grid Display Size - Viewport dimensions		▶ Open in Playground
Grid Interaction Patterns 1 Scene setup		▶ Open in Playground
Grid Interaction Patterns 2 Scene setup		▶ Open in Playground
Grid Interaction Patterns 3		▶ Open in Playground
Grid Interaction Patterns 4		▶ Open in Playground
Grid Interaction Patterns 5		▶ Open in Playground
Grid Interaction Patterns 6		▶ Open in Playground
Grid Interaction Patterns 7		▶ Open in Playground
Grid Cell Highlighting 1		▶ Open in Playground
Grid Cell Highlighting 2		▶ Open in Playground
Grid Dijkstra 1		▶ Open in Playground
Grid Dijkstra 2		▶ Open in Playground
Grid Dijkstra Heightmap 1 Create a grid with walkable cells	—	▶ Open in Playground
Grid Dijkstra Heightmap 2		▶ Open in Playground
Grid Dungeon Generator Tile indices (adjust for your tileset)		▶ Open in Playground
Grid Fog Of War 1 Create scene and grid		▶ Open in Playground
Grid Fog Of War 2 Scene setup		▶ Open in Playground
Grid Multi Layer 1		▶ Open in Playground
Grid Multi Layer 2		▶ Open in Playground
Grid System 1 Create a scene first		▶ Open in Playground
Grid System 2 Setup scene		▶ Open in Playground

Entity

Snippet	Preview	Source
Entity Movement Entity Movement - Move entities on grid		▶ Open in Playground
Entity Multiple Multiple Entities - Several entities on one grid		▶ Open in Playground
Entity Draw Pos Entity Draw Position - Smooth sub-tile positioning		▶ Open in Playground
Entity Collection Entity Collection - Manage grid entities		▶ Open in Playground
Entity Visibility Entity Visibility - Check what entities can see		▶ Open in Playground
Entity Die Entity Die - Remove entity from grid		▶ Open in Playground
Entity Index Entity Index - Get entity position in collection		▶ Open in Playground
Entity At Entity At - Query entity’s view of grid		▶ Open in Playground

Animation

Snippet	Preview	Source
Animation Basic Animation Basic - Animate position		▶ Open in Playground
Animation Easing Linear Easing: LINEAR - Constant speed		▶ Open in Playground
Animation Easing Ease In Easing: EASE_IN - Slow start, fast end		▶ Open in Playground
Animation Easing Ease Out Easing: EASE_OUT - Fast start, slow end		▶ Open in Playground
Animation Easing Ease In Out Easing: EASE_IN_OUT - Smooth both ends		▶ Open in Playground
Animation Easing Bounce Easing: BOUNCE - Bouncy effect		▶ Open in Playground
Animation Easing Elastic Easing: ELASTIC - Springy overshoot		▶ Open in Playground
Animation Easing Back Easing: BACK - Anticipation/overshoot		▶ Open in Playground
Animation Easing Comparison Easing Comparison - Multiple easings side by side		▶ Open in Playground
Animation Color Animation Color - Animate fill_color		▶ Open in Playground
Animation Opacity Animation Opacity - Fade in/out		▶ Open in Playground
Animation Size Animation Size - Grow and shrink		▶ Open in Playground
Animation Sprite Index Animation Sprite Index - Sprite animation		▶ Open in Playground
Animation Callback Animation Callback - Run code when animation ends		▶ Open in Playground
Animation Chain Animation Chain - Sequential animations		▶ Open in Playground
Animation Multiple Animation Multiple - Several animations at once		▶ Open in Playground
Animation Pos Vector Animation Position - Animate x and y along a path		▶ Open in Playground
Animation Delta Animation Delta - Relative animation		▶ Open in Playground
Animation Complete Animation Complete Check - Monitor animation state		▶ Open in Playground
Animation Stop Animation Stop/Complete - Control running animations		▶ Open in Playground

Timer

Snippet	Preview	Source
Timer Basic Timer Basic - Periodic callback		▶ Open in Playground
Timer Once Timer Once - Single-shot timer		▶ Open in Playground
Timer Control Timer Control - Pause, resume, stop		▶ Open in Playground
Timer Remaining Timer Remaining - Check time until next tick		▶ Open in Playground
Timer Restart Timer Restart - Reset and start timer		▶ Open in Playground

Input

Snippet	Preview	Source
Input Keyboard Input Keyboard - Key press handling		▶ Open in Playground
Input Mouse Click Input Mouse Click - Click on frames		▶ Open in Playground
Input Mouse Hover Input Mouse Hover - Enter/exit/move events		▶ Open in Playground
Input Grid Cell Click Input Grid Cell Click - Click on grid cells		▶ Open in Playground
Input Grid Cell Hover Input Grid Cell Hover - Hover over grid cells		▶ Open in Playground

Pathfinding

Snippet	Preview	Source
Pathfinding Astar Pathfinding A* - Find path between points		▶ Open in Playground
Pathfinding Entity Entity Pathfinding - Entity path_to method		▶ Open in Playground
Pathfinding Dijkstra Dijkstra Map - Distance-based pathfinding		▶ Open in Playground
Pathfinding Setup		▶ Open in Playground

Fov

Snippet	Preview	Source
Fov Basic FOV Basic - Field of view computation		▶ Open in Playground
Fov Algorithms FOV Algorithms - Compare different algorithms		▶ Open in Playground
Fov Perspective FOV Perspective Entity - View from entity’s perspective		▶ Open in Playground
Fov Setup		▶ Open in Playground

Bsp

Snippet	Preview	Source
Bsp Basic BSP Basic - Binary space partition for dungeon generation		▶ Open in Playground
Bsp Traversal BSP Traversal - Different traversal orders		▶ Open in Playground

Scene

Snippet	Preview	Source
Scene Switching Scene Switching - Multiple scenes		▶ Open in Playground
Scene Transition Fade Scene Transition Fade - Smooth scene transitions		▶ Open in Playground
Scene Transition Slide Scene Transition Slide - Sliding transitions		▶ Open in Playground
Scene Lifecycle Scene Lifecycle - on_enter/on_exit callbacks		▶ Open in Playground
Scene Pos Scene Position - Offset all scene content		▶ Open in Playground
Scene Update Scene Update - Per-frame update method		▶ Open in Playground

Vector

Snippet	Preview	Source
Vector Basics Vector Basics - 2D vector operations		▶ Open in Playground
Vector Normalized Vector Normalized - Unit vectors		▶ Open in Playground

Color

Snippet	Preview	Source
Color Components Color Components - RGBA color manipulation		▶ Open in Playground
Color Animation Channels Color Channel Animation - Animate individual RGBA		▶ Open in Playground

Find

Snippet	Preview	Source
Find Elements Find Elements - Locate UI by name		▶ Open in Playground

Collection

Snippet	Preview	Source
Collection Iteration Collection Iteration - Loop through UI children		▶ Open in Playground

Window

Snippet	Preview	Source
Window Properties Window Properties - Access window settings		▶ Open in Playground

Keyboard

Snippet	Preview	Source
Keyboard State Keyboard State - Track key presses		▶ Open in Playground

Mouse

Snippet	Preview	Source
Mouse State Mouse State - Track mouse position and buttons		▶ Open in Playground

Ui

Snippet	Preview	Source
Ui Button UI Button - Interactive button with hover		▶ Open in Playground
Ui Health Bar UI Health Bar - Animated health display		▶ Open in Playground
Ui Tooltip UI Tooltip - Hover tooltip display		▶ Open in Playground
Ui Message Log UI Message Log - Scrolling text messages		▶ Open in Playground
Ui Modal UI Modal Dialog - Popup confirmation		▶ Open in Playground
Ui Widget Patterns 1 Setup Template - the basic scaffold shared by all widget patterns on this page.		▶ Open in Playground
Ui Widget Patterns 2 Button pattern - a clickable frame with label and hover feedback.		▶ Open in Playground
Ui Widget Patterns 3 Toggle / Checkbox pattern - a button that toggles state and updates its appearance.		▶ Open in Playground
Ui Widget Patterns 4 Vertical Menu pattern - a list of selectable options with keyboard navigation.		▶ Open in Playground
Ui Widget Patterns 5 Modal Dialog pattern - a dialog that captures all input until dismissed.		▶ Open in Playground
Ui Widget Patterns 6 Hotbar / Quick Slots pattern - number keys (1-9) mapped to inventory slots.		▶ Open in Playground
Ui Widget Patterns 7 Draggable Window pattern - a frame that can be dragged by its title bar.		▶ Open in Playground
Ui Alignment 1 Create parent container		▶ Open in Playground
Ui Alignment 2		▶ Open in Playground
Ui Alignment 3		▶ Open in Playground
Ui Alignment 4		▶ Open in Playground
Ui Alignment 5 Full-screen container		▶ Open in Playground
Ui Alignment 6 Overlay background		▶ Open in Playground
Ui Alignment 7		▶ Open in Playground
Ui Health Bar 1		▶ Open in Playground
Ui Health Bar 2		▶ Open in Playground
Ui Health Bar 3		▶ Open in Playground
Ui Health Bar 4		▶ Open in Playground
Ui Menu 1		▶ Open in Playground
Ui Menu 2		▶ Open in Playground
Ui Menu 3		▶ Open in Playground
Ui Message Log 1		▶ Open in Playground
Ui Message Log 2 Predefined message categories with colors		▶ Open in Playground
Ui Message Log 3		▶ Open in Playground
Ui Modal Dialog 1		▶ Open in Playground
Ui Modal Dialog 2		▶ Open in Playground
Ui Tooltip 1		▶ Open in Playground
Ui Tooltip 2		▶ Open in Playground
Ui Tooltip 3		▶ Open in Playground
Ui Tooltip 4 Background		▶ Open in Playground

Effect

Snippet	Preview	Source
Effect Screen Shake Effect Screen Shake - Impact feedback		▶ Open in Playground
Effect Damage Flash Effect Damage Flash - Hit feedback on frame		▶ Open in Playground
Effect Floating Text Effect Floating Text - Damage numbers		▶ Open in Playground
Effect Pulse Effect Pulse - Pulsing highlight		▶ Open in Playground

Game

Snippet	Preview	Source
Game Turn Based Game Turn-Based - Simple turn system		▶ Open in Playground
Game Inventory Game Inventory - Grid-based inventory UI		▶ Open in Playground
Game Minimap Game Minimap - Small overview map		▶ Open in Playground
Game Collision Game Collision - Simple collision detection		▶ Open in Playground

Bresenham

Snippet	Preview	Source
Bresenham Line Bresenham Line - Draw lines on grid		▶ Open in Playground

Procgen

Snippet	Preview	Source
Procgen Cellular Procgen Cellular - Cave generation		▶ Open in Playground
Procgen Cellular Caves		▶ Open in Playground
Procgen Wfc		▶ Open in Playground

Camera

Snippet	Preview	Source
Camera Follow Camera Follow - Camera tracks entity		▶ Open in Playground

Metrics

Snippet	Preview	Source
Metrics Display Metrics Display - Performance monitoring		▶ Open in Playground

Global

Snippet	Preview	Source
Global Pos Global Position - World coordinates		▶ Open in Playground

Parent

Snippet	Preview	Source
Parent Reference Parent Reference - Access parent from child		▶ Open in Playground

Hovered

Snippet	Preview	Source
Hovered State Hovered State - Check if element is hovered		▶ Open in Playground

Complete

Snippet	Preview	Source
Complete Game Complete Mini-Game - Putting it all together		▶ Open in Playground

Texture

Snippet	Preview	Source
Texture Properties Texture Properties - Texture information		▶ Open in Playground

Scenes

Snippet	Preview	Source
Scenes Dict Scenes Tuple - Access all scenes		▶ Open in Playground
Scenes 1 Create scene with object reference		▶ Open in Playground
Scenes 2 Background		▶ Open in Playground

Timers

Snippet	Preview	Source
Timers List Timers List - View all active timers		▶ Open in Playground

Animations

Snippet	Preview	Source
Animations List Animations List - View all active animations		▶ Open in Playground

Cache

Snippet	Preview	Source
Cache Subtree Cache Subtree - Performance optimization		▶ Open in Playground

Realign

Snippet	Preview	Source
Realign Realign - Reapply alignment after changes		▶ Open in Playground

Version

Snippet	Preview	Source
Version Info Version Info - Engine version and info		▶ Open in Playground

Alignment

Snippet	Preview	Source
Alignment Margins Alignment Margins - Spacing from edges		▶ Open in Playground

Easing

Snippet	Preview	Source
Easing Cubic Easing Cubic - Cubic easing functions		▶ Open in Playground
Easing Sine Easing Sine - Sinusoidal easing		▶ Open in Playground
Easing Expo Easing Exponential - Dramatic acceleration		▶ Open in Playground
Easing Circ Easing Circular - Circular motion curve		▶ Open in Playground
Easing Quart Easing Quartic - Strong power easing		▶ Open in Playground

Default

Snippet	Preview	Source
Default Fov Default FOV - Set default algorithm		▶ Open in Playground

Exit

Snippet	Preview	Source
Exit Game Exit Game - Clean shutdown		▶ Open in Playground

Combat

Snippet	Preview	Source
Combat Melee Melee combat cookbook recipe - Fighter stats, attack resolution, CombatEntity,		▶ Open in Playground

Effects

Snippet	Preview	Source
Effects Color Pulse 1		▶ Open in Playground
Effects Color Pulse 2		▶ Open in Playground
Effects Color Pulse 3		▶ Open in Playground
Effects Color Pulse 4		▶ Open in Playground
Effects Color Pulse 5		▶ Open in Playground
Effects Damage Flash 1		▶ Open in Playground
Effects Damage Flash 2		▶ Open in Playground
Effects Damage Flash 3		▶ Open in Playground
Effects Floating Text Create the caption		▶ Open in Playground
Effects Path Animation		▶ Open in Playground
Effects Scene Transitions 1 Create scenes, then switch between them with activate()	—	▶ Open in Playground
Effects Scene Transitions 2		▶ Open in Playground
Effects Scene Transitions 3		▶ Open in Playground
Effects Scene Transitions 4		▶ Open in Playground
Effects Scene Transitions 5		▶ Open in Playground
Effects Screen Shake 1		▶ Open in Playground
Effects Screen Shake 2		▶ Open in Playground
Effects Screen Shake 3		▶ Open in Playground

Headless

Snippet	Preview	Source
Headless Mode 1		▶ Open in Playground
Headless Mode 2		▶ Open in Playground

Rendering

Snippet	Preview	Source
Rendering And Visuals 1 Create scene		▶ Open in Playground
Rendering And Visuals 2 Background layer (z=0)		▶ Open in Playground

Astarpath

Snippet	Preview	Source
Astarpath		▶ Open in Playground

Alignment

Snippet	Preview	Source
Alignment		▶ Open in Playground

Animation

Snippet	Preview	Source
Animation 1		▶ Open in Playground
Animation 2		▶ Open in Playground
Animation 3		▶ Open in Playground
Animation 4		▶ Open in Playground
Animation 5		▶ Open in Playground
Animation 6		▶ Open in Playground
Animation 7		▶ Open in Playground
Animation 8		▶ Open in Playground
Animation 9		▶ Open in Playground
Animation 10		▶ Open in Playground

Arc

Snippet	Preview	Source
Arc 1 Create a simple arc		▶ Open in Playground
Arc 2 Animated loading spinner		▶ Open in Playground

Bsp

Snippet	Preview	Source
Bsp 1 BSP Quick Reference - create a tree, split, and iterate leaves		▶ Open in Playground
Bsp 2 BSP traversal - iterate leaves and all nodes in various orders	—	▶ Open in Playground
Bsp 3 BSP adjacency - connect rooms with corridors via the wall-tile map	—	▶ Open in Playground

Caption

Snippet	Preview	Source
Caption Create a caption		▶ Open in Playground

Circle

Snippet	Preview	Source
Circle 1 Create a filled circle		▶ Open in Playground
Circle 2 Interactive button circle		▶ Open in Playground

Colorlayer

Snippet	Preview	Source
Colorlayer 1		▶ Open in Playground
Colorlayer 2		▶ Open in Playground

Color

Snippet	Preview	Source
Color Create colors		▶ Open in Playground

Dijkstramap

Snippet	Preview	Source
Dijkstramap		▶ Open in Playground

Drawable

Snippet	Preview	Source
Drawable Drawable is abstract - use subclasses		▶ Open in Playground

Easing

Snippet	Preview	Source
Easing		▶ Open in Playground

Entity

Snippet	Preview	Source
Entity		▶ Open in Playground

Fov

Snippet	Preview	Source
Fov 1 Create grid and set algorithm		▶ Open in Playground
Fov 2		▶ Open in Playground

Font

Snippet	Preview	Source
Font 1 Load a font		▶ Open in Playground
Font 2 Load font		▶ Open in Playground

Frame

Snippet	Preview	Source
Frame Create a styled panel		▶ Open in Playground

Grid

Snippet	Preview	Source
Grid		▶ Open in Playground

Heightmap

Snippet	Preview	Source
Heightmap		▶ Open in Playground

Inputstate

Snippet	Preview	Source
Inputstate		▶ Open in Playground

Key

Snippet	Preview	Source
Key		▶ Open in Playground

Keyboard

Snippet	Preview	Source
Keyboard		▶ Open in Playground

Line

Snippet	Preview	Source
Line 1 Create a simple line		▶ Open in Playground
Line 2 Draw a triangle using three lines		▶ Open in Playground

Mousebutton

Snippet	Preview	Source
Mousebutton 1		▶ Open in Playground
Mousebutton 2		▶ Open in Playground

Mouse

Snippet	Preview	Source
Mouse 1	—	▶ Open in Playground
Mouse 2 Create a custom cursor sprite (uses the default texture atlas)		▶ Open in Playground

Music

Noisesource

Scene

Snippet	Preview	Source
Scene 1 Create a scene		▶ Open in Playground
Scene 2 Create and populate a scene		▶ Open in Playground

Sprite

Snippet	Preview	Source
Sprite Sprite Quick Reference - create, scale, animate a sprite		▶ Open in Playground

Texture

Snippet	Preview	Source
Texture 1 Load a sprite sheet		▶ Open in Playground
Texture 2 Load texture		▶ Open in Playground

Tilelayer

Snippet	Preview	Source
Tilelayer		▶ Open in Playground

Timer

Snippet	Preview	Source
Timer		▶ Open in Playground

Transition

Snippet	Preview	Source
Transition 1 Create scenes		▶ Open in Playground
Transition 2		▶ Open in Playground

Traversal

Vector

Snippet	Preview	Source
Vector 1 Create vectors		▶ Open in Playground
Vector 2		▶ Open in Playground

Window

Part

Snippet	Preview	Source
Part 00 Setup Create a Scene object - this is the preferred approach		▶ Open in Playground
Part 01 Grid Movement Sprite indices for CP437 tileset		▶ Open in Playground
Part 02 Tiles Collision 1 =============================================================================		▶ Open in Playground
Part 02 Tiles Collision 2 Constants		▶ Open in Playground
Part 03 Dungeon Generation		▶ Open in Playground
Part 04 Fov		▶ Open in Playground
Part 05 Enemies		▶ Open in Playground
Part 06 Combat		▶ Open in Playground
Part 07 Ui		▶ Open in Playground
Part 08 Items		▶ Open in Playground
Part 09 Ranged		▶ Open in Playground
Part 10 Save Load		▶ Open in Playground
Part 11 Levels		▶ Open in Playground
Part 13 Equipment		▶ Open in Playground

Engine Demo Screens

25 interactive demo screens from the engine test harness (tests/demo/screens/). Run them with ./mcrogueface ../tests/demo/demo_main.py.

Games

Full games built on McRogueFace. Web/desktop packaging is pending — these are listed from the engine repo’s games/ directory and are not yet downloadable builds.