// the find
guladam/deck_builder_tutorial
A roguelike deckbuilder tutorial project made in Godot 4.
A tutorial project for building a roguelike deckbuilder in Godot 4, accompanying a video series. It's a working game with maps, battles, shops, relics, and a card state machine — not just skeleton code. Aimed at intermediate Godot learners who want to see how a genre-defining game pattern gets implemented from scratch.
The card interaction system uses a proper state machine (base, clicked, dragging, aiming, released) rather than a mess of boolean flags — that alone is worth studying. Data is cleanly separated into custom resources (.tres files) for cards, enemies, relics, and run state, which is the right way to handle Godot's resource system. Enemy AI uses an action-picker pattern with tiered battle pools, giving a clear path for extending difficulty. The project is complete enough to actually play, which matters more than most tutorials deliver.
Last commit was October 2024 and the README links to a YouTube series, meaning the code is only meaningful with the videos — without them, the why behind structural decisions is opaque. Only the warrior character is fleshed out; assassin and wizard are stubs, so the character system isn't really demonstrating extensibility yet. No tests of any kind, which is fine for a tutorial but means the save/load system and RNG-dependent systems have no safety net if you start modifying them. The event room system has exactly two events, making it the thinnest part of an otherwise reasonably complete game.