Alternate Realities

Alternative Realities

Alternative Realities gives server owners control over what players carry between dimensions.

Dimensions can share one player inventory or behave as completely separate realities. Inventories, equipment, experience, Ender Chests, accessories, and first-entry commands can all follow the player’s current dimension group.

By default, every dimension belongs to the normal group. Install the mod and play normally, or separate individual dimensions through the generated configuration.

Compatibility

Alternative Realities supports Forge and Fabric on Minecraft 1.20.1, Fabric and NeoForge on 1.21.1, and NeoForge on 1.21.11, 26.1.2, and 26.2 beta.

Fabric installations require Fabric API.

Curios and Trinkets are optional. When present, supported accessory slots are saved as part of each dimension group.

Getting Started

Install the correct file for your Minecraft version and mod loader, then start the server once.

Alternative Realities creates these files in the server’s config folder:

alternative-realities.toml

alternative-realities-dimensions.toml

The main file controls global behavior. The dimensions file controls dimension groups and first-entry commands.

If every dimension should share the same inventory, no changes are required. All detected dimensions use the normal group automatically.

After editing either file, restart the server or run:

/altreal reload

Creating Dimension Groups

Dimensions with the same group name share player state.

This configuration keeps the Overworld, Nether, End, and a custom orbit dimension together:

[dimension_groups]
"minecraft:overworld" = "normal"
"minecraft:the_nether" = "normal"
"minecraft:the_end" = "normal"
"example:orbit" = "normal"

To give a dimension its own inventory, assign it a different group:

[dimension_groups]
"minecraft:overworld" = "normal"
"minecraft:the_nether" = "normal"
"minecraft:the_end" = "normal"
"example:moon" = "moon"

Players entering example:moon will now use the moon inventory group. Returning to a dimension in the normal group restores their normal inventory.

Several dimensions can share a custom group:

[dimension_groups]
"example:moon" = "space"
"example:mars" = "space"
"example:station" = "space"

All three dimensions now share the space player state.

Explicit server configuration always takes priority over automatic settings supplied by another mod.

What Changes Between Groups

Alternative Realities stores the player’s main inventory, hotbar, armor, offhand equipment, experience, and supported accessories for each group.

Ender Chests can either remain global like vanilla Minecraft or be stored separately for each group.

Dropped items and mobs can be prevented from traveling between dimensions. Projectile blocking is also available when stricter separation is needed.

Player data is written safely with backup recovery. Interrupted dimension changes are detected and recovered without discarding the source inventory.

First-Entry Commands

Commands can run when a player enters a group for the first time.

[entry_commands]
"normal" = []
"space" = [
    "give @s minecraft:bread 16",
    "give @s minecraft:stone_pickaxe"
]
"default" = []

Do not include a leading slash.

{player} inserts the player’s name.

{uuid} inserts the player’s UUID.

{group} inserts the destination group.

{dimension} inserts the destination dimension ID.

Commands can run once or on every entry. The main configuration also controls operator permission and whether player state is saved immediately afterward.

Death and Respawning

Dying clears the carried inventory and accessories stored for the active group.

Ender Chest contents remain intact. Experience follows the configured experience setting. If the player respawns in another dimension group, Alternative Realities loads that group instead of restoring items from the dimension where the death occurred.

Commands

/altreal help displays the available commands.

/altreal list displays the current dimension, current group, saved groups, and first-entry status.

/altreal reload reloads both configuration files.

/altreal save saves the player’s current group.

/altreal restore restores the saved state for the current group.

/altreal reset_kits resets the player’s first-entry markers.

/altreal run_kit manually runs the current group’s entry commands.

Integration for Dimension Developers

Dimension developers can request a separate default group without requiring server owners to edit their Alternative Realities configuration.

Create this file in the dimension mod:

data/alternative_realities/tags/dimension/separate_group.json

{
  "replace": false,
  "values": [
    "example:moon"
  ]
}

Code-driven registration is also supported:

AlternativeRealitiesApi.registerSeparateGroup("example:moon");

Several dimensions can be assigned to the same default group:

AlternativeRealitiesApi.registerDimensionGroup("example:moon", "space");
AlternativeRealitiesApi.registerDimensionGroup("example:mars", "space");

Registrations should occur during mod initialization before the server starts. Server configuration remains authoritative and can override developer defaults.

Planned Features

Dimension-specific attributes

Support for changing player attributes when moving between dimensions or groups.

Configurable attribute defaults

Configuration support for defining default player attributes in each dimension or group without relying on first-entry commands. This may include health, movement speed, attack attributes, hunger, saturation, flight, and other player properties.

Complete feature control

Configuration support for enabling or disabling individual Alternative Realities features at will. Inventory, armor, offhand equipment, experience, Ender Chests, accessories, travel restrictions, death handling, and entry commands will be independently configurable.

Expanded modding API

A full API allowing dimension developers to integrate automatically without changing Alternative Realities’ default configuration. Mods will be able to provide default groups, localized-state rules, attribute profiles, entry behavior, and other defaults for their dimensions.

Per-group rules

Different groups will be able to localize different parts of player state. One group could separate everything, while another changes only inventory and experience.

Datapack profiles

Reusable dimension profiles that modpack developers can define and distribute through datapacks.

Administration and recovery tools

Improved commands for inspecting, resetting, migrating, exporting, and repairing individual player groups.

Additional compatibility

More integration hooks for custom inventories, equipment systems, accessory providers, and other player-data mods.