Start Here¶

Install or update¶

1

Build or download the jar

Use the latest AxoTales-<version>.jar from this repo line.

2

Install to the shared mods folder

Copy it to C:\Users\<you>\AppData\Roaming\Hytale\UserData\Mods.

3

Keep only one Axo Tales jar there

Delete older AxoTales-*.jar files so the game does not load the wrong version.

4

Restart the world if the file is locked

If Windows says the jar is in use, the game or server still has the old build open.

First files worth knowing¶

`server-config.json`

Your live tuning surface for spell costs, worldgen density, Kudu spawn rates, loot, and movement-block behavior.

`spellbooks-debug.log`

A persistent debug log under the plugin data directory. Use it for casts, stat gates, input routing, and movement-block problems.

Packaged defaults can differ from your live runtime file

The guidebook documents src/main/resources/server-config.json. Existing worlds keep their own runtime copy once the mod has already been launched there.

Where crafting starts¶

Arcanist's Workbench

Axo Tales uses two dedicated tabs here: Spellblades for books and the Ancient Sword, and Armor for the Sa'r set plus Kudu Boots.

Alchemybench

Every Axo Tales potion starts from Axo's Empty Potion Bottle, then branches into mobility, stealth, strength, or curse routes.

Good first-session route¶

Mine or spawn enough Arcane Matter and Arcane Crystal Shards to unlock your first spellbook or armor piece.
Open the Arcanist's Workbench and choose a lane: mana gear first, or one utility spellbook first.
Read Crafting Flow if you want the cleanest progression order.
Read Troubleshooting early if testers keep seeing the wrong jar or the wrong live config.