Gang Management

This guide explains how gang leaders can manage their gangs directly in-game using the built-in Gang Management Menu.

Access Requirements:

  • Must be a gang leader (highest rank in your gang)

  • Access at configured management locations via interaction marker or NPC


πŸ“‹ Main Gang Management Menu Options

The management menu provides the following options:

1. Add Members

  • Invite new players to join your gang

  • Enter the target player's server ID

  • Player receives an invite notification

  • Player must accept the invite to join

  • New members start at rank 1

Restrictions:

  • Target player must be online

  • Target player cannot already be in a gang

  • Target player cannot have a pending invite


2. Manage Members

  • View all current gang members (online only)

  • Select a member to manage their rank or remove them

  • Each member shows their name and current rank

Available Actions per Member:

  • Promote - Increase their rank number

  • Demote - Decrease their rank number

  • Kick - Remove them from the gang immediately

Promotion/Demotion Rules:

  • New rank must be between 1 and your gang's maximum rank

  • Cannot promote members to the leadership rank

  • Cannot kick or demote gang leaders

  • Target player must be online


3. Inventory Access

  • Open your gang's shared stash/inventory

  • Protected by a 4-digit passcode

  • Passcode is set by server admins via the Gang Admin Menu

Access Process:

  1. Select "Inventory Access" from the menu

  2. Enter the gang's 4-digit passcode

  3. If correct, the stash opens immediately

  4. If incorrect or cancelled, access is denied with a notification


πŸ“ Management Locations

Gang leaders access the management menu at configured locations:

Single Location Mode

  • One fixed management point

  • Optional NPC interaction

  • Interaction via target system or marker press

Multiple Locations Mode

  • Several configurable management spots

  • Each location can have its own NPC

  • Useful for territory-based setups

Interaction Methods

  • Target System - Look at NPC or marker and use target key

  • Marker Interaction - Press E when near the marker

  • NPCs - Use scenario animations (e.g., clipboard, leaning)

  • NPCs are invincible and cannot be moved


πŸ”” Notifications & Chat Messages

Player Notifications

  • Invite Sent - Confirmation when you successfully invite someone

  • Access Denied - When attempting to use features without permission

  • Invalid Input - When entering invalid data (wrong passcode, invalid rank, etc.)

  • Player Offline - When trying to manage an offline member

  • Player Already in Gang - When inviting someone who's already in a gang

Chat Notifications

When enabled in config (config.management.notifications.enabled):

  • New member joins the gang

  • Member is kicked from the gang

  • Member leaves the gang


βš™οΈ Permissions & Restrictions

Leader-Only Features

Only gang leaders (players with the highest rank) can:

  • Access the Gang Management Menu

  • Invite new members

  • Promote/demote members

  • Kick members

Protection Rules

  • Leaders cannot be kicked from the gang

  • Leaders cannot be demoted

  • Cannot promote members to the leadership rank

  • Cannot manage offline players (except viewing in admin menu)

Failed Actions

When an action fails, you'll receive a notification explaining why:

  • "No permission" - Not a gang leader

  • "Player not online" - Target player is offline

  • "Player already in gang" - Cannot invite

  • "Player has outstanding invite" - Already invited by someone

  • Invalid passcode, rank, or input data


πŸ’‘ Tips for Gang Leaders

  1. Member Invites - Coordinate with potential members before sending invites

  2. Rank Structure - Understand your gang's rank hierarchy before promoting/demoting

  3. Passcode Security - Keep your gang's inventory passcode private

  4. Online Members - You can only manage members who are currently online

  5. HUD Display - Members see their gang info on the HUD (if enabled in config)

Last updated