Dimensions

插件

· 作者 protectcord

这是一个多世界插件,专为 Folia 构建!同时也支持 Bukkit/Paper/Spigot 服务器!

0 本站下载 0 关注 更新于 3 个月前

最新 1.0.1 · 26.2 · Bukkit / Folia

一键开服(送7天)

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 构建

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源