Skip to content

IntValue

Supported Class Values

A container object for a single integer.

Description

Stores a single signed 64-bit integer. The highest allowed value is 2^63-1 or around 9.2 quintillion (9.2^18). Attempting to store larger numbers causes an integer overflow. The lowest allowed value is -2^63. Practically, however, working with integers larger than 2^53 (9^15) causes loss of precision since Luau uses double-precision floating-point to store numbers.

It's possible to store values between 2^53 and 2^63-1 using the Properties window since it uses strings to pass data to the engine, but manipulating large values via Luau scripts results in loss of precision and rounding as mentioned above.

The main advantage of using IntValue lies in its rounding of values to the nearest integer, with halfway cases rounded away from 0. For values outside of this range, use NumberValue instead.

Like all ValueBase objects, this single value is stored in the Value property. The Changed event fires with the new value being stored in the object, instead of a string representing the property being changed.

Inheritance

Object → Instance → ValueBase → IntValue

Nova inheritance: Instance → IntValue

Properties

Value Supported Property Used to hold an integer.
Value: int

Used to hold an integer.

Roblox reference signature
Value: int64

Roblox documentation

Events

Changed Supported Event Fires whenever the IntValue.Value is changed.
Changed(int value)

Fires whenever the IntValue.Value is changed.

Fires whenever the IntValue.Value changes. It runs with the new value being stored in the argument object, instead of a string representing the property being changed.

Listening for the Changed signal can be useful in games that use IntValues to track values like leaderboard statistics or item prices.

Roblox reference signature
Changed(value: int64)

Roblox documentation

changed Supported Event Deprecated
changed(int value)

No description available.

Roblox reference signature
changed(value: int64)
Nova behaviour: Nova keeps this legacy member for compatibility. Roblox's modern deprecation wording may describe later Roblox behaviour; verify it against Nova before relying on the copied text.

Roblox documentation

Inherited members

Inherited from Instance: 8 properties, 36 methods, 7 events. They are documented on the base class page.

Roblox reference: IntValue

Generated from Nova's API dump and Roblox creator-docs. Nova-only members come from the engine's reflection metadata.