SKP Gangs

SKP Gangs

$20.00

Add to Basket

SKP_Gangs - Complete Gang System with Immersive Raid Mechanics

The most comprehensive gang management system for RedM/VORP servers. Transform your server with territorial control, shared resources, democratic leadership, and intense PvPvE raid battles. SKP_Gangs combines a beautiful Western journal UI, physical headquarters system, rank-based permissions, shared economy, and a fully-realized raid system where gangs attack and defend with NPC reinforcements.

🎯 CORE FEATURES

🎫 Gang Token Creation System

  • Item-Based Creation - Use a Gang Token item to open the creation journal (integrates with your economy)

  • One Gang Per Character - Strict enforcement using character identifiers prevents multi-gang exploits

  • Physical HQ Placement - Press G to place your gang's headquarters barrel anywhere in the world

  • Persistent Location - HQ coordinates saved to database and visible as a physical prop

  • Admin Control - You decide how players obtain tokens (shops, quests, rewards)

  • Included Item Images - Professional artwork for gang_token.png, gang_intel.png, and crowbar.png

🏛️ Physical Headquarters

Every gang gets a real, physical presence in the world:

  • Barrel Prop - Visible to all players at the chosen location (configurable model)

  • Proximity Interaction - Gang members press G near the barrel to open the journal

  • Territorial Gameplay - HQs create natural conflict points and strategic locations

  • Raid Targets - This physical location becomes the point of attack for enemies

  • Configurable Settings - Customize prop model, interaction distance, and spawn behavior

📚 Beautiful Journal Interface

Immersive Western-themed journal UI accessed by interacting with your HQ. 7 detailed tabs:

📋 Overview Tab

  • View gang name, member count, and ledger balance

  • Invite Inbox - Accept or decline invitations to join gangs

  • Leader Vote Status - See active votes, cast your ballot (yes/no)

  • Quick stats showing online members and gang wealth

👥 Members Tab

  • Real-time roster with online/offline indicators

  • Last Seen Timestamps - Track when offline members were last active

  • Rank Badges - Visual display of each member's rank

  • Invite System - Enter player ID to send invites (30-second cooldown)

  • Management Tools - Promote, demote, and kick members (permission-based)

  • Members sorted by rank, then join date

⭐ Ranks Tab

5-Level Hierarchy:

  • Leader (5) - Supreme authority with all permissions

  • Underboss (4) - Second-in-command, management access

  • Enforcer (3) - Senior member, invite and storage

  • Soldier (2) - Trusted member, can invite

  • Prospect (1) - New recruit, limited access

Granular Permission System:

  • 👥 Invite members

  • 💰 Withdraw from ledger

  • 📦 Access storage

  • ⬆️ Promote/demote others

  • 👢 Kick members

  • 📜 Edit gang rules

View member count per rank and understand your gang's power structure.

💰 Ledger Tab - Shared Banking

  • Gang Bank Account - Pooled money for the organization

  • Deposit Money - All ranks can contribute (configurable limits: $1-$250,000)

  • Withdraw Money - Leaders and Underbosses only (by default)

  • Transaction History - View recent deposits/withdrawals with names and timestamps

  • Real-time Updates - Balance updates instantly

  • Activity Logging - All transactions recorded

Perfect for collecting dues, pooling resources for purchases, storing raid profits, or managing gang finances.

📦 Storage Tab - Shared Inventory

  • VORP Custom Inventory - Native integration with VORP's inventory system

  • Shared Warehouse - Store items, weapons, ammo, resources, and valuables

  • Persistent Storage - Items remain between server restarts

  • Weight Limits - Respects VORP capacity settings

  • Access Control - Only members with storage permission can open

  • Use Cases - Shared resources, raid prep, business operations, backup supplies

All ranks have storage access by default (fully configurable).

📜 Rules Tab - Gang Constitution

  • Text Editor - Leaders write and save gang rules

  • Everyone Can View - All members can read the established code

  • Unlimited Length - Write detailed constitutions or simple bullet points

  • RP Tool - Perfect for establishing character guidelines, operational procedures, and gang culture

  • Persistent - Saved to database

📊 Activity Log Tab

Chronological record of all gang activities:

  • Member events (joined, left, kicked, promoted)

  • Ledger transactions (deposits, withdrawals)

  • Storage access logs

  • Leader votes (started, voted, results)

  • Raids (initiated, defended, results)

  • HQ placement/relocation

Features:

  • Last 50 events displayed in-game

  • Full history stored in database

  • Optional Discord webhook integration for real-time notifications

  • Color-coded entries with timestamps

  • Perfect for accountability and admin investigations

⚔️ RAID SYSTEM - THE CROWN JEWEL

The raid system is a complete PvPvE experience that transforms gang conflict into actual territorial combat.

How Raids Work

Step 1: Preparation

  • Acquire Gang Intel + Crowbar items (configurable names)

  • Scout enemy HQ location

  • Gather your crew (optional but recommended)

Step 2: Initiation

  • Travel to enemy gang's headquarters barrel

  • Press G to start the raid

  • Items are consumed (or kept, based on config)

Step 3: Breach Phase (5 Minutes)

  • Timer Countdown - Displayed on screen

  • NPC Defenders Spawn - Armed bandits appear within 50m radius

  • Fight to Survive - Kill NPCs while timer runs down

  • Alerts Sent - All online enemy gang members get notified with coordinates

  • Defend or Die - Enemy players can join the fight to defend

Step 4: Loot Phase

  • After timer expires, return to the barrel

  • New prompt appears: "Loot HQ"

  • Press G to access:

    • Ledger Theft - Steal 20% of their bank (capped at $5,000)

    • Storage Access - 5-minute window to loot items from gang storage

  • Take what you can carry and escape

Step 5: Cooldown

  • Target HQ enters 60-minute cooldown (configurable)

  • Cannot be raided again during cooldown

  • Prevents grief and spam raiding

NPC Defender System

Configurable Combat:

Config.Raids.NpcWave = {
  Enabled = true,                    -- Toggle NPC defenders
  Count = 1,                         -- How many NPCs spawn (1-10+)
  SpawnRadius = 50.0,                -- Distance from HQ
  Model = "g_m_m_unibanditos_01",    -- NPC model (Mexican bandits)
  Weapon = 0x169F59F7                -- Weapon hash (revolver)
}

NPC Features:

  • Aggressive AI attacks raiders on sight

  • Armed with configurable weapons

  • Can spawn in waves for increased difficulty

  • Disable entirely for PvP-only raids

  • Customize model and weapons for gang themes

Difficulty Scaling:

  • Easy: 1 NPC with pistol

  • Medium: 3-5 NPCs with revolvers

  • Hard: 10+ NPCs with rifles

  • Boss Fight: 1 tough NPC with powerful weapon

Defending Your HQ

When Raided:

  • Instant Alerts - All online members notified with sound + on-screen message

  • Coordinates Shown - Know exactly where to respond

  • Join the Fight - Help NPCs defend your territory

  • Protect Assets - Kill raiders before timer expires

  • Success = Safety - If raiders die/flee, your stuff is safe

Defender Advantages:

  • Know the terrain

  • NPC allies fight alongside you

  • Bring your whole gang

  • Pre-stocked weapons in storage

Raid Configuration

Full Customization:

Config.Raids = {
  Enabled = true,
  IntelItem = "gang_intel",          -- Required item 1
  ToolItem = "crowbar",              -- Required item 2
  MinDefendersOnline = 0,            -- Require enemies online (0 = anytime)
  BreachSeconds = 300,               -- Fight phase duration (5 min)
  BreachLootSeconds = 300,           -- Loot window (5 min)
  CooldownMinutes = 60,              -- Time before can raid again
  LedgerStealPercent = 20,           -- % of money to steal
  LedgerStealCap = 5000,             -- Max $ per raid
}

Adjust Settings For Your Server:

  • PvP Focused: Disable NPCs, reduce cooldowns, allow offline raiding

  • RP Balanced: Default settings provide fair, engaging raids

  • PvE Friendly: Increase NPC count, require defenders online, longer cooldowns

Raid Items Included

All item images provided:

  • gang_intel.png - Spy documents artwork

  • crowbar.png - Western-era tool

  • gang_token.png - Gang creation token

Add to your VORP items table and they're ready to use.

🎖️ LEADERSHIP & VOTING SYSTEM

Democratic Leader Changes

Unanimous Voting Requirement:

  • Any Officer+ can nominate a new leader

  • ALL gang members must vote yes to approve

  • If even one member votes no, the vote fails

  • Creates democratic gang governance

Voting Process:

  1. Officer+ starts vote via journal (nominates candidate)
  2. All members see vote status in Overview tab
  3. Members cast yes/no votes
  4. Vote expires after configurable time
  5. If unanimous yes → New leader appointed
  6. If any no → Vote fails, current leader remains

Vote Tracking:

  • See vote progress in real-time

  • Shows: Candidate name, vote starter, yes count / needed count

  • Time remaining clearly displayed

  • Results logged in activity feed

Perfect For:

  • RP servers with democratic gang structures

  • Preventing leader inactivity issues

  • Creating gang politics and intrigue

  • Ensuring leadership changes are consensual

Rank Permission Matrix

Fully configurable permissions system. Default structure:

Permission

Prospect

Soldier

Enforcer

Underboss

Leader

Invite Members

❌

✅

✅

✅

✅

Withdraw Money

❌

❌

❌

✅

✅

Access Storage

✅

✅

✅

✅

✅

Promote/Demote

❌

❌

❌

✅

✅

Kick Members

❌

❌

❌

✅

✅

Edit Rules

❌

❌

❌

❌

✅

Customize In Code: Edit the permissions matrix in server.lua to match your server's needs. You can:

  • Restrict storage to officers only

  • Allow all ranks to withdraw

  • Give Enforcers kick permissions

  • Create custom rank names

  • Add new permission types

🛠️ ADMIN COMMANDS

Full server control with in-game commands:

/gangcreate       - Create gang (bypasses token)
/gangdelete                   - Permanently delete gang
/gangsetleader      - Force change leader
/gangaddmember      - Add member (bypasses invite)
/gangremovemember   - Remove/kick member
/gangsetmax       - Adjust member limit (capped by Config.MaxMembers)

Admin Use Cases:

  • Create official server gangs

  • Resolve stuck leadership issues

  • Remove problem members

  • Adjust gang sizes for balance

  • Quickly set up test gangs

All commands respect VORP admin permissions.

📊 DISCORD WEBHOOK INTEGRATION

Optional real-time logging to Discord:

Enable in config:

Config.Webhook = {
  Enabled = true,
  Url = "your_webhook_url_here",
  Name = "SKP_Gangs"
}

Events Logged:

  • Gang created/deleted

  • HQ placed

  • Invites sent, accepted, declined

  • Ledger deposits and withdrawals (including denied attempts)

  • Leader votes (started, voted, passed, failed)

  • Storage accessed

  • Raids initiated and completed

  • Members promoted, demoted, kicked

Perfect For:

  • Admin monitoring

  • Community transparency

  • Automatic gang announcements

  • Server statistics tracking

  • Moderation and dispute resolution

🗄️ DATABASE STRUCTURE

8 MySQL Tables (auto-create on first start):

  • skp_gangs - Gang information (name, leader, balance, HQ coords)

  • skp_gang_ranks - Custom rank configurations per gang

  • skp_gang_members - Member roster with ranks and timestamps

  • skp_gang_ledger - Transaction history

  • skp_gang_activity - Activity log entries

  • skp_gang_invites - Pending and processed invitations

  • skp_gang_votes - Active and historical leadership votes

  • skp_gang_vote_ballots - Individual vote records

Automatic Setup: Tables auto-create on resource start (requires SQL permissions). If auto-creation fails, manual SQL provided in README.md.

⚙️ REQUIREMENTS

  • RedM Server

  • vorp_core - Core framework

  • vorp_inventory - For storage system

  • oxmysql or mysql-async - Database connector

🚀 INSTALLATION

  1. Extract SKP_Gangs to your resources folder

  2. Add to server.cfg:

    ensure vorp_coreensure vorp_inventoryensure oxmysqlensure SKP_Gangs

  3. Add 3 items to your VORP items database:

    • gang_token (usable) - Creates gangs

    • gang_intel (usable) - Required for raids

    • crowbar (usable) - Required for raids

  4. Start server (tables auto-create)

  5. Give players gang tokens to begin!

🎮 PLAYER WORKFLOW

Creating a Gang:

  1. Use Gang Token item
  2. Fill out creation form in journal
  3. Press G to place HQ barrel in world
  4. Walk to barrel and press G to access journal

Managing Your Gang:

  • Invite - Members tab → Enter player ID

  • Deposit Money - Ledger tab → Contribute to bank

  • Withdraw - Leaders/Underbosses can take from ledger

  • Storage - Store shared items in gang warehouse

  • Promote - Underbosses can promote deserving members

  • Rules - Leader establishes gang code of conduct

  • Vote - Participate in democratic leader changes

Raiding:

  1. Acquire Gang Intel + Crowbar
  2. Find enemy HQ location
  3. Press G on their barrel to start raid
  4. Fight NPC defenders for 5 minutes
  5. Return to barrel to loot ledger and storage
  6. Escape with your spoils

🎨 CUSTOMIZATION

Everything is Configurable:

  • HQ prop model and interaction distance

  • Rank names and permission matrix

  • Ledger transaction limits

  • Member limits per gang

  • Invite cooldown duration

  • Raid timers (breach, loot, cooldown)

  • NPC count, models, and weapons

  • Raid reward percentages and caps

  • Required raid items

  • Discord webhook settings

Edit config.lua for most settings, server.lua for advanced customization.

💡 PERFECT FOR

  • RP Servers - Organized crime families with structure

  • PvP Servers - Territorial control and gang wars

  • Economy Servers - Shared gang businesses and resources

  • Raiding Servers - Base attacks with defend mechanics

  • Gang Roleplay - Democratic leadership and internal politics

✅ FEATURE CHECKLIST

✅ Item-based gang creation (Gang Token) ✅ Physical HQ system with barrel props ✅ Beautiful Western journal UI with 7 tabs ✅ 5-level rank hierarchy with granular permissions ✅ Shared gang bank account (Ledger) ✅ Shared inventory system (Storage via VORP) ✅ Leader-editable gang rules ✅ Democratic voting system for leadership changes ✅ Invite system with cooldowns ✅ Real-time online/offline member tracking ✅ Last seen timestamps for offline members ✅ Complete raid system with NPC defenders ✅ Configurable raid rewards and cooldowns ✅ Raid alerts for defenders ✅ Activity logging with in-game display ✅ Discord webhook integration ✅ Admin commands for full control ✅ One gang per character enforcement ✅ Auto-creating database tables ✅ Professional item artwork included ✅ Fully documented configuration

🎯 WHY CHOOSE SKP_GANGS?

Most Complete System Available:

  • Not just a chat group - full territorial gameplay

  • Raids aren't just PvP - includes PvE defenders

  • Not just a menu - beautiful immersive UI

  • Not just ranks - actual meaningful permissions

  • Not just storage - complete shared economy

Production Ready:

  • Tested on live servers with 100+ players

  • Optimized database queries

  • Comprehensive error handling

  • Detailed documentation included

  • Professional artwork and UI design

Actively Supported:

  • Installation support provided

  • Bug fixes addressed

  • Configuration assistance available

Transform your RedM server's gang gameplay from simple chat groups into organized criminal empires with territorial control, shared resources, and intense raid battles. SKP_Gangs is the complete solution.


Video: https://youtu.be/hoMPa32FRpc


RP Server: https://discord.gg/2b9XNJ6ZPE
Dev Server: https://discord.gg/j6EkxwHkVS