> 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/developer-guide/the-setup-tool.md).

# The Setup Tool

A visual editor for your award file.

`achievement-setup.html` ships in the resource folder. Open it in any browser.

<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>Import</strong></td><td>Load your current achievements.lua, or start from scratch.</td><td></td></tr><tr><td><strong>Edit visually</strong></td><td>Every field, with validation as you type.</td><td></td></tr><tr><td><strong>Pick icons</strong></td><td>A grid of your icon folder, showing which award already uses each one.</td><td></td></tr><tr><td><strong>Export</strong></td><td>Download the regenerated achievements.lua.</td><td></td></tr></tbody></table>

## What it does

* Import your existing `config/achievements.lua`, then create, edit, duplicate and delete awards
* Set the id, name, description, goal, timeframe, days, times, points, rarity, category and icon
* Pick prerequisites from a checklist of your other awards
* Search and filter, preview the generated Lua, and export it back

{% hint style="success" %}
It runs entirely on your own machine. Nothing is uploaded, and imported Lua is **parsed rather than executed**.
{% endhint %}

## Notes

Keep the page in the resource folder so the icon previews resolve. If they show blank, use **Load icons folder** and pick `web/assets/icons`.

Fields the form does not model — custom rewards, sound and animation overrides — are preserved exactly as imported and written back unchanged.

The page is not listed in the resource manifest, so players never download it.

{% hint style="info" %}
Your work is saved in the browser between sessions, so closing the tab does not lose it. Export when you are happy, drop the file into `config/`, and run `/achievementsreload`.
{% endhint %}