QNum

A big-number library for Roblox incremental games. Stores values as a normalized mantissa/exponent pair so calculations stay accurate well beyond what a regular number can represent.

Installation

Add to your wally.toml:

[dependencies]
QNum = "notiku/qnum@0.2.1"

Then run:

wally install

Usage

local QNum = require(Path.To.QNum)

local gold = QNum.fromNumber(1500)
local reward = QNum.fromString("2.5e9")

local total = gold + reward
print(total)              --> 2.50B
print(total:Format())     --> 2.50B
print(QNum.toScientific(total)) --> 2.50e9

API

Constructors

Arithmetic

add, sub, mul, div, pow are available as static functions (QNum.add(a, b)), as instance methods (a:Add(b)), and via metamethods (a + b, a - b, a * b, a / b, a ^ 2).

Comparison

eq, gt, lt, gte, lte — also wired up to ==, <, <=.

Formatting

tostring(value) is equivalent to QNum.format(value).

Utility

• QNum.clone(value)
• QNum.normalize(value)
• QNum.toNumber(value) — converts back to a regular number (may overflow for huge values)
• QNum.zero, QNum.one

License

See LICENSE.