godot-genre-roguelike
Installation
SKILL.md
Godot 4.7 Baseline
- Expert patterns in this skill target Godot 4.7+ (stable, 2026-06-18).
- Consult the Godot 4.7 migration guide when upgrading projects from 4.6.
- NEVER assume 4.6 defaults (stretch mode, audio area_mask, RichTextLabel percent flags) without checking 4.7 migration notes.
Genre: Roguelike
Expert blueprint for roguelikes balancing challenge, progression, and replayability.
NEVER Do (Expert Anti-Patterns)
Generation & RNG
- NEVER make runs dependent on pure RNG; strictly provide mitigation (rerolls, shops, pity timers) to ensure every run is winnable.
- NEVER use unseeded RNG for world generation; strictly initialize isolated
RandomNumberGeneratorwith a predictable seed for daily runs/debugging. - NEVER rely on
@GlobalScope.randi()for critical logic; strictly use local RNG instances to prevent global state pollution. - NEVER use
Array.pick_random()for critical content drops; strictly use a Shuffle Bag to prevent statistically unfair streaks. - NEVER generate massive dungeons on the main thread; strictly use
WorkerThreadPool.add_task()oradd_group_task()to distribute generation across cores and prevent frame freezes. - NEVER interact with the SceneTree from a background thread; strictly generate dungeon data in a thread-safe Array/PackedByteArray before parsing on the main thread.