Forge

Tiers

Tiers are the levels of key your hub gives, such as Basic, Plus and Pro. A new hub has no tiers. You add them from Tiers on the Keys page, lowest first. A key of a higher tier also counts as every tier below it.

Tiers in your script

Your script reads the player's tier and decides what each tier gets.

main.lua
local forge = ...

if forge.tier.rank >= 1 then
  -- Plus and above
end

print(forge.tier.name)   -- "Pro"
print(forge.expiresAt)   -- "2026-12-17T10:00:00Z", or nil for a key that never ends
print(forge.message)     -- your broadcast, or nil

The lowest tier has rank 0, the next has rank 1, and so on. forge is a local in your script, never a global. Other scripts in the executor can't read it.

Builds per tier

When you publish, Forge reads the tier checks in your script and makes a build for each group of tiers. A Basic key gets the Basic build, and the code behind forge.tier.rank >= 1 isn't in it.

Forge reads a tier's rank compared with a number and its name compared with a name, from Forge_TierRank and Forge_Tier or from forge.tier, through locals and and, or and not. Any other read of the tier runs on the player's device, and the code behind it goes to every tier. The script's page lists both under Tier checks, by line.

A script that changes forge.tier gets one build for every tier. Per-tier builds are on for every script. The switch is in the script's Settings, and Hub settings has one for the whole hub.

Minimum tier

Minimum tier refuses keys below a tier for a whole script. The script's code never reaches them.

  1. Minimum tier. Keys below Pro are refused for this script.
  2. Keyless. When it's on, anyone can run the script without a key, at rank 0.