Skip to content

shoyguer/big-number

Repository files navigation

BigNumber

A high-performance Big Number library for Godot games. Perfect for idle / incremental games, or any project where you need numbers exceeding the limits of standard integer and float types.

Header Image

This plugin was built upon ChronoDk's GodotBigNumberClass, credits to him! Though my version uses GDExtension instead, for optimization.

Check the comparison below (results may vary): Testing Results Hardware used for testing:

  • AMD Ryzen 5 5600
  • AMD RX 6750XT
  • 48 GB RAM 3200MHz
  • 512 GB SSD M.2

Why Use BigNumber?

Managing massive numbers in games is performance-heavy and complex. This plugin provides you with:

  • Capable of handling numbers much larger than float or int
  • High Performance
  • Built-in support for multiple notation styles:
    • Scientific (1.23e45)
    • AA Notation (aa, ab, ac...)
    • Metric Symbols (k, M, B, T...)
    • Metric Names (kilo, mega, giga...)
  • Methods similar to standard arithmetic operations.

This is a GDExtension plugin, built with performance in mind.

Target platforms:

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

Requirements

Check Releases for older versions.

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/
│   └── big_number/
│       ├── bin/
│       ├── big_number.gdextension
│       └── ...
  1. That's it! BigNumber should now be installed 😁.

(Since it is a GDExtension plugin, you don't need to activate it through Project Settings. Just restart the editor if classes don't appear immediately.)

How to use BigNumber

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
Flexible time management & tick system
Flexible stat management system (for Health, Mana, Stamina, money etc)
A simple Random seed generation system
Complete and Customizeable button with useful features

Support

If this plugin helped you, please, consider:

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

Thanks to ChronoDK for his GodotBigNumberClass which inspired and was the base for this plugin.

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

About

Godot Plugin for handling HUGE numbers, focused on optimization.

Topics

Resources

License

Stars

Watchers

Forks