Pocket Dimensions

Pocket Dimensions 0.0.8-ALPHA

Pocket Dimensions lets every player own a personal world, invite friends, set trust levels, teleport mobs, and customize generation. One jar supports Minecraft 1.19.4 → 26.3 (Bukkit, Spigot, Paper, Purpur).

Compatibility

The jar is compiled against the 1.19.4 API with Java 17 bytecode, so it runs on Java 17 servers and on Java 25 servers running 26.x. Existing configs are upgraded in place on startup: missing keys (including new protection toggles) are added without touching user values; messages.yml keeps custom text and falls back to the bundled defaults for new keys.

Commands

GUI — /pd menu

A two-view inventory. Sections are individually permission-gated:

• Travel (...pd.menu.teleport) — enter or leave your dimension.
• Trusted players (...pd.menu.trust) — one skull per trusted player; left-click cycles their tier (builder trusted), right-click removes. Adding new players: /pd trust <player>.
• Preset / Environment / Notifications (...pd.menu.settings) — cycle FLAT → VOID → NORMAL and NORMAL → NETHER → THE_END (applies on next creation) and toggle entry notifications.
• World border (...pd.menu.border) — shows the current and next tier size; click to upgrade.

Trust & protection

Dimension owners grant trust tiers. Everyone else (even past invitees) is a visitor:

• Visitor — can look around, use doors/buttons, but cannot build, break, open containers or hurt the owner's mobs.
• Builder — can build, break and use containers.
• Trusted — builder rights plus can invite other players into the dimension.
  Admins (and anyone with pocketdimensions.bypass.protection) bypass all of it. Explosions never damage blocks inside dimensions (configurable).

Dimension settings & presets

New dimensions are generated from dimension.default-preset (FLAT / VOID / NORMAL) and dimension.default-environment (NORMAL / NETHER / THE_END). Players can pick their own for their next creation via /pd settings or the menu. Existing worlds are never regenerated. /pd setspawn moves the in-dimension spawn; invited players and first entries arrive there.

Storage

Pick the backend in config.yml (storage.type):

• JSON (default) — lastlocs.json, pdborders.json, dimensions.json in the plugin folder; atomic, serialized writes. The first two are the same files 0.0.5 used.
• SQLITE / MYSQL — bundled JDBC drivers, nothing to install. Switching auto-imports existing JSON data once and renames the old files *.imported. Tables created on first boot: pd_locations, pd_borders, pd_meta, pd_trusts, pd_settings.

Economy (Vault) — disabled by default

1. Install Vault and any economy plugin (EssentialsX, CMI…).
2. Set economy.enabled: true in config.yml and set prices.
3. economy.creation-cost is charged the first time a player's world is created; economy.upgrades are the border tiers used by /pd upgrade and the menu.
   Without Vault (or with economy.enabled: false) everything works but is free.

World Management

Empty dimensions unload (after saving) after world-management.unload-delay-seconds; players who log out inside are returned on rejoin. entity-cap warns owners whose dimension exceeds the limit (0 = off).
On 26.1+ the server stores each dimension under <main world>/dimensions/minecraft/...; the plugin discovers, loads, deletes and resets both that layout and the older <server>/pocketdimensionworlds/... layout, including hosts that flatten the folder to pocketdimension-<uuid>.

Mob Teleportation

Right-click a mob with your key item (or the mob teleporter tool) to store it in your dimension or retrieve it back. Mobs standing in another player's dimension can only be moved by that dimension's owner.

• pocketdimensions.mobteleport.use — use the feature at all.
• pocketdimensions.mobteleport.store — send mobs in.
• pocketdimensions.mobteleport.retrieve — take mobs out.

Default Game Rules

Defaults live in config.yml (default-gamerules:); rule names are resolved at runtime with legacy fallbacks, so both 26.x and pre-1.21.11 spellings work on any server. Per-dimension overrides made with /pdgamerule are stored and win over the defaults.

---

Permission Reference

Recommended player rank (regular players):

- pocketdimensions.commands.players.pd
- pocketdimensions.commands.player.pd.invite
- pocketdimensions.commands.player.pd.kick
- pocketdimensions.commands.player.pd.trust
- pocketdimensions.commands.player.pd.setspawn
- pocketdimensions.commands.player.pd.upgrade
- pocketdimensions.commands.player.pd.settings
- pocketdimensions.commands.player.pd.menu
- pocketdimensions.commands.player.pdleave
- pocketdimensions.mobteleport.use
- pocketdimensions.mobteleport.store
- pocketdimensions.mobteleport.retrieve

Trusted/co-op rank (owners of shared dimensions): everything above plus pocketdimensions.commands.player.pd.trust.trusted.
To disable a feature for one player, negate their node (e.g. -pocketdimensions.commands.player.pd.upgrade in LuckPerms); to disable globally, set the matching features.* switch to false.

Config Reference

PlaceholderAPI

%pd_in_pd%, %pd_border%, %pd_visitors%, %pd_dimension_loaded%.

Developer API

Cancellable Bukkit events other plugins can listen to: PocketDimensionCreateEvent, PlayerEnterDimensionEvent, PlayerLeaveDimensionEvent, InviteSendEvent, MobTeleportEvent (package mc.lethargos.pocketdimensions.api.event).

This release: 0.0.8-ALPHA | Minecraft 1.19.4 - 26.3 | Java 17+ (26.x servers need Java 25).

---

NOTE: This is one of my first plugins and it is still under heavy development. There are definitely bugs. Please report them on my discord - https://discord.gg/H5XdXvb2pP or add them to https://github.com/lethy-r/PocketDimensions-Issues/issues