MG-Contest
MG-Contest is a competitive clan system for FiveM. Clans fight over timed territory contests, capture flags, climb an ELO ladder and progress through a seasonal battle pass, all from one in-game tablet.
Contest TabletThe item players use to open the UIFeatures
Clans
- Create a clan for a configurable price, with name, color and logo.
- Four ranks (Leader, CoLeader, Manager, Member) with separate invite, kick and promote permissions.
- Member slots that unlock as the clan levels up its battle pass.
- Profanity filter and blacklisted clan names.
Territory contests
- Contests start automatically on a 24-hour schedule, or manually from the admin panel.
- Each zone has its own duration, radius, flag and spawn points.
- Points for kills and flag captures; the winner gains ELO and the losers lose it.
- Vehicles are deleted inside active zones, and players without a clan are teleported out.
- Map voting before each scheduled contest decides which zone is played.
Combat
- Auto respawn on zone edges with spawn protection.
- Kill streaks (Triple Kill, Rampage, UnStoppable, GodLike) that grant HP, armor and cash.
- Bounty on players with high kill counts.
- Spectator mode while waiting to respawn.
- Result podium and rank-up animation when a contest ends.
Progression
- Eight ELO rank tiers, from Unranked to Legend.
- Personal and clan battle pass with 25 reward tiers (cash, items, weapons).
- Leaderboard, contest history and per-player stats.
Administration
- Admin panel (
/cmafia) with dashboard, clans, contests, players, bans, CCTV, live config and logs. - Access by exact Discord identifier only, stored server-side.
Interface
The tablet contains these pages: Home, Clan, Contest, Leaderboard, Ranks, History, Battle Pass and Settings. The UI accent color is configurable; see UI colors.
Compatibility
| Type | Supported |
|---|---|
| Framework | qbx_core, qb-core |
| Inventory | ox_inventory, qb-inventory |
| Target | interact, ox_target, qb-target |
| Database | oxmysql (required) |
| Notifications | Built-in NUI, ox_lib, framework |
| Phone (optional) | lb-phone, npwd, qb-phone |
| Medical | qbx_medical, qbx_ambulancejob, qb-ambulancejob, qb-hospital |
All integrations are detected automatically. See Systems to force a specific one.
Files you can edit
MG-Contest is protected by Cfx.re Escrow. Most of the code is encrypted, and only these files are open:
| File | What it's for |
|---|---|
config.lua | All gameplay settings: zones, contests, clans, rewards, battle pass. See Configuration. |
server/server.lua | Admin panel access (Discord IDs). See Admin Panel. |
server/sv_discord.lua | Optional Discord bot token for member avatars. See Discord avatars. |
shared/bridge.lua | Framework, inventory, target and notification integrations. |
install/ | SQL file, inventory item entries and the tablet image. |
html/img/ | Zone and rank images shown in the tablet. |
WARNING
Don't edit, rename or replace the encrypted files in client/ and server/. The resource won't start if they are changed.
