Godot Stats and Leveling

Stats get hard the moment a sword, a buff and a level-up all change the same number. Each modifier here is tagged with where it came from. Taking off the sword removes exactly what the sword added.

Free Godot 4.7 project · MIT licensed · v1.0.0

Get the free project Learn to build it

No account needed. Or download the v1.0.0 ZIP directly.

Gaining XP, levelling up, spending stat points, equipping a sword and taking a blessing.

What is in it

A Stat resource with a base value, a minimum and maximum, a current value and change signals.
Pools you spend and refill, like health and mana, kept apart from attributes like strength.
Modifiers tagged by source, and cleared by source or by category.
Flat and percent modifiers, so a +25% blessing scales your gear bonus too.
A leveling component with an exponential XP curve and stat points to spend.
Save and load to plain dictionaries, plus ready-made stat presets.

Quick start

Download the project from GitHub and unzip it. In the Godot Project Manager, click Import and pick the project.godot file inside the folder.

Press F5.
Click +200 XP to level up, then spend points on STR, DEX or VIT.
Toggle the Iron Sword and watch Strength go up by 20, then back down.
Click Save, change a few things, then click Load.

The README on GitHub explains how each part works and how to copy it into your own game.

Compatibility and limits

Made for: Godot 4.7, standard build. GDScript only, no .NET needed.
Tested on: Godot 4.7.2 stable, on Windows. Earlier versions of Godot 4 are untested.
Renderer: Compatibility
Code license: MIT. You can use it in commercial games. Read the license
Art and fonts: None. Everything you see is drawn in code or uses Godot's built-in theme.
Release: v1.0.0, commit 4861e1e, published 2026-10-03

Known limits

Modifiers are not saved. Re-apply them from your equipment and buffs after loading.
A stat point always adds 1 to the base value. Derived stats are up to you.
The demo is a character sheet panel, not a game scene.

Learn to build it

Copying a system works until you need to change it. These quests build it with you, one small step at a time. You write the GDScript in your browser and each step is checked before you move on.