# T1GER Gang System
#### [**View on Tebex**](https://store.t1ger.net/package/5579989) | [**CFX Forum Post**](https://forum.cfx.re/t/esx-qb-t1ger-gang-system/5048130) | [**YouTube Showcase**](https://youtu.be/7Twa3zFsxMo) | [**Discord**](https://discord.gg/t1ger)
## Highlights
**Admin Gang Menu** - Create and manage gangs effortlessly in-game. Adjust notoriety and cash, change leadership, or disable/delete gangs as needed.
**Player Gang Menu** - Permission-based menu for members to access action menu or request jobs. Higher-ranked members can manage the gang, invite new members, manage markers and ranks.
**Markers** - Create and manage markers for garage, stash, and cash-locker, accessible with/without pin-code.
**Action Menu** - Perform various actions like zip-tying, escorting, place players in vehicle or trunk, use headbags and taking hostages, all with immersive animations.
**Notoriety System**: Reputation-based system influencing gang activities and interactions. Jobs and gang-related activities will impact the gang's notoriety.
**Rackets** - Claim and compete for control of profitable rackets, such as prostitution racket or protection racket, each with their own job or activity to keep gang-members engaged.
**Drug Sale** - Sell drugs to NPCs with configurable prices, sell chances, and bonus areas. Avoid police alerts to build gang notoriety and maximize profits.
**Customization** - Extensive configurable options in config file(s) and a language file to handle all translations.
**Performance** - Maximum optimization resulting in smooth performance with low resource usage, even on large servers.
**Sync** - Fully synced across all players using OneSync Infinity and statebags.
## Information
### Chat Commands
{% hint style="info" %}
Please note, all these command strings are configurable and can be disabled as well.
{% endhint %}
{% tabs %}
{% tab title="client" %}
Command
Description
/admingang
Open the admin gang menu.
/gangmenu
Open the player gang menu.
/street
Prints street name at player coords (Config.Debug = true).
{% endtab %}
{% endtabs %}
### Exports
{% hint style="info" %}
These are available exports in the resource - use them as you please and find necessary.
{% endhint %}
{% tabs %}
{% tab title="client " %}
#### **Admin Gang Menu**
```lua
exports['t1ger_gangsystem']:AdminGangMenu()
```
Void:
* Opens the admin gang menu.
#### **Player Gang Menu**
```lua
exports['t1ger_gangsystem']:PlayerGangMenu()
```
Void:
* Opens the player gang menu.
#### Is Target Ziptied
```lua
exports['t1ger_gangsystem']:IsTargetZiptied(targetId)
```
Parameters:
* The target handle (target server id).
Returns:
* true/false (booleant)
Gets whether the target player is ziptied or not.
{% endtab %}
{% tab title="server" %}
#### Get Gang Data
```lua
exports['t1ger_gangsystem']:GetGangData(id)
```
Paramters:
* The gang handle (gang id).
Returns:
* id, name, notoriety, cash, leader, ranks, members, markers, disabled, rackets (table)
Gets gang data in a table from gang id.
#### Get Player Gang
```lua
exports['t1ger_gangsystem']:GetPlayerGang(playerSrc)
```
Paramters:
* The player handle (player server id).
Returns:
* id, name, notoriety, cash, leader, ranks, members, markers, disabled, rackets, player(array; name, identifier, rank, rankName) (table).
Gets the player's complete gang data in a table.
#### Get Player Gang Id
```lua
exports['t1ger_gangsystem']:GetPlayerGangId(playerSrc)
```
Paramters:
* The player handle (player server id).
Returns:
* gang id or 0 (int)
Gets the player's gang id or 0 if not a member of any gangs.
#### Get Player Gang Rank
```lua
exports['t1ger_gangsystem']:GetPlayerGangRank(playerSrc)
```
Paramters:
* The player handle (player server id).
Returns:
* rank id (int)
* rank name/label (string)
Gets the player's gang rank and rank name/label.
#### Get Gang Notoriety
```lua
exports['t1ger_gangsystem']:GetGangNotoriety(id)
```
Paramters:
* The gang handle (gang id).
Returns:
* gang notoriety (int).
Gets the gang's notoriety points.
#### Plus Gang Notoriety
```lua
exports['t1ger_gangsystem']:PlusGangNotoriety(id, amount)
```
Paramters:
* The gang handle (gang id).
* Amount to plus (int).
Adds x amount of points to the current gang notoriety points.
#### Minus Gang Notoriety
```lua
exports['t1ger_gangsystem']:MinusGangNotoriety(id, amount)
```
Paramters:
* The gang handle (gang id).
* Amount to minus (int).
Deducts x amount of points from the current gang notoriety points.
#### **Is Player Zip Tied**
```lua
exports['t1ger_gangsystem']:IsPlayerZiptied(playerSrc)
```
Paramters:
* The player handle (player server id).
Returns:
* The player's zip tied state (boolean).
Gets whether the player is zip tied or not.
#### **Set Player Zip Tied**
```lua
exports['t1ger_gangsystem']:SetPlayerZiptied(playerSrc, bool)
```
Paramters:
* The player handle (player server id).
* set zip tied (true) or remove zip tied (false)
Sets the player's ziptied state. In case you want to stop a player's ziptied state from another resource.
{% endtab %}
{% endtabs %}
### Events
{% hint style="info" %}
These are optional events that you may need to use from other resources to add compatibility.
{% endhint %}
{% tabs %}
{% tab title="client to server" %}
#### Plus Notoriety Points
```lua
TriggerServerEvent('gangsystem:server:plusNotoriety', gangId, points)
```
Paramters:
* The gang handle (gang id) or `nil` (script will find gang id from the source player).
* points to add (int).
Adds x points to the gangs current notoriety points.
#### Minus Notoriety Points
```lua
TriggerServerEvent('gangsystem:server:minusNotoriety', gangId, points)
```
Paramters:
* The gang handle (gang id) or `nil` (script will find gang id from the source player).
* points to deduct (int).
Deducts x points from the gangs current notoriety points.
#### Plus Gang Cash
```lua
TriggerServerEvent('gangsystem:server:plusGangCash', gangId, cashAmount)
```
Paramters:
* The gang handle (gang id) or `nil` (script will find gang id from the source player).
* cash to add (int).
Adds x cash to the gangs cash locker.
#### Minus Gang Cash
```lua
TriggerServerEvent('gangsystem:server:minusGangCash', gangId, cashAmount)
```
Paramters:
* The gang handle (gang id) or `nil` (script will find gang id from the source player).
* cash to deduct (int).
Deducts x cash from the gangs cash locker.
{% endtab %}
{% endtabs %}
## Support
### Common Issues
Before we proceed, please ensure the following:
1. Resource folder of the package is named: `t1ger_gangsystem`.
2. You have not touched nor edited files inside `t1ger_gangsystem/escrow/`.
3. You have not made any custom changes.
{% hint style="success" %}
**TITLE**\
[❓](https://emojipedia.org/question-mark/) Question/Issue
[✔️](https://emojiguide.com/symbols/check-mark/) Solution/Answer/Instruction
{% endhint %}
### Error Codes
If you getting an error code in your server- or client-console, then please find the error-code from below and fix your issue with the provided instructions.
{% tabs %}
{% tab title="Client" %}
{% endtab %}
{% tab title="Server" %} **#7983** - Inside `Config.DrugSale.Items` you've added/edited a key that does not have a reference to `Config.Items` that handles item names for these keys. Please add your key inside `Config.Items` and a respective item name for the key.
{% endtab %}
{% endtabs %}
---
# 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://docs.t1ger.net/resources/t1ger-gang-system.md?ask=
```
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.