Mango Achievements

Give your players something to chase

Most servers have nothing between "joined" and "bored". People do the same three jobs, drive the same three cars, and drift off after a fortnight because nothing ever told them they were getting anywhere.

Mango Achievements is a PlayStation-style trophy system for FiveM. Awards unlock as people actually play, progress is saved to your database forever, and every unlock lands as a polished on-screen celebration with its own sound, artwork and animation.

It ships with 41 ready-made awards across crime, policing, EMS, prison, jobs, driving, exploration and social play, plus 50 icons. Install it, restart, and your players start earning immediately. Nothing else on your server needs changing.

Real rarity, not a made-up number

Every award shows the true share of your players who hold it, counted from your own database. "2.4% of players have this achievement" means exactly that. A server-wide leaderboard ranks everyone, online or not, by achievement points, with the top three in gold, silver and bronze.

Rewards that never go missing

Awards can pay money, items, or fire your own event. Payouts are granted server-side exactly once, in the same database write as the completion, so a reconnect or a restart can never pay twice. If a player's inventory is full, the item is not lost: the award grows a Claim button and they collect it once they have room, even days later.

Secrets that stay secret

The achievement file is server-only. A hidden award a player has not earned reaches their client as nothing but an id and a point value. The name, description, icon and goal never leave the server, so they cannot be datamined out of the resource files.

Build awards without writing Lua

A visual setup tool ships with the resource as a single HTML page. Import your file, edit every field as a form, pick icons visually, chain tiers and prerequisites, set time windows, and export a clean file that drops straight back in. Reload live with one command, no restart.

Works with what you already run

Auto-detects ESX, QBCore, Qbox or standalone. Item rewards go through an inventory bridge covering ox_inventory, qs-inventory, origen_inventory, codem-inventory and qb-inventory. Connect your prison, police, EMS, robbery and job scripts by event name in one config file, or feed progress from any resource with a single export.

Requirements

oxmysql. Everything else is optional and detected at runtime.

[mango_product_info]

[features]

[feature icon="trophy" title="Full-Screen Trophy List"]

Every award with live progress bars, search, filters by status, category and rarity, five sort orders and console-style trophy counters. Opens instantly from data the client already holds.

[/feature]

[feature icon="bell" title="Unlock Celebrations"]

Rarity-coloured toasts with artwork, light burst, sparks, an animated point counter and a draining timer, backed by per-rarity sounds and a cheer animation on the ped. Queued so a burst of unlocks stays readable.

[/feature]

[feature icon="percent" title="Real Rarity"]

The true percentage of your players holding each award, counted from your own database on a configurable interval. Two cheap aggregate queries, never per player.

[/feature]

[feature icon="award" title="Server Leaderboard"]

Everyone who has ever earned an award, online or not, ranked by points and summed by MySQL. Gold, silver and bronze for the top three, a You badge on the viewer's row, and a configurable cap or show-all.

[/feature]

[feature icon="gift" title="Rewards & Claiming"]

Money, items, custom events or several at once, paid exactly once server-side. Full inventory? The award keeps a Claim button until there is room. Verified delivery through the inventory bridge.

[/feature]

[feature icon="eye-off" title="Genuinely Hidden Awards"]

Definitions live server-side only. Unearned hidden awards are sent to the client as an id and points, nothing more. They cannot be spoiled from the resource files.

[/feature]

[feature icon="layers" title="Tiers, Prerequisites & Time Windows"]

Ladders of awards fed by one shared counter, prerequisites that hold progress until unlocked, and awards limited to hours, weekdays or date ranges on the server's clock. Perfect for seasonal and night-shift trophies.

[/feature]

[feature icon="activity" title="Automatic Tracking"]

Playtime, money earned and spent, distance, vehicles owned, top speed, diving depth, landmarks, Mount Chiliad, players met and more, tracked out of the box. Every client report is re-verified server-side.

[/feature]

[feature icon="plug" title="Integrations by Event Name"]

Prison, police, EMS, robberies, paychecks, jobs and vehicle ownership connected through one config file. Entries for resources you do not run cost nothing.

[/feature]

[feature icon="code" title="Developer API"]

17 server exports and matching events for progress, stats, unlocks, resets, lookups, the leaderboard and claiming. 31 shared stats documented and ready to feed. Unknown ids are logged with the calling resource's name.

[/feature]

[feature icon="edit" title="Visual Setup Tool"]

A single HTML page that imports your achievements file, edits every field as a form, picks icons visually, builds rewards and time windows, previews the Lua live and exports a byte-for-byte clean file.

[/feature]

[feature icon="shield" title="Admin Tools & Discord Logging"]

Give, set progress, reset, reload live and list awards, gated by ACE or your framework's admin groups. Rich Discord embeds for unlocks and admin actions on separate webhooks.

[/feature]

[/features]

[promotion]

enabled="true"

label="Pairs With"

title="Mango Notify — Free"

description="The notification layer the whole Mango 5M catalogue is built against. Drop it in for matching toasts across your server."

image="https://i.imgur.com/US22UG5.png"

button_text="Get It Free"

button_url="/package/MANGO_NOTIFY_ID"

details_text=""

details_url="/package/MANGO_NOTIFY_ID"

[/promotion]

[dependencies]

[dependency name="oxmysql" url="https://github.com/overextended/oxmysql"]

[dependency name="ESX Legacy, QBCore, Qbox or standalone — auto-detected"]

[dependency name="ox_lib (optional, not required)" url="https://github.com/overextended/ox_lib"]

[dependency name="mango_notify (optional, for matching notifications)"]

[/dependencies]

[updates]

[update version="1.0.0" date="06 Sep 2026" title="Initial Release" url="https://mango-5m.gitbook.io/mango5m-docs/mango-achievements"]

41 ready-made awards, the full-screen trophy list, unlock celebrations, real rarity, the server leaderboard, reward claiming, hidden awards, tiers, prerequisites, time windows, integrations, the visual setup tool and Discord logging.

[/update]

[/updates]

[/mango_product_info]