Omni Space
一款适用于 Minecraft Paper 的服务端插件,通过自定义虚空末地世界生成机制,为玩家提供私人的维度空间。
概述
Omni Space 是一款专为 Paper 1.21+ 服务器设计的维度管理插件。每位玩家都会获得一个专属的虚空维度,其中包含一个可定制的房间(尺寸为 3x3 至 9x9),最多可容纳 9 个储物方块(如箱子、桶、漏斗等)。玩家可以通过图形用户界面(GUI)系统从维度外部访问其物品。
传送门系统
- 圆形传送门:基于
Particle.PORTAL 和 Particle.END_ROD 粒子效果生成的垂直圆形传送门
- 物品吸收:投入传送门半径范围内的物品会被自动吸收并存储至该维度中
- 退出方式:玩家可通过抬头并向右击,或使用
/os back 命令来退出维度
GUI 系统
- 主菜单:使用 Bukkit Inventory API 构建的交互式 GUI(27 格大小)
- 箱子选择器:根据已注册的方块动态显示可选箱子
- 虚拟箱子:通过
/os inventory 命令查看的只读访问模式
- 实体箱子:在维度内右键点击时可完全正常使用
方块管理
- 自动注册:当方块被放置在维度内时,通过
BlockPlaceEvent 事件自动注册
- 自动移除:当方块被破坏时,通过
BlockBreakEvent 事件自动注销
- 所有权验证:只有维度所有者才能添加或移除方块
- 支持的方块:箱子、桶、漏斗、发射器、投掷器、熔炉、高炉、烟熏炉、工作台、酿造台、讲台均可转换为储物方块
功能
| 功能 |
说明 |
| 个人维度 |
每位玩家拥有独立的维度空间 |
| 物理方块 |
可在维度中放置并使用箱子 |
| 虚拟物品栏 |
可通过图形用户界面从外部查看箱内物品 |
| 自动注册 |
方块被放置时自动注册 |
| 独立储物 |
每个方块拥有独立的物品存储 |
| 维度升级 |
可使用钻石将维度从 3x3 扩展至 9x9 |
| 传送门系统 |
带有粒子效果的圆形传送门,可吸收物品 |
| 投掷入传送门 |
将物品投入传送门即可保存 |
| 返回原处 |
访问维度后可返回原始位置 |
| 抬头 + 右键退出 |
通过抬头并点击鼠标右键退出维度 |
命令
玩家命令
| 命令 |
描述 |
/os 或 /omnispace |
打开主 GUI 菜单 |
/os open |
打开通往你所在维度的传送门 |
/os close |
关闭当前激活的传送门 |
/os inventory 或 /os inv |
查看维度物品栏(虚拟,仅查看) |
/os back |
返回原始世界 |
/os upgrade |
升级维度大小(需要钻石) |
/os info |
显示维度信息 |
管理员命令
| 命令 |
描述 |
/osadmin <玩家> |
查看玩家的维度存储数据 |
配置
config.yml
portal:
radius: 1.5 # 传送门圆环半径(方块)
duration: 30 # 传送门开启持续时间(秒,0 = 永久开启)
particle-color: "PURPLE" # 粒子颜色
item-absorb-radius: 1.5 # 物品吸收半径
cooldown: 5 # 开启间隔冷却时间(秒)
space:
default-size: 3 # 初始维度尺寸
max-size: 9 # 最大升级尺寸
upgrade-cost:
material: DIAMOND
amount: 5
world-name: "omnispace_world"
---
### YAML 结构
```yaml
uuid: <玩家UUID>
size: 3
home:
world: omnispace_world
x: <X坐标>
y: <Y坐标>
z: <Z坐标>
origin:
world: <原始世界>
x: <X坐标>
y: <Y坐标>
z: <Z坐标>
chests:
chest_<x>_<y>_<z>:
x: <X坐标>
y: <Y坐标>
z: <Z坐标>
items: <Base64编码的物品列表>
权限
| 权限 |
默认值 |
描述 |
omnispace.use |
true |
基础 OmniSpace 访问权限 |
omnispace.admin |
op |
管理员访问权限(查看其他玩家的存储空间) |
许可证
MIT 许可证 - 可免费使用和修改。
支持
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
- 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧