Reference

Troubleshooting

Fixes for the most common modding problems, from a missing Mods button to lost data, errors and broken downloads.

Anzeige

Find your problem below. If it is not here, your mod's Log (Mods, your mod, Log) usually says what went wrong. Still stuck? Ask in the Eaglercraft Discord.

I cannot find the Mods button

Mods only exist in Eaglercraft 26.2 and 26.3. The 1.8 and 1.12 clients do not have them. In 26.2 and 26.3, Mods is on the title screen, next to Options..., where Quit Game is in the normal game. It is not in the pause menu.

My mod says Paused

Mods only run in singleplayer. They pause on servers, in other people's LAN worlds and while your world is open to LAN. They start again on their own when you leave. See How mods run.

My mod stopped, or says Error

Click Log and read the last lines. The reason is also in the mod's details.

What it saysWhat happened
too many errorsyour code hit 30 errors in a minute, usually a broken HUD or tick function that fails every frame
script took too longyour code ran past its budget, usually an endless loop
Failed to loadthe error happened while main.lua was loading, so the mod never started
requires the mod ...a mod it depends on is missing, turned off or broken

Fix the code, then click Save & reload in the editor or Reload in the Mods menu.

My mod says Not loaded

It is turned on but not running. This usually means a mod it depends on was turned off, deleted or updated. Turn that mod back on, or install it, then click Reload on yours.

Settings is greyed out

The Settings page only opens while the mod is running and has at least one setting. It is greyed out when the mod is turned off, stopped by an error or paused on a server.

My setting reads as a function

The setting's key is the same as a settings function, like color or text. settings.color is the function that makes color settings, so a setting named color can only be read with settings.get("color"). Give it another name, like textColor. See Settings and storage.

My saved data is gone

  • You replaced storage. storage = {} makes a new table that is never saved. Change its fields instead: storage.kills = 0.
  • The tab closed before it saved. Storage saves every 15 seconds and when your mod unloads, not when the tab closes. Call mod.save() after anything important.
  • Something could not be saved. A function or other game object in storage stops the whole save. The Log says "could not save storage".
  • The browser's data was cleared. Mods and their data live in your browser. Clearing this site's data deletes them.

My code changes are gone

Close and Escape in the editor throw away anything you did not save, without asking. Click Save & reload first. Updating a mod also replaces your edits with the new version, so export your copy before you update.

My mod does nothing when I am already in a world

world_join only fires when you join a world. If your mod loads while you are already in one, it never sees that event. Check player.exists() when your mod starts. See How mods run.

The § in my text disappears

The game's editor and paste box remove the § character. Write "\u{00A7}" in its place: "\u{00A7}aGreen" is green text.

My colors are see-through or solid when they should not be

A number color with 00 alpha, like 0x00FF0000, is drawn solid. To make something see-through, use a hex string: "#80FF0000" is half see-through red. Short colors like "#F00" do not work either, so always write all six or eight digits.

Everything on the screen moved

A ctx:translate, scale or rotate without a matching push and pop moves everything drawn after it, including the game's menus. Wrap them in ctx:push() and ctx:pop().

My tooltip does not show

ctx:tooltip only shows on screens, like your own ui.screen. It does not show on the HUD.

My buttons on a game screen disappear or show up twice

Add buttons inside screen_init. It fires again whenever the screen is rebuilt (for example when the window is resized), and the buttons are cleared each time, so they come back on their own. Adding them anywhere that runs every frame adds a new button every frame.

My command does not work

  • Mod commands only work from the chat box, not from chat.send or chat.command.
  • Two mods cannot have the same command. The second one gets an error. Check its Log.

Download failed

Downloading a mod from a link needs the website to allow cross-origin requests (CORS), and many file hosts do not. Download the file yourself and drop it on the game instead. The same goes for http.get in your own mod.

http.get or clipboard.get says it needs a permission

Add the permission to your mod: network for http.get and clipboard for clipboard.get. See Packaging.

The share code does not work

  • The paste box holds 200,000 characters, and longer codes are cut off. Save the code in a .txt file and import that file, or share the zip.
  • "That share code is damaged" means part of it is missing or changed. Copy it again.

This mod needs a newer mod API

The mod was made for a newer version of Zeus than your game has. Play the newest version of Eaglercraft, or ask the mod's author for a version with "api": 1.

My WebAssembly mod will not load

What it saysWhat to fix
A WebAssembly mod needs a metadata.json next to itput the .wasm file and metadata.json in a zip
the limit is 8 MBmake the file smaller, for example with size optimizations
the module must export a function "zeus_init"your SDK setup is missing its start function
... is not supportedyour language uses a WebAssembly feature Zeus does not have, like threads or GC
took too long (ran out of fuel)your code ran past its budget, usually an endless loop
ran out of memoryyour mod used more than 256 MB

See WebAssembly mods for every limit.