Dimension
Paper 和 Folia 服务器应得的的世界管理插件。
Dimension 是一款从零开始构建的世界管理插件,意味着我们并未基于任何现有项目进行二次开发。这是一个完全独立、现代、专为高速运行而设计、代码整洁且完全线程安全的插件,同时支持 Folia 和 Paper/Spigot。所有功能均可配置,所有消息均可编辑,没有任何事后拼凑的功能。如果你曾对 Multiverse 感到沮丧——比如卡顿、过时的代码、缺乏 Folia 支持——那么这就是你的答案。
兼容性
| 平台 |
支持情况 |
| Folia (26.2.x) |
✅ 原生支持 — 完全感知区域 |
| Paper (26.2.x) |
✅ 完整支持 |
| Spigot / Bukkit (26.2.x) |
✅ 完整支持 |
Dimension 在启动时会自动检测是否运行在 Folia 上,并相应地切换其整个调度系统。你在任何平台上放入同一个 JAR 文件即可,它就能正常工作。
Minecraft 版本: 26.2.x+
Java 版本: 21+
功能一览
- 创建、导入、克隆、删除、加载、卸载和重置世界
- 按世界设置的游戏模式强制、难度、PvP、天气、饥饿、飞行
- 内置物品栏分离(物品栏、生命值、经验值、食物值 — 按世界隔离)
- 命名锚点,用于快速跨世界传送
- 完整的传送门系统 — 在任何地方定义自定义传送门区域,包含目的地、权限和入场费
- 游戏内 GUI — 无需输入任何命令即可管理世界和传送门
- 通过 Vault 经济系统收取入场费
- 每个世界的玩家数量限制
- 世界黑名单(阻止在特定世界之间旅行)
- 每个世界自定义重生世界
- 完整的传送门控制(下界传送门和末地传送门)
- 实体清理命令
- 按世界管理游戏规则
- 坐标和生物群系读取命令
- 一条命令完成 Multiverse 迁移 — 即时导入旧配置文件
- 每个命令的每个参数都支持完整的 Tab 补全
- 100% 可配置的 MiniMessage 格式消息(RGB、渐变、全部支持)
- PlaceholderAPI 支持
- 异步配置文件 I/O — 永不阻塞主线程
- bStats 指标(默认可选退出)
命令
所有命令均使用 /dim(别名:/dimension、/dmv)。
| 命令 |
功能 |
/dim list [page] |
列出所有世界 |
/dim info <world> |
详细的世界信息 |
/dim who |
查看哪些玩家在世界中 |
/dim create <name> [options] |
创建一个新世界 |
/dim import <name> |
导入现有的世界文件夹 |
/dim clone <world> <newname> |
克隆一个世界 |
/dim delete <world> |
删除世界及其文件 |
/dim load <world> |
加载一个未加载的世界 |
/dim unload <world> |
卸载一个已加载的世界 |
/dim remove <world> |
停止跟踪一个世界(保留文件) |
/dim tp <player> <destination> |
传送到世界或锚点 |
/dim spawn <world> [player] |
前往世界的出生点 |
/dim setspawn <world> |
设置世界的出生点 |
/dim modify <world> <property> <value> |
更改世界属性 |
/dim gamerule <set|reset|list> [rule] [value] [world] |
管理游戏规则 |
/dim anchor <create|delete|list|tp> [name] |
管理锚点 |
/dim purge <world> <entitytype> |
从世界中清理实体 |
/dim regen <world> |
重置一个世界 |
/dim generators |
列出可用的自定义生成器 |
/dim coord |
显示当前坐标和生物群系 |
/dim reload |
重新加载所有配置文件 |
/dim version |
显示版本和平台信息 |
/dim about |
关于 Dimension |
/dim gui |
打开游戏内管理 GUI |
/dim portal <subcommand> |
管理传送门(见下文) |
/dim migrate |
从 Multiverse-Core 导入世界 |
传送门系统
Dimension 包含一个内置的传送门系统。传送门是自定义的长方体区域 — 任何形状、任何大小、任何世界中的任何位置 — 当玩家踏入时会被传送。
创建传送门
步骤 1 — 获取魔杖:
/dim portal wand
你将获得一根传送门魔杖(烈焰棒)。右键点击一个方块以设置角 1,左键点击以设置角 2。这两个角定义了整个区域。
步骤 2 — 创建传送门:
/dim portal create <name> <destination>
目的地的格式与 /dim tp 相同:
/dim portal create lobby w:hub
/dim portal create spawn a:mainhub
/dim portal create minigames e:arena:100,64,200:0:0
就是这样。任何走过所定义区域的玩家都将被传送。
传送门命令
| 命令 |
功能 |
/dim portal wand |
获取传送门选择魔杖 |
/dim portal pos1 |
在你的脚下设置角 1(魔杖的命令替代方案) |
/dim portal pos2 |
在你的脚下设置角 2 |
/dim portal create <name> <dest> |
从当前选择区域创建传送门 |
/dim portal delete <name> |
删除一个传送门 |
/dim portal list |
列出所有传送门 |
/dim portal info <name> |
显示传送门详情 |
/dim portal modify <name> <property> <value> |
更改传送门属性 |
/dim portal enable <name> |
启用一个传送门 |
/dim portal disable <name> |
禁用一个传送门 |
/dim portal tp <name> |
传送到传送门的目的地 |
传送门属性
| 属性 |
描述 |
destination |
传送门将玩家送往何处(w:/a:/e:/pl: 格式) |
permission |
所需的权限节点,或 none 表示所有人 |
fee |
入场费金额(需要 Vault)。0 = 免费 |
safe |
是否寻找安全着陆点(true/false) |
enabled |
传送门是否处于活动状态(true/false) |
传送门 GUI
从游戏内 GUI(/dim gui)或世界管理器直接打开传送门管理器。在那里,你可以使用法杖创建传送门、编辑目的地、切换传送门的开关状态以及删除它们——无需触碰命令行。
世界创建指南
普通主世界
/dim create myworld
就这样。默认为具有随机种子的主世界。
指定环境(下界 / 末地)
/dim create mynether NETHER
/dim create myend END
环境是第二个参数。选项为 NORMAL、NETHER、END。
平坦世界
平坦世界使用 Minecraft 内置的 FLAT 世界类型。将其作为第三个参数传入:
/dim create flatworld NORMAL FLAT
这将创建一个超平坦主世界,采用原版默认层级(基岩 → 泥土 → 草方块)。玩家将在默认高度的平坦表面上生成。
虚空世界
虚空世界需要自定义生成器。你需要在服务器上安装一个虚空生成器插件(例如 VoidGen 或任何注册了 void 生成器的插件)。
一旦安装了虚空生成器:
/dim create voidworld NORMAL void
第三个参数是生成器插件注册的生成器名称。运行 /dim generators 可查看服务器上所有可用的生成器。
如果你想要一个单一的起始平台,可以在世界创建后手动放置或使用结构图插件添加。
大型生物群系 / 放大版
/dim create bigworld NORMAL LARGE_BIOMES
/dim create tallworld NORMAL AMPLIFIED
自定义种子
/dim create myworld NORMAL default 123456789
参数顺序:name(名称)、environment(环境)、world type(世界类型)、seed(种子)。如果你只想拥有特定种子的普通世界,请使用 default 作为世界类型。
导入现有世界文件夹
如果你已经在服务器目录中有一个现成的世界文件夹:
/dim import <foldername>
Dimension 会注册并加载它。文件夹名称将成为世界名称。
克隆世界
将现有世界完整复制到一个新世界中:
/dim clone survival survival_backup
克隆过程是异步进行的——在文件复制期间,服务器保持响应状态。
游戏内 GUI
运行 /dim gui 以打开世界管理界面。在那里你可以:
- 浏览所有已跟踪的世界及其状态指示器
- 通过单击一键加载、卸载或传送到世界
- 通过切换按钮编辑世界设置(游戏模式、PvP、天气等)
- 通过引导向导创建新世界
- 打开传送门管理器以创建和配置传送门
- 通过专用的确认屏幕确认破坏性操作
命令行能做的所有事情,GUI 都能做——非常适合喜欢点击操作的管理员。
从 Multiverse-Core 迁移
如果你正从 Multiverse 切换过来,请运行:
/dim migrate
Dimension 会直接读取 Multiverse-Core 的 worlds.yml 并一次性导入所有已注册的世界。游戏模式、难度、PvP、飞行、重生世界、玩家限制和入场费等属性都会自动迁移。
无需手动编辑。已被 Dimension 跟踪的世界将被跳过。
配置世界
创建后,使用 /dim modify 调整任何属性,无需触碰配置文件:
/dim modify myworld gamemode CREATIVE
/dim modify myworld pvp false
/dim modify myworld difficulty PEACEFUL
/dim modify myworld allow-flight true
/dim modify myworld monsters false
/dim modify myworld weather-enabled false
/dim modify myworld player-limit 10
/dim modify myworld respawn-world world
/dim modify myworld alias "<gradient:green:aqua>My World</gradient>"
完整属性列表:
| 属性 |
描述 |
alias |
显示名称(MiniMessage 格式) |
gamemode |
SURVIVAL, CREATIVE, ADVENTURE, SPECTATOR |
difficulty |
PEACEFUL, EASY, NORMAL, HARD |
pvp |
true / false |
animals |
true / false |
monsters |
true / false |
weather-enabled |
true / false |
hunger |
true / false |
auto-heal |
true / false |
allow-flight |
true / false |
bed-respawn |
true / false |
keep-spawn-in-memory |
true / false |
hidden |
从 /dim list 中隐藏 |
portal-forming |
NONE, ALL, NETHER, END |
respawn-world |
世界名称或为空 |
world-blacklist |
逗号分隔的世界名称列表 |
player-limit |
数字或 -1 表示无限制 |
scale |
下界传送门链接比例(下界默认为 8.0) |
entry-fee-enabled |
true / false(需要 Vault) |
entry-fee-amount |
小数金额 |
锚点
锚点是未与世界出生点绑定的命名传送点。在你站立的位置创建一个:
/dim anchor create hub
/dim anchor create arena1
传送到锚点:
/dim tp PlayerName a:hub
锚点存储在 anchors.yml 中,并在重载后保留。任何拥有 dimension.anchor.use 权限的玩家都可以传送到这些锚点。创建和删除锚点需要 dimension.anchor.manage 权限。
目的地
/dim tp 命令(以及传送门)支持四种目的地格式:
| 格式 |
示例 |
前往位置 |
w:worldname |
w:survival |
世界出生点 |
e:world:x,y,z:pitch:yaw |
e:survival:100,64,200:0:90 |
精确坐标 |
pl:playername |
pl:Steve |
另一名玩家的位置 |
a:anchorname |
a:hub |
命名锚点 |
物品栏分离
在 config.yml 中启用:
settings:
inventory-separation: true
启用后,每个世界都有独立的物品栏、生命值、饥饿值、经验值和药水效果。切换世界时会自动保存并恢复该世界的状态。
权限
| 权限 |
默认值 |
描述 |
dimension.admin |
op |
所有权限 |
dimension.list |
everyone |
列出世界 |
dimension.info |
everyone |
世界信息 |
dimension.who |
everyone |
玩家位置 |
dimension.coord |
everyone |
坐标 |
dimension.version |
everyone |
版本信息 |
dimension.spawn.self |
everyone |
前往世界出生点 |
dimension.anchor.use |
everyone |
使用锚点 |
dimension.portal |
everyone |
穿过传送门 |
dimension.tp.self |
op |
传送自身 |
dimension.tp.other |
op |
传送其他玩家 |
dimension.spawn.other |
op |
将玩家发送到出生点 |
dimension.setspawn |
op |
设置世界出生点 |
dimension.create |
op |
创建世界 |
dimension.import |
op |
导入世界 |
dimension.clone |
op |
克隆世界 |
dimension.delete |
op |
删除世界 |
dimension.load |
op |
加载世界 |
dimension.unload |
op |
卸载世界 |
dimension.remove |
op |
从追踪中移除 |
dimension.regen |
op |
重新生成世界 |
dimension.purge |
op |
清除实体 |
dimension.modify |
op |
修改属性 |
dimension.gamerule |
op |
管理游戏规则 |
dimension.reload |
op |
重载配置 |
dimension.anchor.manage |
op |
创建/删除锚点 |
dimension.generators |
op |
列出生成器 |
dimension.gui |
op |
打开 GUI |
dimension.portal.manage |
op |
创建/修改/删除传送门 |
dimension.portal.tp |
op |
通过命令传送到传送门 |
dimension.migrate |
op |
运行 Multiverse 迁移 |
dimension.bypass.gamemode |
false |
绕过游戏模式限制 |
配置
首次运行时,会在 plugins/Dimension/ 文件夹内生成四个配置文件。
config.yml — 全局设置,如安全传送、自动加载、传送门处理、物品栏分离以及性能调优。
worlds.yml — 由插件自动维护。存储每个被追踪世界的状态。你可以在服务器停止时手动编辑它,但在服务器运行时请使用 /dim modify。
messages.yml — 插件发送的每条消息。完全支持 MiniMessage,包括十六进制颜色、渐变以及点击/悬停事件。未来更新中添加的新键会自动合并,而不会覆盖你的自定义内容。
anchors.yml — 当你使用 /dim anchor create/delete 时自动管理。
portals.yml — 当你创建和删除传送门时自动管理。
无需重启即可重载所有配置文件:
/dim reload
PlaceholderAPI
如果已安装 PlaceholderAPI,Dimension 会自动注册其自身的占位符。无需下载额外的扩展包。
软依赖
两者均为完全可选。即使缺少任一依赖,插件也能正常加载和运行:
- Vault — 启用入场费系统。如果没有它,入场费将被静默禁用。
- PlaceholderAPI — 在支持 PAPI 的其他插件中启用占位符。
Folia — 这意味着什么
Folia 将你的服务器拆分为在独立线程上运行的区域。大多数插件在 Folia 上会崩溃,因为它们在不正确的线程上调度任务。
Dimension 是专门围绕这一机制编写的。它使用:
- RegionScheduler 用于与位置相关的任务(天气、出生点强制)
- EntityScheduler 用于玩家任务(传送、游戏模式更改)—— 任务会跟随玩家跨区域移动
- AsyncScheduler 用于所有文件 I/O 和配置保存
- GlobalRegionScheduler 用于服务器范围的操作(世界加载/卸载)
在普通的 Paper 服务器上,完全相同的代码路径会通过 BukkitScheduler 等效项执行。同一个 JAR,相同的行为,不同的后端。
统计
由 SneakyWrld 构建
Dimension
The world management plugin that Paper and Folia servers deserve.
Dimension is a from-scratch world management plugin, meaning we didn't build off anything, this is a totally independant, modern, built to be fast, clean, and fully thread-safe plugin, on both Folia and Paper/Spigot. Every feature is configurable, every message is editable, and nothing is bolted on as an afterthought. If you've ever been frustrated by Multiverse, the lag, the outdated code, the lack of Folia support, this is the answer.
Compatibility
| Platform |
Supported |
| Folia (26.2.x) |
✅ Native — fully region-aware |
| Paper (26.2.x) |
✅ Full support |
| Spigot / Bukkit (26.2.x) |
✅ Full support |
Dimension auto-detects whether it's running on Folia at startup and switches its entire scheduling system accordingly. You drop in the same JAR on any platform — it just works.
Minecraft version: 26.2.x+
Java version: 21+
Features at a Glance
- Create, import, clone, delete, load, unload, and regenerate worlds
- Per-world gamemode enforcement, difficulty, PvP, weather, hunger, flight
- Built-in inventory separation (inventories, health, XP, food — per world)
- Named anchors for quick cross-world teleportation
- Full portal system — define custom portal regions anywhere, with destinations, permissions, and entry fees
- In-game GUI — manage worlds and portals without typing a single command
- Entry fees via Vault economy
- Player limits per world
- World blacklists (block travel between specific worlds)
- Custom respawn world per world
- Full portal control (nether and end portals)
- Entity purge command
- Gamerule management per world
- Coordinate and biome readout command
- One-command Multiverse migration — import your old config instantly
- Full tab completion on every argument of every command
- 100% configurable messages in MiniMessage format (RGB, gradients, all of it)
- PlaceholderAPI support
- Async config I/O — never blocks the main thread
- bStats metrics (opt-out as always)
Commands
All commands use /dim (aliases: /dimension, /dmv).
| Command |
What it does |
/dim list [page] |
List all worlds |
/dim info <world> |
Detailed world info |
/dim who |
See which players are in which world |
/dim create <name> [options] |
Create a new world |
/dim import <name> |
Import an existing world folder |
/dim clone <world> <newname> |
Clone a world |
/dim delete <world> |
Delete a world and its files |
/dim load <world> |
Load an unloaded world |
/dim unload <world> |
Unload a loaded world |
/dim remove <world> |
Stop tracking a world (files kept) |
/dim tp <player> <destination> |
Teleport to a world or anchor |
/dim spawn <world> [player] |
Go to a world's spawn |
/dim setspawn <world> |
Set the spawn for a world |
/dim modify <world> <property> <value> |
Change a world property |
/dim gamerule <set|reset|list> [rule] [value] [world] |
Manage game rules |
/dim anchor <create|delete|list|tp> [name] |
Manage anchors |
/dim purge <world> <entitytype> |
Purge entities from a world |
/dim regen <world> |
Regenerate a world |
/dim generators |
List available custom generators |
/dim coord |
Show your current coordinates and biome |
/dim reload |
Reload all config files |
/dim version |
Show version and platform info |
/dim about |
About Dimension |
/dim gui |
Open the in-game management GUI |
/dim portal <subcommand> |
Manage portals (see below) |
/dim migrate |
Import worlds from Multiverse-Core |
Portal System
Dimension includes a built-in portal system. Portals are custom cuboid regions — any shape, any size, anywhere in any world — that teleport players when they step inside.
Creating a portal
Step 1 — Get the wand:
/dim portal wand
You'll receive a Portal Wand (a blaze rod). Right-click a block to set corner 1, left-click to set corner 2. The two corners define the entire region.
Step 2 — Create the portal:
/dim portal create <name> <destination>
The destination uses the same format as /dim tp:
/dim portal create lobby w:hub
/dim portal create spawn a:mainhub
/dim portal create minigames e:arena:100,64,200:0:0
That's it. Anyone who walks through the defined region will be teleported.
Portal commands
| Command |
What it does |
/dim portal wand |
Get the portal selection wand |
/dim portal pos1 |
Set corner 1 at your feet (command alternative to wand) |
/dim portal pos2 |
Set corner 2 at your feet |
/dim portal create <name> <dest> |
Create a portal from your current selection |
/dim portal delete <name> |
Delete a portal |
/dim portal list |
List all portals |
/dim portal info <name> |
Show portal details |
/dim portal modify <name> <property> <value> |
Change a portal property |
/dim portal enable <name> |
Enable a portal |
/dim portal disable <name> |
Disable a portal |
/dim portal tp <name> |
Teleport to a portal's destination |
Portal properties
| Property |
Description |
destination |
Where the portal sends players (w:/a:/e:/pl: format) |
permission |
Required permission node, or none for everyone |
fee |
Entry fee amount (requires Vault). 0 = free |
safe |
Whether to find a safe landing spot (true/false) |
enabled |
Whether the portal is active (true/false) |
Portal GUI
Open the portal manager from the in-game GUI (/dim gui) or directly from the world manager. From there you can create portals with the wand, edit destinations, toggle portals on/off, and delete them — all without touching the command line.
World Creation Guide
Normal overworld
/dim create myworld
That's it. Defaults to a normal overworld with a random seed.
Specify environment (Nether / End)
/dim create mynether NETHER
/dim create myend END
The environment is the second argument. Options are NORMAL, NETHER, END.
Flat world
Flat worlds use Minecraft's built-in FLAT world type. Pass it as the third argument:
/dim create flatworld NORMAL FLAT
This creates a superflat overworld with the vanilla default layers (bedrock → dirt → grass). Players spawn on a flat surface at the default height.
Void world
A void world needs a custom generator. You'll need a void generator plugin installed on your server (such as VoidGen or any plugin that registers a void generator).
Once a void generator is installed:
/dim create voidworld NORMAL void
The third argument is the generator name as registered by the generator plugin. Run /dim generators to see all available generators on your server.
If you want a single starting platform, place it manually or use a schematic plugin after the world is created.
Large biomes / amplified
/dim create bigworld NORMAL LARGE_BIOMES
/dim create tallworld NORMAL AMPLIFIED
Custom seed
/dim create myworld NORMAL default 123456789
Argument order: name, environment, world type, seed. Use default as the world type if you just want a normal world with a specific seed.
Import an existing world folder
If you have a world folder already sitting in your server directory:
/dim import <foldername>
Dimension will register it and load it. The folder name becomes the world name.
Clone a world
Makes a full copy of an existing world into a new one:
/dim clone survival survival_backup
The clone is done asynchronously — the server stays responsive while files are being copied.
In-Game GUI
Run /dim gui to open the world management interface. From there you can:
- Browse all tracked worlds with status indicators
- Load, unload, or teleport to worlds with a single click
- Edit world settings (gamemode, PvP, weather, etc.) with toggle buttons
- Create new worlds through a guided wizard
- Open the portal manager to create and configure portals
- Confirm destructive actions through a dedicated confirmation screen
Everything the command line can do, the GUI can do — useful for admins who prefer point-and-click.
Migrating from Multiverse-Core
If you're switching from Multiverse, run:
/dim migrate
Dimension reads Multiverse-Core's worlds.yml directly and imports all registered worlds in one shot. Properties like gamemode, difficulty, PvP, flight, respawn world, player limits, and entry fees are all carried over automatically.
No manual editing required. Worlds that are already tracked by Dimension are skipped.
Configuring Worlds
After creation, use /dim modify to tune any property without touching a config file:
/dim modify myworld gamemode CREATIVE
/dim modify myworld pvp false
/dim modify myworld difficulty PEACEFUL
/dim modify myworld allow-flight true
/dim modify myworld monsters false
/dim modify myworld weather-enabled false
/dim modify myworld player-limit 10
/dim modify myworld respawn-world world
/dim modify myworld alias "<gradient:green:aqua>My World</gradient>"
Full list of properties:
| Property |
Description |
alias |
Display name (MiniMessage format) |
gamemode |
SURVIVAL, CREATIVE, ADVENTURE, SPECTATOR |
difficulty |
PEACEFUL, EASY, NORMAL, HARD |
pvp |
true / false |
animals |
true / false |
monsters |
true / false |
weather-enabled |
true / false |
hunger |
true / false |
auto-heal |
true / false |
allow-flight |
true / false |
bed-respawn |
true / false |
keep-spawn-in-memory |
true / false |
hidden |
Hide from /dim list |
portal-forming |
NONE, ALL, NETHER, END |
respawn-world |
World name or empty |
world-blacklist |
Comma-separated world names |
player-limit |
Number or -1 for unlimited |
scale |
Nether portal linking scale (default 8.0 for nether) |
entry-fee-enabled |
true / false (requires Vault) |
entry-fee-amount |
Decimal amount |
Anchors
Anchors are named teleport points that aren't tied to a world spawn. Create one where you're standing:
/dim anchor create hub
/dim anchor create arena1
Teleport to an anchor:
/dim tp PlayerName a:hub
Anchors are stored in anchors.yml and survive reloads. Any player with dimension.anchor.use can teleport to them. Creating and deleting anchors requires dimension.anchor.manage.
Destinations
The /dim tp command (and portals) support four destination formats:
| Format |
Example |
Goes to |
w:worldname |
w:survival |
World spawn |
e:world:x,y,z:pitch:yaw |
e:survival:100,64,200:0:90 |
Exact coordinates |
pl:playername |
pl:Steve |
Another player's location |
a:anchorname |
a:hub |
Named anchor |
Inventory Separation
Enable it in config.yml:
settings:
inventory-separation: true
When enabled, each world has its own inventory, health, hunger, XP, and potion effects. Switching worlds saves and restores your state for that world automatically.
Permissions
| Permission |
Default |
Description |
dimension.admin |
op |
All permissions |
dimension.list |
everyone |
List worlds |
dimension.info |
everyone |
World info |
dimension.who |
everyone |
Player locations |
dimension.coord |
everyone |
Coordinates |
dimension.version |
everyone |
Version info |
dimension.spawn.self |
everyone |
Go to world spawn |
dimension.anchor.use |
everyone |
Use anchors |
dimension.portal |
everyone |
Walk through portals |
dimension.tp.self |
op |
Teleport self |
dimension.tp.other |
op |
Teleport others |
dimension.spawn.other |
op |
Send player to spawn |
dimension.setspawn |
op |
Set world spawn |
dimension.create |
op |
Create worlds |
dimension.import |
op |
Import worlds |
dimension.clone |
op |
Clone worlds |
dimension.delete |
op |
Delete worlds |
dimension.load |
op |
Load worlds |
dimension.unload |
op |
Unload worlds |
dimension.remove |
op |
Remove from tracking |
dimension.regen |
op |
Regenerate worlds |
dimension.purge |
op |
Purge entities |
dimension.modify |
op |
Modify properties |
dimension.gamerule |
op |
Manage game rules |
dimension.reload |
op |
Reload configs |
dimension.anchor.manage |
op |
Create/delete anchors |
dimension.generators |
op |
List generators |
dimension.gui |
op |
Open the GUI |
dimension.portal.manage |
op |
Create/modify/delete portals |
dimension.portal.tp |
op |
Teleport to portals via command |
dimension.migrate |
op |
Run Multiverse migration |
dimension.bypass.gamemode |
false |
Bypass gamemode enforcement |
Configuration
Four config files are generated on first run inside your plugins/Dimension/ folder.
config.yml — global settings like safe teleport, auto-load, portal handling, inventory separation, and performance tuning.
worlds.yml — automatically maintained by the plugin. Stores the state of every tracked world. You can edit it manually while the server is stopped, but use /dim modify while it's running.
messages.yml — every single message the plugin sends. Full MiniMessage support including hex colours, gradients, and click/hover events. New keys added in future updates are automatically merged in without overwriting your customizations.
anchors.yml — managed automatically when you use /dim anchor create/delete.
portals.yml — managed automatically when you create and delete portals.
To reload all config files without restarting:
/dim reload
PlaceholderAPI
If PlaceholderAPI is installed, Dimension registers its own placeholders automatically. No additional expansion download needed.
Soft Dependencies
Both are completely optional. The plugin loads and runs fine without either:
- Vault — enables the entry fee system. Without it, entry fees are silently disabled.
- PlaceholderAPI — enables placeholders in other plugins that support PAPI.
Folia — What That Means
Folia splits your server into regions that run on separate threads. Most plugins break on Folia because they schedule tasks on the wrong thread.
Dimension was written specifically around this. It uses:
- RegionScheduler for location-bound tasks (weather, spawn enforcement)
- EntityScheduler for player tasks (teleports, gamemode changes) — the task follows the player across regions
- AsyncScheduler for all file I/O and config saving
- GlobalRegionScheduler for server-wide operations (world load/unload)
On regular Paper the exact same code paths execute through BukkitScheduler equivalents. Same JAR, same behaviour, different backend.
Statistics
Built by SneakyWrld
评论 0
登录后参与评分
还没有评论,来抢沙发吧