Skip to content

WorldsServer-side world management

Create, manage, and back up Minecraft worlds across multiple loaders.

Worlds placeholder preview

What is Worlds? ​

Worlds is a server-side mod/plugin for managing Minecraft worlds across the uebliche stack. It focuses on world lifecycle operations, templates, and backup workflows.

Configuration ​

worlds.json is written on first start and controls backups, templates, and Connect integration.

Connect support ​

Worlds exposes a Connect extension named worlds so Dash can trigger world actions. Configure Connect credentials on the server so the extension can authenticate with Dash.

Fabric/NeoForge runtime load/unload uses a best-effort internal bridge and may require a restart on some versions.

Commands ​

  • /worlds list - List loaded worlds.
  • /worlds create <name> [template] - Create a world on disk.
  • /worlds load <name> - Load a world (Paper supports this natively; other loaders best-effort).
  • /worlds unload <name> - Unload a world (Paper supports this natively; other loaders best-effort).
  • /worlds delete <name> - Remove a world folder.
  • /worlds import <name> <source> - Import a local world folder or download a shared world from Uebliche.
  • /worlds export <name> <destination> - Export a world folder.
  • /worlds template <name> <template> - Export a world as template.
  • /worlds default <name> <true|false> - Mark a world as load-by-default.
  • /worlds backup <name> [reason] - Create a backup snapshot.
  • /worlds tp <name> [x y z [yaw pitch]] - Teleport to a world (spawn by default).
  • /worlds whereami [player] - Show the current world and position (self or another player).

/worlds import <name> <source> also accepts uebliche:<publicationId>, uebliche:<publicationId>@<versionId>, uebliche-share:<code>, and the matching public API URLs.

Build ​

bash
./gradlew :loader-fabric:build -PmcVersion=1.21.1
./gradlew :loader-neoforge:runServer -PmcVersion=1.21.1
./gradlew :loader-paper:reobfJar -PmcVersion=1.21.1

Feature checklist ​

Track feature progress in the checklist.

Feature highlights ​

  • Fabric/Forge hotreload
  • Multi-loader support
  • World lifecycle
  • Templates + backups
  • Connect integration
  • Scaffold the Worlds multi-loader project from the mod template.
  • Add Fabric, NeoForge, and Paper entrypoints with command wiring for world operations.
  • Add Connect extension polling and command handlers for Dash control.
  • Add shared config, registry, and backup helpers.
  • Add best-effort runtime load/unload bridge for Fabric/NeoForge.
  • Add /worlds tp with optional coordinates and rotation on Fabric, NeoForge, and Paper.
  • Add /worlds whereami to show current world and position.
  • Extend /worlds whereami with an optional player argument.