Skip to content

About

A server side mod to create resource worlds

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Resource World

This mod can create resource worlds. These worlds can reset standalone from main worlds.

Logically support modded dimensions.

Features

  • Create separated resource worlds from any exists dimensions
  • Standalone seeds, game rules, difficulties and world borders
  • Reset standalone

Commands

Root command: /resourceworld

Player Commands

  • /resourceworld home: Teleport to your spawn point. This is the only way to exit resource worlds without other mods.
  • /resourceworld tp <world id>: Random teleport to resource worlds.

Admin Commands

  • /resourceworld create <world id> <type/flat> ... [<seed>]: Create a resource world with specific dimension options. Seed is optional, leave blank for random seed.
  • /resourceworld create <world id> custom <preset> [<seed>]: Create a resource world from a custom dimension JSON preset.
  • /resourceworld create <world id> mirror <dimension>: Create a snapshot of an existing dimension.
  • /resourceworld create <world id> template <template> <dimension>: Create a snapshot from a template.
  • /resourceworld delete <world id>: Permanently delete a resource world.
  • /resourceworld reset <world id>: Reset specific resource world. Generated worlds receive a new seed; mirror and template worlds keep their original source seed.
  • /resourceworld enable/disable <world id>: Enable/Disable specific resource world.
  • /resourceworld settings <world id> <option> [<new value>]: Configure resource world settings.

All available settings

  • centerX: Center X of the world border.
  • centerZ: Center Z of the world border.
  • range: World border radius.
  • spawnPoint: Resource world spawn point.
  • cooldown: /resourceworld tp cooldown.
  • hideSeedHash: Whether hide resource world seed hash from players, open this can partly prevent seed cracking but may cause wrong biome sounds and sky colors.
  • allowHomeCommand: Whether allow using /resource home command.

Copy world sources

  • mirror <dimension> snapshots an existing loaded dimension in the current save. The server saves before copying.
  • template <template> <dimension> loads a snapshot from <server directory>/resourceworld/<template>.

Both types copy only region, entities, and poi. Template folders use normal save layouts: the template root is the overworld, DIM-1 is the Nether, DIM1 is the End, and dimensions/<namespace>/<path> is any other dimension. Both types preserve their original source seed and never accept a seed argument. Resetting only refreshes the copied data. Templates must include their original level.dat so template can read the seed.

Custom generation presets

Place a standard dimension (LevelStem) JSON file at <server directory>/resourceworld/presets/<preset>.json. Preset names may contain letters, numbers, underscores and hyphens; omit .json in the command. Available names are suggested by the command.

For example, resourceworld/presets/desert.json can contain:

{
  "type": "minecraft:overworld",
  "generator": {
    "type": "minecraft:noise",
    "settings": "minecraft:overworld",
    "biome_source": {
      "type": "minecraft:fixed",
      "biome": "minecraft:desert"
    }
  }
}

Create it with /resourceworld create desert_mine custom desert 12345, or omit the seed for a random seed. The LevelStem itself does not need an entry in minecraft:dimension; referenced dimension types, biomes, noise settings and other registry entries must still be available, including any required data packs or mods.

The complete JSON is copied into the save's resource_world.json as "generate": {"type": "resource_world:custom", "stem": { ... }}. Restarting or resetting the world uses this saved snapshot, even if the source preset file is changed or removed. Referenced registry entries are resolved from the server's current registries; they are not copied into the snapshot. Resetting generates a new seed as with type worlds. Invalid files or unresolved registry entries are reported before a world is added to the config.

Developer Usage

To use an unregistered LevelStem directly, call CustomGenerateOption.fromStem(server.registryAccess(), stem) and pass the resulting option to ResourceWorldHelper.createWorld. This stores the stem's JSON representation for future restarts and resets. new CustomGenerateOption(jsonObject) also accepts a dimension JSON object.

If you want to customize the dimension random teleport locator, create a class implementing RandomTeleportEntrypoint and register it through the Integration API entrypoint random_teleport_locator.

About

A server side mod to create resource worlds

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages