Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/lDEVinux/eaglercraft/llms.txt

Use this file to discover all available pages before exploring further.

Singleplayer in Eaglercraft works just like vanilla Minecraft 1.5.2. Press Singleplayer on the main menu to create new worlds or load existing ones. Your worlds are saved automatically and can be returned to at any time — no server required.

World Storage

Worlds are stored in your browser’s local storage, keyed by the worldsFolder value configured in eaglercraftOpts (the default key used by the official client is TEST). Because local storage is scoped to a specific browser and domain, your worlds are tied to:
  • The browser you are using (e.g. Chrome worlds won’t appear in Firefox)
  • The domain the Eaglercraft client is served from (e.g. worlds from https://g.deev.is/eaglercraft/ are not accessible from a different host)
If you switch browsers, reinstall your OS, or use a different Eaglercraft site URL, your worlds will not automatically carry over unless you export them first.
Clearing your browser’s site data, cookies, or cache will permanently delete all worlds stored in local storage. Always export your worlds as EPK files before clearing browser storage or switching devices.

Importing and Exporting Worlds

Eaglercraft lets you export any singleplayer world as an EPK file and import it again on any other Eaglercraft client that supports singleplayer.
  • Exporting: Use the Export button available in the world selection screen while in-game to download your world as an .epk file to your device.
  • Importing: On any compatible Eaglercraft client, use the Import option on the world selection screen and select your .epk file.
  • Exported worlds can be sent to friends, transferred to a different computer, or kept as a backup — they carry all your progress.
Export your worlds regularly as EPK backups, especially before clearing browser storage or moving to a new device. Treat EPK files the same way you would treat a save-game backup in any other game.

World Timeout

Eaglercraft includes a GuiScreenChangeWorldTimeout screen that allows you to configure how long the game will wait while loading a world before timing out. If you experience slow world loads — particularly on older hardware or with large worlds — adjusting this timeout can prevent the game from cutting off the load prematurely.

Beta Singleplayer

In addition to the standard Minecraft 1.5.2 singleplayer, a Minecraft Beta client is available at: https://g.deev.is/eaglercraft/beta/ This client runs an older Beta-era version of Minecraft directly in your browser, also with full singleplayer support.

Build docs developers (and LLMs) love