---
title: "NumberRange"
description: "The NumberRange namespace — the engine's Luau API reference for NumberRange."
section: "API Reference"
slug: "api-numberrange"
canonical: "https://origozero.ai/docs/api-numberrange"
updated: "2026-08-22T18:22:38.213039385+00:00"
tags: ["api", "reference"]
---

# NumberRange

The `NumberRange` namespace — 1 function.

## globals/NumberRange/new {#globals-numberrange-new}

```lua
NumberRange.new(min: number, max: number?) -> any
```

Construct a `NumberRange`. Pass one number for a constant range
(`min == max`); pass two for a uniform random range. Reversed
arguments are normalized to ascending order.

**Parameters**

- `min` `number` — Lower bound.
- `max` `number` _(optional)_ — Upper bound; defaults to `min`.

**Returns** `any`

```lua
local lifetime = NumberRange.new(1.0)        -- always 1.0
local speed    = NumberRange.new(0.5, 2.0)   -- random
```