> For the complete documentation index, see [llms.txt](https://mango-5m.gitbook.io/mango5m-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mango-5m.gitbook.io/mango5m-docs/resources/mango-achievements.md).

# Mango Achievements

A trophy system for your city. Players earn awards for what they actually do, progress is saved forever, and any resource can feed it in one line.

Give your players something to chase. **Mango Achievements** adds a PlayStation-style trophy list to your server: awards unlock as people play, progress is saved to your database, and every unlock lands as a polished on-screen popup.

It ships with 41 ready-made awards covering crime, policing, EMS, prison, jobs, driving and exploration — and any of them can be edited, removed or replaced without touching a line of code.

{% hint style="success" %}
**Works out of the box.** Install it, restart, and players start earning awards immediately. Nothing else on your server needs changing.
{% endhint %}

## Start here

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Installation</strong></td><td>Add the resource, start it, and give yourself admin rights.</td><td><a href="/mango5m-docs/resources/mango-achievements/getting-started/installation.md">Installation</a></td></tr><tr><td><strong>Quick Start</strong></td><td>Open the menu, award something, and see it work.</td><td><a href="/mango5m-docs/resources/mango-achievements/getting-started/quick-start.md">Quick Start</a></td></tr><tr><td><strong>Escrow and Editable Files</strong></td><td>What you can edit, and what is encrypted.</td><td><a href="/mango5m-docs/resources/mango-achievements/getting-started/escrow-and-editable-files.md">Escrow and Editable Files</a></td></tr></tbody></table>

## Documentation

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Configuration</strong></td><td>Every setting, grouped by the file it lives in.</td><td><a href="/mango5m-docs/resources/mango-achievements/configuration.md">Configuration</a></td></tr><tr><td><strong>Features</strong></td><td>What the resource actually does, from the trophy list to hidden awards.</td><td><a href="/mango5m-docs/resources/mango-achievements/features.md">Features</a></td></tr><tr><td><strong>Developer Guide</strong></td><td>Write your own awards and feed progress from your resources.</td><td><a href="/mango5m-docs/resources/mango-achievements/developer-guide.md">Developer Guide</a></td></tr><tr><td><strong>Reference</strong></td><td>Commands, performance and troubleshooting.</td><td><a href="/mango5m-docs/resources/mango-achievements/reference.md">Reference</a></td></tr></tbody></table>

## What your players see

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>The trophy list</strong></td><td>A full-screen menu showing every award, how far along they are, and how rare it is on <em>your</em> server.</td><td><a href="/mango5m-docs/resources/mango-achievements/features/the-trophy-list.md">The Trophy List</a></td></tr><tr><td><strong>Unlock popups</strong></td><td>A celebration toast with the award art, points and reward — plus a sound and a cheer animation.</td><td><a href="/mango5m-docs/resources/mango-achievements/features/unlock-popups.md">Unlock Popups</a></td></tr><tr><td><strong>Real rarity</strong></td><td>Every row shows the true percentage of your players who hold that award.</td><td><a href="/mango5m-docs/resources/mango-achievements/features/rarity-and-points.md">Rarity and Points</a></td></tr><tr><td><strong>Leaderboard</strong></td><td>A server-wide ranking by achievement points — every character, online or not.</td><td><a href="/mango5m-docs/resources/mango-achievements/features/leaderboard.md">Leaderboard</a></td></tr><tr><td><strong>Rewards</strong></td><td>Cash straight into their bank, items, or anything your own scripts hand out.</td><td><a href="/mango5m-docs/resources/mango-achievements/configuration/rewards.md">Rewards</a></td></tr><tr><td><strong>Nothing lost to a full bag</strong></td><td>An item reward that would not fit waits on the award until there is room.</td><td><a href="/mango5m-docs/resources/mango-achievements/features/claiming-rewards.md">Claiming Rewards</a></td></tr></tbody></table>

## Support

Need a hand? Join the Discord and open a ticket — [discord.gg/sZn2A543De](https://discord.gg/sZn2A543De)

Store: [mango5m.tebex.io](https://mango5m.tebex.io)