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>

---

Permissions

Permission	Default	Description
omnispace.use	true	Basic OmniSpace access
omnispace.admin	op	Admin access (view other players' storage)

---

License

MIT License - Free to use and modify.

---

Support