# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://vanishdev.gitbook.io/vanishdev/gang-series/gangs-system/guides/gang-administration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.