Introduction

Do you need to handle truly massive numbers in your Roblox game—without sacrificing performance?

AlyaNum is your solution! This library is a high-performance fork of OmegaNum by FoundForces and Naruyoko, completely rewritten for speed and readability. No more struggling with slow, unoptimized, or hard-to-maintain code.

AlyaNum supports numbers up to 10^^^^^10 (heptation!), a limit so high it's virtually unreachable in any Roblox game. Yet, it remains faster than other libraries like EternityNum and InfiniteMath.

Enjoy the freedom to work with gigantic numbers—without the headaches.

Installation

Getting started with AlyaNum is simple! Choose your preferred method:

1. Roblox Toolbox: AlyaNum on Roblox
2. Wally: evilbocchi/alyanum
3. npm (for roblox-ts): @antivivi/alyanum

Basic Usage

Lua Example

local AlyaNum = require(path.to.AlyaNum)

local number = AlyaNum.new(5) -- Create a new AlyaNum representing 5
print(number) -- 5

local toAdd = AlyaNum.new(250)
toAdd = toAdd:mul(2) -- Use macro functions...
number = number + toAdd -- ...or Lua metamethods
print(number) -- 505
Copy

TypeScript Example

import AlyaNum from "@antivivi/AlyaNum";

let number = new AlyaNum(5); // Create a new AlyaNum representing 5
print(number); // 5

let toAdd = new AlyaNum(250);
toAdd = toAdd.mul(2); // Use macro functions (TypeScript does not support operator overloading)
number = number.add(toAdd);
print(number); // 505
Copy