Tools
The Tools/ folder in your server install holds utilities used during first-time setup and whenever you need to regenerate client-facing configuration. Everything here runs from its own subfolder and reads plain-text XML (or runs against the MuOnline ODBC DSN).
Available Tools#
| Tool | Purpose |
|---|---|
| ConfigEncoder | Packs ServerConfig.xml + ClientConfig.xml into the encrypted .axiom blobs loaded by the client and launcher. |
| Axiom Server Manager | AxiomServerManager.exe in the root of the server folder (not in Tools/). Starts, stops and monitors the servers, runs server commands, and installs updates. See Launching Your Server, step 9 and Updating with the Server Manager. Replaces ServerStartUp from 1.x. |
| AxiomEditor | Windows desktop app for creating accounts, editing characters, and browsing items in the MuOnline database. Requires .NET 8 Desktop Runtime. See Launching Your Server, step 10. |
| PngToOzt | Converts PNGs to the client's .ozt texture format. Used when adding custom UI or map art. |
| AtlasPacker | Packs a folder of PNG icons into one UI atlas (.png + .xml) for achievement, badge, monster affix and custom skill icons. See AtlasPacker below. |
AtlasPacker#
Tools\AtlasPacker\AtlasPacker.exe -unpack <atlas .xml> <icon folder>
Tools\AtlasPacker\AtlasPacker.exe <icon folder> <atlas name> <prefix> [-out <folder>] [-pad <px>]
| Atlas | Atlas name | Prefix | Icon size |
|---|---|---|---|
| Achievements | achievements | ach | 48x48 |
| Rank badges | badges | badge | 64x64 |
| Monster affixes | affix | affix | same as shipped |
| Custom skills | customskill | customskill | same as shipped |
Add icons to a shipped atlas#
- Unpack the shipped atlas (the
.pngmust be next to the.xml). You get one PNG per sprite:badge/ironbecomesiron.png.AtlasPacker.exe -unpack "C:\AxiomClient\Data\Interface\UI\atlas\badges.xml" C:\MyIcons\badges - Add your PNGs to the folder. To change an icon, overwrite its PNG.
- Pack it again:
AtlasPacker.exe C:\MyIcons\badges badges badge -out "C:\AxiomClient\Data\Interface\UI\atlas" - Use the sprite name in the plugin XML:
my_badge.pngbecomesbadge/my_badge.
- The tool rebuilds the whole atlas from the folder. Icons not in the folder are gone. Always unpack first.
- Keep
default.pngin the achievements and affix folders: missing icons fall back to it. - Ship the new
.png+.xmlin your client patch.
When To Re-Run#
- ConfigEncoder - every time you edit
ServerConfig.xmlorClientConfig.xml. The client reads the.axiomblobs, not the XML. - Axiom Server Manager - nothing to regenerate; the server list in
ServerManager.xmlships ready and the Manager saves your changes to it. - AxiomEditor - any time you need to create or modify accounts / characters directly in the database.
See Launching Your Server for the end-to-end workflow that uses these tools.