[Demo Target] r/roguelikedev Tutorial Series Demo Game #167

New issue

Open

opened 2025-12-29 03:54:52 +00:00 by john · 0 comments

john commented

2025-12-29 03:54:52 +00:00

Owner

Summary

Create a tutorial series and accompanying demo game targeting the r/roguelikedev annual "Complete Roguelike Tutorial" event, typically held over 8 weeks each summer.

Background

The 2024/2025 attempt to write McRogueFace tutorials alongside the community event revealed the engine wasn't ready. Those blocking issues have since been closed. Summer 2026 is the target.

r/roguelikedev Tutorial Structure (Traditional)

The community follows a ~13 part tutorial based on libtcod/Python:

Setting up / Drawing the '@'
Moving around
The generic Entity and map
Field of view
Placing enemies and kicking them
Combat and AI
Creating the Interface (UI)
Items and inventory
Ranged attacks and targeting
Saving and loading
Delving into the dungeon
Monster and item variety
Equipment

McRogueFace Adaptation

Map each traditional part to McRogueFace features:

Parts 1-3: Grid, Entity, sprites, keyboard input
Part 4: Built-in FOV from libtcod integration
Parts 5-6: Entity interactions, turn handling
Part 7: Frame, Caption, UI composition
Parts 8-9: Game logic in Python
Part 10: Python json for save/load
Parts 11-13: Procedural generation, game content

Deliverables

Tutorial text (8 parts matching community schedule)
Progressive code snapshots (runnable after each part)
Demo game showing completed result
Video walkthroughs (optional but valuable)

Success Criteria

Complete beginner can follow tutorials with no prior McRogueFace experience
Each week's content completable in 2-4 hours
Final result is a playable roguelike

Timeline

Early 2026: Draft tutorials, test with beta readers
Summer 2026: Release alongside community event
Post-event: Refine based on feedback

Website needs tutorial section
README needs getting-started pointer
Crypt of Sokoban provides reference but is too complex for tutorials

## Summary Create a tutorial series and accompanying demo game targeting the r/roguelikedev annual "Complete Roguelike Tutorial" event, typically held over 8 weeks each summer. ## Background The 2024/2025 attempt to write McRogueFace tutorials alongside the community event revealed the engine wasn't ready. Those blocking issues have since been closed. Summer 2026 is the target. ## r/roguelikedev Tutorial Structure (Traditional) The community follows a ~13 part tutorial based on libtcod/Python: 1. Setting up / Drawing the '@' 2. Moving around 3. The generic Entity and map 4. Field of view 5. Placing enemies and kicking them 6. Combat and AI 7. Creating the Interface (UI) 8. Items and inventory 9. Ranged attacks and targeting 10. Saving and loading 11. Delving into the dungeon 12. Monster and item variety 13. Equipment ## McRogueFace Adaptation Map each traditional part to McRogueFace features: - Parts 1-3: Grid, Entity, sprites, keyboard input - Part 4: Built-in FOV from libtcod integration - Parts 5-6: Entity interactions, turn handling - Part 7: Frame, Caption, UI composition - Parts 8-9: Game logic in Python - Part 10: Python `json` for save/load - Parts 11-13: Procedural generation, game content ## Deliverables 1. **Tutorial text** (8 parts matching community schedule) 2. **Progressive code snapshots** (runnable after each part) 3. **Demo game** showing completed result 4. **Video walkthroughs** (optional but valuable) ## Success Criteria - Complete beginner can follow tutorials with no prior McRogueFace experience - Each week's content completable in 2-4 hours - Final result is a playable roguelike ## Timeline - **Early 2026**: Draft tutorials, test with beta readers - **Summer 2026**: Release alongside community event - **Post-event**: Refine based on feedback ## Related - Website needs tutorial section - README needs getting-started pointer - Crypt of Sokoban provides reference but is too complex for tutorials