Skip to content

Troubleshooting

JonataOliveiraa edited this page Nov 14, 2026 · 1 revision
Playing

Most problems with Bunny Loader have a short answer, and this page collects them, starting with the most common. If yours is not here, the report in Settings → Diagnostics is the best thing to send when you ask for help on Discord.

Getting a report

When the game closes by itself, freezes, or shows an error, open the launcher, go to Settings → Diagnostics and tap View report. It shows what happened in the last game, including every message from the mods. Tap Copy and paste it in your message, or send a screenshot of it. If the problem comes from one mod, its author needs that report too.

"Terraria required" when I press Play

Bunny Loader opens the copy of Terraria installed on your phone, so the game from Google Play must be installed on the same phone. Tap Open Play Store, install Terraria, and come back.

"App not installed" when updating

Android only updates an app with a file signed by the same developer. The APK you are installing and the Bunny Loader you have were signed differently, so one of them is not an official build. Back up your saves (Saves and backups), uninstall Bunny Loader, and install the official build.

The game takes a long time to open

The first time you play after installing or updating mods that ship their source code, Bunny Loader compiles them before the game opens, and shows its progress. That can take from a few seconds to a few minutes, depending on the mod and on your phone. The next launches only check that nothing changed, which takes a moment. A big mod also makes the game's own loading screen longer, because the game sets up everything the mod adds.

A mod shows an error

When a mod fails, Bunny Loader shows the error on the screen, with the mod's name and what went wrong. If the error happened while the mod was loading, that mod stays off for this game. If it is a mod you installed, send the message, or the Diagnostics report, to its author; until it is fixed, turn the mod off in Packages. If you make mods yourself, Log messages explains each message.

If the error panel gets in the way, you can turn it off in Settings → Show errors in game; the messages still go to the report.

The game closed by itself or froze

Open Settings → Diagnostics → View report right after it happens, before playing again, since the report describes the last game. If the problem started after you installed a mod, turn that mod off and try again: if the game works, the mod is the cause, and its author is the one to tell.

Items show up as question marks

Those are items from a mod that is turned off or was removed. They are kept in your save, and they come back when you turn the mod on again. See Saves and backups.

I cannot join a friend's game

Everyone needs Bunny Loader, and Bunny Loader only joins Bunny Loader servers. If the server uses different mods, it either offers to sync yours (tap Sync) or lists what is missing and what is extra; if it forbids texture packs, turn yours off. Multiplayer explains each message.

The game runs slowly

Mods add work to every frame of the game, and some add a lot. Try turning off the mods you do not need and see whether one of them is the cause. Big texture packs also take memory. Mods that draw screen effects can be turned off in the game's Settings, in the Screen Effects row, which helps on slower phones.

The app or the Mod Menu is in the wrong language

The launcher's language is in Settings → Appearance → Language, and the Mod Menu follows it the next time the game opens. The game's own texts follow the language you chose inside Terraria's settings.


← Saves and backups

Clone this wiki locally