Installation
Requirements, the install steps, what the first run creates, and which optional plugins are worth adding.
Requirements
| Server software | Spigot, or anything built on top of it |
| Minecraft | 1.21 and newer, including the 26.x line |
| Java | 21 or newer. Minecraft 26.1 and later need Java 25 on the server anyway |
| Hard dependencies | None |
One jar covers the whole range. It is compiled against the 1.21 API and emits Java 21 bytecode, which a newer server runs without complaint. There is nothing to pick between.
Install
Stop the server
Shut it down fully. Dropping a jar in on a running server leaves it half loaded.
Drop in the jar
Move the WandWorks jar into your plugins/ folder. Buy links are on the Download page.
Start the server
On first start WandWorks writes its config files and, unless you switched to MySQL, its SQLite database. Two lines in the console are worth reading:
[WandWorks] Loaded 3 wands.
[WandWorks] Price sources in use, in order: ...The second one tells you which shop plugin it actually found. If it only says prices.yml, nothing else was picked up.
Give yourself a wand
/wandworks give <your name> sellerRight-click a chest with something sellable in it. If money lands in your balance, everything is wired up.
What the first run creates
data.db only appears when storage is left on SQLite. On MySQL the two tables are created in your database instead. See Storage.
Every one of these files carries a config-version key at the top. Leave it alone. It is how a later update merges its new keys into the file you have already edited, without touching your values.
Optional integrations
None of these are required. Each one switches itself off when the plugin behind it is missing, and the server starts clean with none of them installed.
| Plugin | What it unlocks | Without it |
|---|---|---|
| Vault plus an economy | Sell wands, and shop mode builder wands | Those wands tell the player they are off and stop |
| ShopGUI+, EconomyShopGUI, UltimateShop or zShop | Live prices from your shop | Falls through to the next source in prices.order |
| EssentialsX | Worth values as a sell price | One fewer sell source. It never answers a buy lookup |
| InfiniteBags 1.3.0 or newer | Bag mode on builder wands | The bag row is left out of the lore and the toggle says so |
| SuperiorSkyblock2 | Wands limited to islands the player belongs to | No island check at all |
Bag mode needs InfiniteBags 1.3.0 or newer. On 1.2.3 and older the two methods it relies on do not exist, so the hook says so once in the console and bag mode stays off. See Bag mode.
Updating
Stop the server, swap the jar, start it again. New config keys merge in on their own. Nothing in the config files needs deleting first.
A change to storage.type or the MySQL details is read once at startup, so those need a full restart rather than a reload. Everything else /wandworks reload picks up straight away.