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.