👊nova_grupos

NOVA Framework groups/gangs system. Full organization management with roles, bank, stash, uniforms, radio frequencies, and farming activities.

Features

• Group Management — Create, edit, disband organizations

• Role Hierarchy — Leader, Co-Leader, Gerente, Elite, Recrutador, Membro, Novato

• Group Bank — Deposit and withdraw funds

• Invites — Invite players to join with expiry timer

• Kick & Promote — Manage members within the organization

• Uniforms — Save and equip group uniforms

• Radio Frequencies — Dedicated radio channels per group

• Group Stash — Shared inventory storage

• Bases — Group HQ locations with map blips

• Farm Activities — Cocaine, weed, meth, guns, armor production

• XP System — Earn XP from kills, sprays, playtime

• Admin Panel — Create, delete, edit groups via admin interface

Configuration

Edit config.lua:

GruposConfig = {
    Roles = {
        'novato', 'membro', 'recrutador',
        'elite', 'gerente', 'co-leader', 'leader'
    },

    Permissions = {
        invite = 'recrutador',
        kick = 'gerente',
        withdraw = 'gerente',
        promote = 'co-leader',
        uniform = 'elite',
        radio = 'membro',
        settings = 'leader',
        disband = 'leader',
    },

    Limits = {
        MaxMembers = 30,
        MaxNameLength = 24,
        MaxBankDeposit = 100000,
        MaxBankWithdraw = 50000,
        InviteExpiry = 300,        -- 5 minutes
        MaxRadioFreqs = 3,
        MaxUniforms = 5,
    },

    Admin = {
        Permission = 'admin',
        Command = 'gangadmin',
        CommandOpen = 'gangs',
    },
}

Role Hierarchy

Grade	Role	Description
0	Novato	New member, limited permissions
1	Membro	Standard member
2	Recrutador	Can invite new members
3	Elite	Can manage uniforms
4	Gerente	Can kick members and manage bank
5	Co-Leader	Can promote members
6	Leader	Full control, can disband group

Permission Matrix

Action	Minimum Role
Invite	Recrutador
Kick	Gerente
Bank Withdraw	Gerente
Promote	Co-Leader
Uniforms	Elite
Radio	Membro
Settings	Leader
Disband	Leader

Dependencies

• nova_core — Player data, jobs/gangs system

• oxmysql — Database operations

Notes

• Groups are stored in the database with full persistence

• The admin panel allows server staff to manage all groups

• Farm activities have cooldowns and require the player to be at specific locations

• XP contributes to a group leaderboard

• The NUI provides a modern interface for all group management operations

Security

• All actions are validated server-side with permission checks

• Event names and internal implementation details are not disclosed in this documentation for security purposes

• Unauthorized access attempts are logged