Omni Space

Omni Space

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

- Exit Method: Particle-based vertical circle using `Particle.PORTAL` and `Particle.END_ROD` - Exit Method: 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

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

Block Management

- Supported Blocks: Blocks automatically register when placed in dimension via `BlockPlaceEvent` - Supported Blocks: Blocks unregister when destroyed via `BlockBreakEvent` - Supported Blocks: 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 | |---------|-------------| | Look Up + Right Click | Each player gets their own dimension space | | Look Up + Right Click | Place and use chests directly in dimension | | Look Up + Right Click | View chest contents from outside via GUI | | Look Up + Right Click | Blocks automatically register when placed | | Look Up + Right Click | Each block has independent item storage | | Look Up + Right Click | Expand from 3x3 to 9x9 with Diamond | | Look Up + Right Click | Circle particle portal with item absorption | | Look Up + Right Click | Save items by throwing them into the portal | | Look Up + Right Click | 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

```yaml 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

```yaml 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