Advanced Faction Panel

Advanced Faction System (ESX, QBox, QBCore)

Give your FiveM roleplay server a complete faction framework membership, leadership tools, live firearm tracking, staff drops, Discord logs, and custom nametags built for ESX, QBCore, and QBox.

The system is designed around ox_inventory serials, so every issued gun can be located in a player inventory, stash, vehicle, ground drop, NoLag property, or police evidence locker. A dedicated FM (Faction Management) panel lets staff create factions, send weapon drops, search serials, and manage access without touching the database.

Built for serious crime / gang RP communities. Features can be turned on or off per faction, ranks and commands are fully configurable, and the scan/cache layer is tuned for high player counts so panels stay fast on busy servers.

---

Core Features

• ESX, QBCore & QBox
• ox_inventory serial tracking (required)
• NoLag Properties stash support
• Wasabi police / evidence locker detection
• Custom NUI (member, leader, FM, nametags)
• Performance-focused (high-pop caches, scan limits, spatial nametag grid)
• Clean, modern panels with toasts and ESC close
• Huge configuration — ranks, tabs, webhooks, nametags, police jobs
• Discord webhooks for drops, weapons, stashes, and faction kills
• FiveM ToS friendly (no spawning weapons for players outside ox_inventory drops)

---

Included Systems

Member Panel (/fpanel or /factionpanel) Overview stats, roster, announcements, faction chat (all members + leadership channel), and activity / playtime. Rank-based UI — residents and members get the member view automatically.

Leader Panel (/fpanel or /leaderpanel) Everything in the member panel plus invites, rank changes, kicks, strikes, announcements, weapons list with live locations, drop history, ally/enemy tabs (optional), and Discord webhook settings. Leadership tools can be disabled per faction from FM.

Faction Management / FM Panel (/FMpanel) Staff-only. Create / delete factions, set tier, appoint leaders (invite UI, never force-join), add/remove members, issue or clear strikes, lookup any online player, search any tracked serial, build the weapon pool, and send drops. Access is ESX groups / QB permissions plus character grants via /setfm.

Weapon Drops FM staff pick a faction, tier, weapons, ammo, and recipients (leadership ranks by default). Guns are given through ox_inventory with unique serials, logged in drop history, and immediately tracked. Random drop, ox_inventory import, and vanilla GTA weapon filter included.

Live Serial Tracker Locate a serial across online players, ox stashes, trunks/gloveboxes, ground drops, NoLag property_* stashes, and police evidence. Faction leaders see last-known location; FM can GPS, teleport to ground drops, and revoke a gun back into staff inventory.

Police Possession Configurable jobs (police, sheriff, bcso, etc.) and evidence stash patterns (wasabi + custom). When a tracked gun hits PD evidence or a cop’s inventory, webhooks fire and tracking can pause until it’s released.

Discord Logging

• FM drop webhook — recipients, serials, ammo, staff Discord ping
• Faction weapons webhook — drops, P2P passes, theft, revokes, lost guns
• Stash webhook — deposit / withdraw
• Kill webhook — faction member deaths (weapon, distance, location, Discord IDs); optional war-only filter when enemies are enabled

Nametags (/nametags) Short-range native overhead tags with fade, GTA fonts, per-type colors (default / faction / marked), nicknames (/nick), optional nationality & height, mask hiding (/masktoggle), /mark targets, and per-player font assignments. Names stay Unknown until you’ve been near someone long enough (configurable reveal).

Playtime & Activity Per-character and per-faction session tracking, daily rollups, charts in the panel, and FM tools to add/remove hours. Batched flushes for high pop.

Chat & Commands /fchat, /hidefchat, /fannouncement, /faction, /fonline, /leavefaction, /factionaccept. In-panel chat with search, leadership-only channel, and optional join/leave system messages.

Relationships (optional) Allies and enemies can be hidden globally. When enabled, enemy wars can gate kill logs. FM can still toggle these per faction.

---

Config Snapshot You can tweak or disable almost everything:

• Framework (esx / qb / qbox / auto)
• Commands and rank ladder
• Who can open leader panel, post announcements, use leadership chat
• FM panel groups / permissions (admin, god, management, …)
• Max members, strikes, serials, drop history, invite expiry
• Allies / enemies / FM relationship tabs
• Drop tiers, default ammo, ox_inventory resource name
• Police jobs, evidence stash patterns, NoLag properties
• Nametag distance, fade, reveal time, fonts, colors, mask behavior
• Discord webhook colors and kill-log jobs
• Performance: scan rate, cache TTLs, vehicle sweep, playtime batch size
• Per-faction feature toggles (invites, ranks, strikes, weapons, drops, chat messages, …)

---

How to Use

Players

1. Get invited (on-screen prompt or /factionaccept).
2. Open /fpanel for your panel (member or leader, based on rank).
3. Use /fchat, /faction, /fonline, /leavefaction as needed.
4. Open /nametags to set colors, font, nickname, and mark players.

Leadership

1. /fpanel or /leaderpanel.
2. Invite by server ID, change ranks, kick, strike, post announcements.
3. Check Weapons for live serial locations; set faction Discord webhooks in Settings.

FM Staff

1. Groups in Config.FMPanelGroups, or /setfm [id] on a character (/unsetfm to remove).
2. /FMpanel — create faction, set tier, offer leader, manage roster.
3. Weapon Pool — import from ox_inventory or paste weapons.lua, assign tiers, save.
4. Send Drops — pick faction, weapons, ammo, recipients → Send (or Random Drop).
5. Serial Search — partial match + live scan; Locate / GPS / Teleport / Revoke.
6. Settings — drop & kill webhooks, FM display name, per-faction feature toggles.

Install

1. Ensure oxmysql and ox_inventory start before this resource.
2. Start CDSFactionSystem (SQL tables are created automatically).
3. Set Config.Framework to esx, qb, qbox, or auto.
4. Set Config.FMPanelGroups to your staff groups.
5. Restart the resource.

---

Requirements

• oxmysql
• ox_inventory
• ESX Legacy or QBCore or QBox
• nolag_properties (optional — property stash tracking; Config.NoLagPropertiesEnabled)
• wasabi_police / wasabi_evidence (optional — evidence locker patterns)
• ox_lib (optional — clipboard copy in FM panel only)