Omni Space

# Omni Space !(https://img.shields.io/badge/Version-1.0.0--R-blue) !(https://img.shields.io/badge/Paper-1.21.1--1.21.11+-purple) !(https://img.shields.io/badge/Java-17+-orange) 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 ```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