🔴Rivalries

A custom-built Rivalry System allowing gang members to stake claim on turf and ignite rivalries within those zones.

What are Rivalries?

Rivalries are high-stakes, time-limited competitions between gangs over control and dominance in a specific turf zone. These events introduce an element of strategic conflict and direct competition, pushing gangs to prove their supremacy through raw sales performance. Unlike passive turf control or long-term alliances, rivalries are aggressive, short-term contests designed to determine who can generate the most profit from drug sales within a defined time frame.

To initiate a rivalry, a gang must pay a configurable entry fee (default: $5,000). Once the rivalry begins, it runs for a set duration—by default, two hours—during which the system tracks and compares the drug sales of all participating gangs within that turf.

During the active rivalry, a specified percentage of each participating gang’s drug profits (default: 30%) is withheld and placed into an escrow fund. This fund acts as the prize pool for the event, growing proportionally to the turf’s drug activity. When the rivalry ends, the gang that has accumulated the highest total drug sales within the contested turf wins the event and claims the entire escrowed amount as a reward.

This mechanic not only fuels tension and conflict between factions but also encourages tactical planning, coordination, and risk-taking for high-reward outcomes.

Configuration Overview

The rivalry system is highly customizable and can be adjusted to fit your server’s economy and pacing. Here’s a breakdown of the key configuration settings:

Config.Rivalries = {
    enabled = true, -- Enables or disables the Rivalry system
    cost = 500, -- Cost in currency to initiate a rivalry (default: $5,000)
    duration = 2, -- Duration of the rivalry event, in hours
    escrowPercentage = 30, -- Percentage of all drug profits during the rivalry that go into the prize pool (0 - 100%)
    useDirtyCash = true, -- If true, the winning gang receives the prize in dirty money, deposited directly into the Gang Fund
}

These parameters allow server owners to tune the risk/reward balance, frequency, and intensity of rivalry events. Whether used for turf wars, temporary control struggles, or storyline-driven confrontations, rivalries serve as a powerful tool to deepen gang dynamics and enhance competitive roleplay.