Private Dimension

PrivateDimension

A private dimension plugin for Paper 1.21.5+

About This Plugin

This plugin is a derivative work of Private_Dimension created by Chuzume.

PrivateDimension is a Paper/Spigot plugin reimplementation of the original data pack. All copyrights and other rights related to the original concept and assets belong to Chuzume.

Neither the developer nor the distributor of this plugin shall be held responsible for any issues, damages, or losses resulting from its installation or use.

Original Work & References

• Creator: @Chuzume
• Repository: https://github.com/Chuzume/Private_Dimension
• Video: https://www.youtube.com/watch?v=NrwN3NJLuiA

Overview

Using a Dimension in a Bottle allows players to enter their own private dimension.

Each dimension contains a dedicated 48×48 plot generated exclusively for its owner.

This plugin recreates the functionality of the original Private_Dimension data pack for Paper servers.

Features

Crafting Recipe

The item can be crafted using a normal crafting table.

Dimension in a Bottle

Requirements

• Paper (or Spigot) 1.21.5+ — targeting the same version range as the companion mod (1.21.5–26.1.2); multi-version compatibility testing is ongoing
• Java 21+
• Geyser (optional, for Bedrock Edition support)

Installation

1. Place PrivateDimension-*.jar into your plugins/ folder.
2. Restart the server.
3. The private_dimension world will be generated automatically on startup.

Commands

All subcommands and player names (for /pd give) support tab completion.

Permissions

Plot Boundary Bypass

By default, leaving your plot pushes you back inside it. There are two ways to bypass this:

• Operators (permission level 2+) always bypass the boundary check.

• Tagged players can bypass it too. Grant the bypass tag (default: pd_free, configurable via plotBypassTag in the config) using the vanilla /tag command:

  /tag <player> add pd_free
  

  Remove it with /tag <player> remove pd_free.

  Example: /tag Steve add pd_free lets the player Steve freely leave any plot.

Configuration (config.yml)

language: "en"                    # Display language: "en" or "ja" (or your own, see "Language" below)
world-name: "private_dimension"   # Dimension world name
plot-size: 48                     # Plot size
plot-spacing: 128                 # Distance between plots
plot-floor-y: 64                  # Plot floor Y level (spawn Y = floor-y + 5 = 69, refined by safe-spawn search)
plot-height: 47                   # Structure height (Y size), used for plot boundary checks and safe-spawn search
structure-file: "plot48x48.nbt"   # Structure filename; see "Custom Structures" below
safe-spawn-search-radius: 8       # Horizontal search radius (blocks) for the safe-spawn search
safe-spawn-search-height: 12      # Vertical search range (blocks, up and down) for the safe-spawn search
plot-bypass-tag: "pd_free"        # Players with this scoreboard tag skip plot boundary enforcement
debug-logging: false              # Verbose console logs for the safe-spawn search / boundary checks (troubleshooting)
pull-entity-limit: 10             # Maximum entities that can be transported
pull-entity-radius: 3.0           # Entity transport radius
enable-border-enforcement: true   # Push players back into their plot when they leave its boundary

config.yml ships with bilingual (Japanese/English) comments for every setting, regardless of the language value — the comments themselves are just documentation and aren't affected by the display-language setting.

Language

All chat messages, command output, and the item's display name/lore come from plugins/PrivateDimension/lang/<language>.yml, matching whatever language is set to in config.yml.

• en and ja are bundled and extracted automatically on first run.
• To add your own language: copy plugins/PrivateDimension/lang/en.yml to a new file with your language code (e.g. fr.yml), translate it, then set language: "fr" in config.yml and run /pd reload (or restart).
• If a language file can't be found (neither bundled nor present in the lang folder), the plugin logs a warning and falls back to en.
• Any keys missing from a custom language file automatically fall back to the English text, so a partial translation still works.
• plugins/PrivateDimension/structures/README.txt is always written in both Japanese and English, regardless of the language setting (it's generated once, on first startup, so delete it if you want it regenerated).

Custom Structures (Custom NBT)

By default the plugin bundles plot48x48.nbt. To use your own layout:

1. Save your structure as a Vanilla Structure Block file (.nbt), e.g. via a Structure Block set to Save mode in-game.
2. Start the server once so plugins/PrivateDimension/structures/ is created (a README.txt with instructions is generated there).
3. Copy your .nbt file into that folder using the same name as structure-file in config.yml (or update structure-file to match your filename).
4. If your structure's footprint or height differs from 48×48×47, update plot-size / plot-height accordingly.
5. Run /pd reload or restart the server.

Because the plugin performs a safe-spawn search (scanning outward from the calculated spawn point for solid ground with clear space above), players will spawn correctly on custom structures even if the floor height differs from the default — you generally don't need to hand-tune the spawn Y offset. This same search is also used when a player is pushed back into their plot after crossing the boundary.

Credits

PrivateDimension is based on the original Private_Dimension data pack created by Chuzume and is distributed in accordance with the terms of the original license.