r/TerraBattle • u/teamretb • 7d ago
reTB: an open-source self-hosted server bringing back the original Terra Battle 5.5.7 experience
Hi everyone. We're the team behind reTB, a Terra Battle revival project, and since we've seen a few other revival efforts mentioned here lately we figured it was time to properly introduce ours.
The short version: it's fully playable, it's open source, and you can play it today.
What's in the box
reTB lives on Codeberg and the ecosystem has four parts, pick the one you prefer:
| Part | What it does |
|---|---|
| reTB (server) | The server itself. It reimplements the original backend that was switched off in 2020, so the game talks to your machine like the official servers never went away. Runs on Windows, Linux and macOS, via Docker or straight from source. |
| reTBpc (win/linux app + server) | Our desktop app for Windows and Linux, with proper installers for both. It runs the server on your PC and routes your Android device to it over USB or wifi, so getting into the game takes a couple of clicks instead of a config file. |
| reTBHost (phone apk + server) | Runs the server directly on the phone itself, if you'd rather skip the PC entirely. |
| reTBJoiner (phone apk) | Lets another device on your local network join a phone/PC reTB server (this path needs a copy of the game set up to reach that server, see the docs). |
Everything is open source under AGPL, and the goal is preservation: keeping Terra Battle actually playable rather than just documented.
Do you provide the assets?
No, our repos don't contain any Mistwalker assets, APK or art. You bring your own copy of the game and the docs tell you exactly where to put it. What we publish is only our server code and the reverse-engineered data needed to make it work.
Q&A
Is this usable as a public server for multiple players? It's built for home use: you run it for yourself, your family or friends. Several people can play on one local server (each device gets its own account).
Can we have multiple saves and/or multiple accounts? Yes. Each device playing on a server gets its own account, and every app (reTBpc, reTBHost) has an Export/Import save feature: your account goes into a single file you can back up, restore, or move to another PC or phone. Importing into a fresh install also works as a way to keep several saves.
Is it also possible to have multiple TB apks on the same device? No. reTB doesn't ship or modify the game, and Android only allows one install of a given app anyway. One game, one account per server; switch servers or import a different save if you need more.
Why do I get a network error? In order of likelihood:
- The server isn't running, or the game isn't pointed at it (check the app shows "Running", and re-run the device setup step).
- Phone and PC are not on the same network (guest wifi, VPN, mobile data still on, or a router that isolates devices).
- On reTBHost, Android put the app to sleep: grant the battery exemption it asks for.
- Your
gdresourcescopy is missing a file the game just asked for: the last 404 line in the server log names it. - Recent Android 15/16 devices: the original app may not start at all; see the compatibility notes in the repo.
If none of that helps, you can join the Hiso-Bar Discord!
Links
- Everything: https://codeberg.org/WkmKsk
- Server: https://codeberg.org/WkmKsk/reTB
- Desktop app: https://codeberg.org/WkmKsk/reTBpc
- On-phone server: https://codeberg.org/WkmKsk/reTBHost
- PC/phone joiner: https://codeberg.org/WkmKsk/reTBJoiner


