Skip to content

Godot Plugin for handling Stat Pools, such as: Health, Stamina, Mana, Hunger, Skills and even Money systems.

License

Notifications You must be signed in to change notification settings

shoyguer/stat-pool

Repository files navigation

StatPool

A simple, efficient stat management system for Godot games. Perfect to be used for health, mana pools, stamina systems, hunger meters, or any numeric stat that needs min/max bounds and signal notifications.

Header Image

Why Use StatPool?

Managing stats in games is annoying. You always end up writing the same code over and over:

  • Clamping values between min/max
  • Emitting signals when things change
  • Checking if you're at boundaries (empty/full)
  • Calculating percentages for UI bars

This is a GDExtension plugin, this means it was done with performance in mind.

Target platforms:

Platform Supported Systems
Desktop 🪟 Windows • 🐧 Linux • 🍎 MacOS
Mobile 🤖 Android • 📱 iOS
Others 🌐 Web

Requirements

Building From Source

Only needed if you want to modify the plugin. Follow godot-plus-plus instructions, and you'll be fine!

Installation

  1. Download the latest release
  2. Extract to your Godot project, and make sure this is how your project structure looks:
your_project_folder/
├── addons/
│   └── stat_pool/
│       ├── bin/
│       ├── stat_pool.gdextension
│       └── ...
  1. That's it! StatPool should now be installed 😁.

(Since it is a GDExtension plugin, you don't need to activate it through Project Settings)

How to use StatPool

Check the Wiki for information on how to use this plugin.

Or jump to whatever you need:

Wiki

Other Plugins

Check out my other Godot plugins:

Plugin Description
Seed generation system
Flexible time management system
Plugin for handling VERY big numbers.
Complete and Customizeable button with useful features

Support

If this plugin helped you, please, consider:

  • ⭐ Star this repository
  • 🐛 Report bugs in Issues
  • 💡 Suggest improvements

And a BIG thanks to Nikich for his godot-plus-plus template.

About

Godot Plugin for handling Stat Pools, such as: Health, Stamina, Mana, Hunger, Skills and even Money systems.

Topics

Resources

License

Stars

Watchers

Forks