RS-Economy documentation · v2.0.0
Data, backups and migration
Where balances live, how to back them up, and what happens when you update from an older version.
#Where the data is
| What | Where |
|---|---|
| Balances, daily reward dates, bounties, shops, scoreboard choices, known players | inside the world save: world/data/rs_economy.dat |
| Settings | config/rs_economy/rs_economy-common.toml |
| Messages | config/rs_economy/locales/ |
Because the economy is part of the world, a world backup is a backup of the economy. Nothing can fall out of sync between the two.
The data is the same on NeoForge and Fabric, so you can move a world between the loaders and keep everything.
#Back up
Back up the world folder as usual, plus config/rs_economy/ if you have changed settings or wording. Do it while the server is stopped or after a save.
#Moving a world to a new Minecraft version
RS-Economy releases for all supported versions together. Update the world to the new Minecraft version as you normally would, and install the jar that matches it.
#Upgrading from an older version
#From 1.0.x
1.0.x kept balances in separate files next to the world. Version 1.1.0 moved them into the world save without reading the old files. Update straight to 1.2.0 or later: it finds the old files (rs-economy_userdata.json, rs-economy_serverdata.json) on first start and migrates them. Nobody loses anything.
#From 1.2.x and earlier: command names
Command and argument names stopped being translated in 1.2.0. If a command block, macro or Discord bot used German names, switch it to the English ones.
#From 1.2.x: the language setting
1.3.0 removed the server-wide locale setting. Every player now gets their own language automatically. Delete the line if it is still in your config.
#From 1.5.x: the casino has moved
2.0.0 removed the lottery, slot machines and coin flip. They are now the RS-Casino mod. On the first login after the update, RS-Economy settles whatever the old features left in your save. See Casino and RS-Casino.
#Between 2.0 and later
The changelog flags anything that needs action as Action needed. Read it before updating across a major version.
#Reset the economy
To start clean, stop the server, delete world/data/rs_economy.dat and start again. Keep a backup first; this removes every balance, bounty and shop registration. Shop signs stay in the world but stop working.
Something missing or wrong? Tell us on Discord. This documentation describes v2.0.0.
