Gang Administration

This guide explains how server admins can manage gangs directly in-game using the built-in Gang Admin Menu.

Access Methods:

• Execute the /gangadmin command in-game

• Use the configurable keybind (set via config.admin.keybind in shared config)

Permission Requirements: Admin permissions are controlled through config.admin.permissions which supports:

• ACE permissions (ace)

• ESX groups (group)

• Custom permission functions

---

📋 Main Admin Menu Options

When opening the Gang Admin Menu, you'll see:

1. Create Gang - Opens dialog to create a new gang organization

2. Gang List - View and manage all existing gangs (each gang opens its Gang Management Menu)

---

🧩 Gang Management Menu

For each gang, you have access to the following options:

1. Create Rank - Add a new rank to this gang's hierarchy

2. Manage Ranks - Opens the Rank Management Menu for detailed rank control

3. Set Passcode - Update the gang's inventory/stash access code (4-digit PIN)

4. Delete Gang - Permanently remove the gang and all associated data

   • Removes all members from the gang

   • Deletes all gang ranks

   • Removes gang from database

---

🧱 Rank Management Menu

Ranks are numbered starting from 1 (lowest) up to the leadership rank (highest).

Important: The leadership rank number is defined when creating the gang and represents the highest authority level.

Within Each Gang's Rank Manager:

For Each Rank:

• View Details - See rank name, label, and position in hierarchy

• Edit Rank - Modify rank name and display label

• Change Position - Reorder rank in the hierarchy (change rank number)

• Delete Rank - Remove rank from gang

  • Members with this rank are automatically moved to rank 1

  • Quick deletion available via right-click or long-press

Rank Constraints:

• Rank numbers must be between 1 and the gang's leadership rank

• Each rank must have a unique number within the gang

• Rank names must start with a letter and be alphanumeric

• Leadership rank (highest number) cannot be assigned through promotion - it's reserved for gang leaders

---

🆕 Creating a Gang

When creating a new gang, you'll be prompted for:

1. Gang Name - Unique identifier (alphanumeric, must start with a letter, lowercase)

2. Gang Label - Display name shown to players

3. Leadership Rank - Highest rank number (defines gang hierarchy depth)

4. Passcode - 4-digit PIN for inventory/stash access

Example:

• Name: ballas

• Label: The Ballas

• Leadership Rank: 5 (creates ranks 1-5, where 5 is leader)

• Passcode: 1234

---

🔧 Creating a Rank

When creating a new rank, you'll be prompted for:

1. Gang - Select which gang this rank belongs to

2. Rank Name - Internal identifier (alphanumeric, must start with a letter, lowercase)

3. Rank Label - Display name shown to players

4. Rank Number - Position in hierarchy (1 to leadership rank)

Example:

• Gang: ballas

• Name: soldier

• Label: Soldier

• Rank Number: 3

Requirements:

• Rank number must be within the gang's range (1 to leadership rank)

• Rank name must be unique within the gang

• Rank number must not already exist for this gang

---

⚠️ Important Notes

• Deleting a gang removes ALL associated data including members and ranks

• Deleting a rank automatically demotes affected members to rank 1

• Passcodes must be exactly 4 digits

• Leadership ranks (highest rank number) have special privileges and cannot be promoted to

• All changes take effect immediately and update the cache automatically

• Member management (invite, kick, promote, demote) is handled by gang leaders through the in-game gang menu