How it works

Values are the defaults from config.lua.

Gangs

A gang is a job of your framework (for example ballas, families, vagos) registered in the admin panel. Every player with that job is a member of the gang. Players whose job is not a registered gang cannot conquer.

Conquering a zone

A gang member stands inside a territory and types /conquer.
The server checks:
- the zone is not locked, disabled or still protected (Config.CooldownHours after its last capture);
- the conquest window is open (Config.Schedule, if enabled);
- there are enough police online (Config.RequiredCops) and enough gang members online (Config.RequiredGangMembers);
- the player carries the Config.RequiredItems. They are removed.
The timer starts (Config.CaptureTime, 5 minutes). Other members of the same gang join with /conquer inside the zone.
The police get a dispatch alert, and every online member of the gang that holds the zone is warned.
If a member of another registered gang is alive inside the zone, the zone is contested and the timer stops until they are cleared.
If every attacker dies or leaves, the conquest fails and it counts as a defence for the holders.
When the timer reaches zero, the zone belongs to the attacking gang. Every member who took part gets the zone’s reward (Config.DefaultRewardAmount, $20,000 by default, editable per zone) in Config.RewardAccount. The zone is then protected for Config.CooldownHours.

Police liberation

A police officer (Config.PoliceJobName) stands inside an owned zone and types /freeterritory. After holding it for the capture time, the zone passes to the police and stays protected for one cooldown period.

Seeing the territories

Gang members type /seeterritories to show or hide the zones on the map, coloured by owner. Free zones are drawn with a dashed outline.

The gang panel

/territory opens the gang panel:

Tab	What it shows
Overview	Treasury (collect, deposit, next payout, last movements), zones held, conquests, defences, zones lost, total earned, live operations and city activity
My Territories	Every zone the gang holds, its status (under attack, protected) and a GPS button
Members	The gang’s members, their rank and who is online
Upgrades	Buy gang upgrades with the treasury
Leaderboard	Gangs ordered by zones held, then conquests, then earnings
Rules	How it works on this server: capture time, protection, members and police needed, reward, schedule

Passive income

Every Config.Income.IntervalMinutes (30) each zone pays AmountPerZone ($5,000) into the gang treasury, up to MaxStored. Members of rank CollectMinGrade or higher collect it from the panel into Config.Income.Account.

Members can also deposit their own money into the treasury to pay for upgrades (Config.Treasury).

Upgrades

Bought with the treasury, by members of rank Config.Upgrades.BuyMinGrade or higher.

Upgrade	Per level
Income	+25 % passive income
Vault	+$75,000 treasury capacity
Fortify	Rivals need +15 % more time to capture your zones
Shield	+4 hours of protection after your gang captures a zone

Each upgrade has 3 levels by default. Add or remove prices to change the maximum level.