Gang Actions

Overview

Gang members can perform various criminal activities to earn points and money for their gang. Each action has a specific point reward that contributes to the gang's level progression.

Graffiti Creation (20 points)

Create custom graffiti to mark your gang's territory.

Requirements:

• Spray can item

How to use:

1. Equip a spray can
2. Use command: /spray <word> (max 9 characters)
3. Aim at a flat wall
4. Complete the progress bar (20 seconds)

Configuration:

Points.graffiti = 20
Config.progressBarDuration = 20000  -- 20 seconds
Config.sprayPersist = 2  -- Hours graffiti remains
Config.blacklist = {'word1', 'word2'}  -- Banned words

Features:

• Custom text on walls
• Blacklist system for inappropriate words
• Timed persistence (configurable)
• Spray remover to clean enemy graffiti

Store Extortion (30 points)

Collect protection money from stores across the city.

Requirements:

• Be near a registered store location

How it works:

• Stores generate money hourly automatically
• Press E near a store to collect accumulated money
• Each store has a balance that increases over time

Configuration:

Points.collectMoney = 30
Config.CollectMoneyAmountPerHour = 60  -- Money generated per hour
Config.CollectMoneyMultiplier = 2  -- Multiplier for calculations

Default Stores:

• 72 pre-configured store locations
• Includes gas stations, shops, restaurants, and more
• Admins can add/remove stores dynamically

Drug Dealing (50 points)

Sell drugs to random NPCs on the street.

Requirements:

• Drugs in inventory (configurable items)
• Find a random NPC

How to use:

1. Have drugs in your inventory
2. Approach a random NPC
3. Press E to offer drugs
4. NPC may accept or alert police (configurable chance)

Configuration:

Points.drugDealing = 50
AO.drugDealingAmount = math.random(50, 200)  -- Money earned
AO.drugDealingPolice = 100  -- % chance to alert police
AO.allowedDrugs = {'weed_white-widow', 'cocaine', 'lsd'}

Police Alert:

• Configurable chance for NPCs to call police
• Dispatch alert sent if enabled

Contract Killing (75 points)

Accept assassination contracts on random targets.

Requirements:

• Start mission via command or cron system

How to use:

1. Use command: /gangkill (or configured command)
2. Receive target location on map
3. Locate and eliminate the target
4. Police may be notified upon kill

Configuration:

Points.contractKilling = 75
Actions.ContractKillingCommand = "gangkill"
AO.contractKillingAmount = math.random(50, 200)
AO.contractKillingPolice = true  -- Alert police on kill

Features:

• Random target locations
• Map marker for target
• Optional police notification
• Reward money on completion

Smuggling (50 points)

Pick up and deliver contraband packages.

Requirements:

• Start mission via command or cron system

How to use:

1. Use command: /gangsmuggling (or configured command)
2. Go to pickup location (marked on map)
3. Pick up the contraband (police may be alerted)
4. Deliver to drop-off location
5. Complete delivery for reward

Configuration:

Points.smuggling = 50
Actions.SmugglingCommand = "gangsmuggling"
AO.smugglingAmount = math.random(50, 200)
AO.smugglingProp = "ex_office_swag_drugbag2"
AO.smugglingPolice = true  -- Alert police on pickup

Features:

• Dynamic pickup/delivery locations
• Visual prop when carrying contraband
• Police alert system
• Reward on successful delivery

Illegal People Transportation (75 points)

Transport illegal persons to a safe location.

Requirements:

• Vehicle with enough seats
• Start mission via command or cron system

How to use:

1. Use command: /gangpeople (or configured command)
2. Go to pickup location
3. Pick up illegal persons (requires vehicle)
4. Police may be alerted at pickup
5. Transport to delivery location
6. Complete delivery for reward

Configuration:

Points.illegalPeople = 75
Actions.IllegalPeopleCommand = "gangpeople"
AO.illegalPeopleAmount = math.random(50, 200)
AO.illegalPeopleFinalLocation = vector3(555.93, -1797.35, 29.2)
AO.illegalPeoplePolice = true  -- Alert police at pickup

Features:

• Requires vehicle with capacity
• NPCs enter vehicle
• Delivery destination on map
• Police alert system

Cron System

Automate mission triggers at specific hours:

Config.useCron = true
Config.cronHours = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24}

When enabled, missions will automatically become available to gang members at the configured hours.

Points & Leveling

All actions contribute points to your gang:

• Points accumulate toward next level
• Each level requires 1500 points (configurable)
• 50 unique level descriptions
• Gang rankings based on level and points
• Territory control reflects gang power

Police Integration

Most actions support police dispatch alerts:

• Configure dispatch function in config
• Set probability for each action type
• Customize alert messages
• Integration examples provided for cd_dispatch