Tiers
New gangs start at the bottom and earn their way up. Each tier unlocks more of the gang system, so a crew that formed yesterday can't start wars on day one.
🧗 The default ladder
| Tier | Requirements | Unlocks |
|---|---|---|
| Squad | Where every gang starts | Everything not locked below: corner selling, graffiti, hotspots, turfs, the daily spin… |
| Crew | Level 3 · 4 members · 2 days old | Contracts, market listings, racketeering, laundering, dealership |
| Gang | Level 8 · 6 members · 7 days old · 10 contracts | Turf rivalries, gang wars |
| Certified | Level 15 · 10 members · 14 days old · 1 turf · 1 war won · admin approval | Status. Can be used to limit leaderboard prizes |
Everything here (names, colours, requirements, what each tier unlocks, and how many tiers there are) can be changed in Admin → Tiers or shared/tiers.lua.
⬆️ Moving up
Automatic tiers
As soon as a gang meets every requirement of the next tier, it's promoted automatically. The server checks:
- every 5 minutes
- right after the gang levels up
- right after a new member joins
- whenever someone opens the Tier page
If a gang already meets several tiers, it climbs through them all at once. Every online member is notified: "Your gang has been promoted to Gang!"
Tiers that need approval
Tiers marked Admin approval (Certified by default) are never automatic:
- The gang meets all the requirements.
- The leader presses Request promotion on the tablet Tier page.
- Staff approve or deny it in Admin → Tiers → Requests. A denial can include a reason, which the gang sees.
Going down
Tiers are never lost automatically, even if members leave later. Only staff can move a gang down.
📊 Requirements you can use
| Requirement | Counts |
|---|---|
| Gang level | Current level |
| Members | Current member count |
| Days since founded | Age of the gang |
| Turfs owned | Turfs the gang owns right now |
| Wars won | Total wars won |
| Contracts completed | Total contracts completed |
| Hotspot captures | Total captures |
| Drugs sold | Total drugs sold |
🔒 Locked actions
If a gang tries something above its tier, it's blocked with "Your gang must reach Gang to do this." Locked tablet pages (Wars, Turfs, Contracts, Market, Dealership, Daily Spin) show a banner saying which tier is needed. Clicking it opens the Tier page.
| Lock | Blocks |
|---|---|
contracts | Starting contracts |
market | Listing items on the market |
racket | Collecting protection money, and business sale cuts |
laundering | Starting laundering runs |
dealership | Buying gang vehicles |
rivalry | Starting rivalries |
wars | Declaring and accepting wars |
spin | The daily spin |
🏷️ Where the tier shows
- A coloured badge next to the gang name in the tablet header. Click it to open the Tier page.
- The tablet Tier page.
- The gang's page in the admin panel (header and Summary).
- The gang activity log records promotions, requests and denials.
Existing servers: when tiers are first installed, every existing gang starts at the first tier and is immediately promoted as far as its stats allow. Established gangs that fall short (for example not enough contracts) may lose wars or rivalries until they catch up. Set their tier by hand in Admin → Tiers → Gangs, lower the requirements, or set Enabled = false until you're ready.