Omni Space

Version Paper Java

A Minecraft Paper plugin that provides players with private dimension spaces using custom void End world generation.

Overview

Omni Space is a dimension management plugin for Paper 1.21+ servers. Each player receives a personal void dimension with a customizable room (3x3 to 9x9) containing up to 9 inventory blocks (Chest, Barrel, Hopper, etc.). Players can access their items from outside the dimension through a GUI system.

Portal System

Circle Portal: Particle-based vertical circle using Particle.PORTAL and Particle.END_ROD
Item Absorption: Items thrown into portal radius are automatically absorbed and stored in dimension
Exit Method: Players can exit dimension by looking up and right-clicking, or by using /os back command

GUI System

Main Menu: Interactive GUI using Bukkit Inventory API (27 slots)
Chest Selector: Dynamic chest selection based on registered blocks
Virtual Chest: View-only access from /os inventory command
Physical Chest: Fully usable when right-clicked in dimension

Block Management

Auto-Registration: Blocks automatically register when placed in dimension via BlockPlaceEvent
Auto-Removal: Blocks unregister when destroyed via BlockBreakEvent
Ownership Validation: Only dimension owner can add/remove blocks
Supported Blocks: Chest, Barrel, Hopper, Dispenser, Dropper, Furnace, Blast Furnace, Smoker, Crafting Table, Brewing Stand, Lectern, turn into inventory blocks

Features

Feature	Description
Personal Dimensions	Each player gets their own dimension space
Physical Blocks	Place and use chests directly in dimension
Virtual Inventory	View chest contents from outside via GUI
Auto-Registration	Blocks automatically register when placed
Per-Chest Storage	Each block has independent item storage
Dimension Upgrade	Expand from 3x3 to 9x9 with Diamond
Portal System	Circle particle portal with item absorption
Throw to Portal	Save items by throwing them into the portal
Teleport Back	Return to original location after dimension visit
Look Up + Right Click	Exit dimension by looking up and right-clicking

Commands

Player Commands

Command	Description
`/os` or `/omnispace`	Open main GUI menu
`/os open`	Open portal to your dimension
`/os close`	Close active portal
`/os inventory` or `/os inv`	View dimension inventory (virtual, view-only)
`/os back`	Return to original world
`/os upgrade`	Upgrade dimension size (costs Diamonds)
`/os info`	Show dimension information

Admin Commands

Command	Description
`/osadmin <player>`	View player's dimension storage

Configuration

config.yml

portal:
  radius: 1.5                    # Portal circle radius (blocks)
  duration: 30                  # Portal open duration (seconds, 0 = permanent)
  particle-color: "PURPLE"      # Particle color
  item-absorb-radius: 1.5       # Item absorption radius
  cooldown: 5                   # Cooldown between opens (seconds)

space:
  default-size: 3               # Initial dimension size
  max-size: 9                   # Maximum upgrade size
  upgrade-cost:
    material: DIAMOND
    amount: 5
  world-name: "omnispace_world"

YAML Structure

uuid: <player-uuid>
size: 3
home:
  world: omnispace_world
  x: <x-coordinate>
  y: <y-coordinate>
  z: <z-coordinate>
origin:
  world: <original-world>
  x: <x-coordinate>
  y: <y-coordinate>
  z: <z-coordinate>
chests:
  chest_<x>_<y>_<z>:
    x: <x-coordinate>
    y: <y-coordinate>
    z: <z-coordinate>
    items: <base64-encoded-item-list>