Skip to content

Log Messages

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

The messages Bunny Loader writes when something goes wrong with a mod, what each one means and what to do about it. They show up in the error panel in the game, in the in-game editor, in the report of Settings → Diagnostics, and in adb logcat -s BunnyLoader. Testing and errors explains where to read them. In the messages below, <uid> is the mod's uid, and the parts in angle brackets change with the mod.

Loading a mod

Message What it means What to do
mod <uid>: no class extends Terraria.ModLoader.Mod The mod's code has no mod class. Add one class that extends Mod, named after the mod's ID (Making mods).
mod <uid>: <file>(<line>,<column>): CS<number>: <text> A compile error in a mod that ships its sources, with the file, the line and the column. Fix the line. The C# error code (CS0103 and so on) can be searched for an explanation.
mod <uid>: <file> did not compile (<n> error(s)) The summary after the errors above: the mod stays off. Fix the errors; the next launch compiles again.
mod <uid>: compiling <file> (<reason>) Not an error. The phone is compiling the mod's sources, because they were never compiled (not compiled yet), because they changed (the sources changed) or because Bunny Loader was updated (compiled for API <n>, this is <n>). The next line says how long it took. Nothing.
mod <uid>: the .NET runtime did not start This build of Bunny Loader cannot run C# mods. Install an official build.
mod <uid>: <exception> The mod threw an exception while loading, for example in its Load or in a content class's SetStaticDefaults. The text starts with the exception's type and message and ends with the stack, which names the method. Fix the method the stack points to.
<Mod>/<Class>: texture '<path>' not found in <folder> A content class's picture is missing. The path is built from the class's namespace and name. Put the PNG where the path says, or fix the namespace (Your first mod).

Dependencies

When a mod lists dependencies, Bunny Loader loads them first. If it cannot, the mod is turned off for this game with one of these messages:

Message What it means
mod <name> (<id>) disabled: requires '<dependency>', which is not enabled The dependency is not installed or is turned off.
mod <name> (<id>) disabled: requires '<dependency>', but more than one enabled mod has that id; list it by uid Two installed mods share that id; write the dependency's uid instead.
mod <name> (<id>) disabled: requires '<dependency>', which could not be loaded The dependency itself failed; its own message comes first in the log.
mod <name> (<id>) disabled: dependency cycle: <A> -> <B> -> <A> The mods depend on each other in a circle, so none can load first.

While playing

Message What it means What to do
<who> threw: <exception> A method of the mod, such as a content class's UpdateAccessory or a system's PostUpdateWorld, threw an exception during the game. The game goes on, and the message is written only the first time, so it does not fill the log. Fix the method the stack points to.
net: <Mod>.HandlePacket threw: <exception> The mod's handling of a network packet failed. Check that the packet is read in the same order it was written (Networking).

Talking to the game

Message What it means What to do
FileNotFoundException: Could not load file or assembly '<name>' The mod uses a library the phone does not have. For a library of your own, such as a NuGet package, put its .dll next to the mod's. A System.* library outside the list is not available.
game class Terraria.<Name> not found The code uses a class that does not exist in this version of the game. Check the name; the mobile game sometimes differs from the PC.
MissingMethodException: <class>: '<method>' not found, MissingFieldException: <class>.<field> not found A method or a field changed or does not exist in this version of the game. Update BunnyLoader.dll from the APK you have and build again.
struct layout differs from the game The mod was built against a BunnyLoader.dll from another version. Use the BunnyLoader.dll from the APK you have installed.
NullReferenceException The code used an object that is empty, often one created with new Item(). Get objects from the game or create them with .New() (Values and objects).

Texture packs

Message What it means What to do
Texture pack <uid>: <name> size mismatch: PNG <w>x<h>, original <w>x<h>; sprite frames may break The new picture has a different size than the game's. Pictures with several frames, such as NPCs, may be cut in the wrong place. Draw the picture at the original size.
Texture pack <uid>: could not apply <name>; keeping original/lower priority asset The picture could not be loaded, so the game keeps the next one in line. Check that the file is a valid PNG.

Multiplayer

These are shown on the screen when joining a server.

Message What it means
Bunny Loader only joins Bunny Loader servers. The server runs plain Terraria.
This server uses different mods. Sync to join. Your mods differ from the host's; the Server mods screen offers to match them.
This server uses different mods. Missing here: ... Not on this server: ... The host turned Mod sync off, or the right versions could not be found; the lists say what to install and what to turn off.
This server does not allow texture packs. Turn yours off (...) to join. The host turned Allow textures off.
Only the host can change this config The option belongs to the server (Mod settings).

Chat commands

Message What it means
Unknown mod: ... The command names a mod that is not loaded.
The mod ... does not have the command /... The mod exists but has no such command.
The command /... exists in more than one mod. Try: ... Two mods use the same command name; type it with the mod's name, as suggested.
Usage: ... The command was typed with the wrong arguments; the message shows the right form.

← Manifest reference  ·  Migrating from 0.3 →

Clone this wiki locally