Pocket Dimensions

插件

· 作者 lethargos

为你的玩家创建自定义的口袋维度!他们可以邀请和踢出其他玩家,并使用特殊物品在现实世界和他们的口袋维度之间穿梭!

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

最新 0.0.8 · 26.3 · Bukkit / Paper

一键开服(送7天)

Pocket Dimensions 0.0.8-ALPHA

Pocket Dimensions 让每位玩家都拥有个人世界,支持邀请好友、设置信任等级、传送生物以及自定义生成。单个 jar 文件支持 Minecraft 1.19.4 → 26.3(Bukkit、Spigot、Paper、Purpur)。

兼容性

服务器版本 Java 备注
1.19.4 – 1.21.11 17+ 旧版 Bukkit 世界文件夹;camelCase 格式的游戏规则。
26.1 – 26.2 25 世界数据移动至 <world>/dimensions/minecraft/... 下;插件自动解析这两种布局。
26.3 25 游戏规则名称为 snake_case 格式(如 keep_inventory、spawn_mobs);插件接受 camelCase 格式的配置文件值并进行转换。26.3 的搁板/垫子功能及 26.1 之后的世界布局受到保护和支持。

该 jar 文件基于 1.19.4 API 并使用 Java 17 字节码编译,因此可在运行 Java 17 的服务器上运行,也可在运行 26.x 版本的 Java 25 服务器上运行。现有配置会在启动时就地升级:缺失的键(包括新的保护开关)会被添加,而不会修改用户原有的值;messages.yml 会保留自定义文本,并为新键回退到内置默认值。

指令

指令 用法 权限 描述
/givepd /givepd <player> [dimension|mobtool] pocketdimensions.commands.givepd 给予绑定给 <player> 的 PD 物品(该物品仅对该玩家有效)。mobtool 需要 pocketdimensions.commands.givepd.tool。
/pdtp /pdtp <player> pocketdimensions.commands.pdtp 管理员传送至任意玩家的维度(支持离线玩家)。
/pd /pd <action> [args] pocketdimensions.commands.players.pd 基础指令;以下每个操作都有各自的权限。
/pd invite <player> pocketdimensions.commands.player.pd.invite 邀请一名玩家加入你所在的维度(120秒后过期)。仅在你对该维度拥有信任时,才能邀请他人进入他人的维度。
/pd acceptinv [player] pocketdimensions.commands.player.pd.invite 接受待处理的邀请;若有多个邀请,请选择发送者。
/pd kick <player> pocketdimensions.commands.player.pd.kick 将一名玩家踢出你的维度。
/pd trust <player> [builder|trusted] pocketdimensions.commands.player.pd.trust 授予你在维度中的信任。默认等级:builder。trusted 还需要 ...pd.trust.trusted。
/pd untrust <player> pocketdimensions.commands.player.pd.trust 撤销信任。
/pd setspawn pocketdimensions.commands.player.pd.setspawn 将你所在位置的坐标设置为维度的出生点。
/pd upgrade pocketdimensions.commands.player.pd.upgrade 将你的边界升级到下一个配置好的等级(如果启用了经济系统,则会收费)。
/pd settings [preset|environment|notify] [value] pocketdimensions.commands.player.pd.settings 查看或更改你的维度预设、环境和入场通知。在你下次创建维度时生效。
/pd menu pocketdimensions.commands.player.pd.menu 打开 GUI 菜单。
/pdleave /pdleave pocketdimensions.commands.player.pdleave 离开当前口袋维度。
/pdgamerule /pdgamerule <player> <rule> [value] pocketdimensions.commands.pdgamerule 查看或设置玩家维度中的一个游戏规则——按维度持久化保存,并在每次进入时重新应用。
/pdworldborder /pdworldborder <player> <size> pocketdimensions.commands.pdworldborder 直接设置玩家的边界大小。
/pdreload /pdreload pocketdimensions.commands.reload 重载配置文件、消息、生物传送设置、保护附加项和经济钩子。存储类型的更改需要重启服务器。
/pdlist /pdlist pocketdimensions.commands.admin.list 列出所有维度:所有者、加载状态、边界、最后在线时间。

| /pdadmin | 见下文 | pocketdimensions.commands.admin.* | /pdadmin delete <玩家> confirm(世界和所有数据),/pdadmin reset <玩家> confirm(仅世界,保留数据),/pdadmin cleanup <天数> confirm(移除 N 天未活跃玩家的分维度)。当有玩家处于其中时会拒绝执行。 |

GUI — /pd menu

一个双视图的物品栏。各个部分均有独立的权限限制:

  • Travel(...pd.menu.teleport)—— 进入或离开你的维度。
  • Trusted players(...pd.menu.trust)—— 每位受信任的玩家显示一个头颅图标;左键点击可切换其等级(Builder ↔ Trusted),右键点击可移除。添加新玩家:/pd trust <player>。
  • Preset / Environment / Notifications(...pd.menu.settings)—— 循环切换 FLAT → VOID → NORMAL 以及 NORMAL → NETHER → THE_END(在下一次创建时生效),并切换入口通知。
  • World border(...pd.menu.border)—— 显示当前和下一等级的边界大小;点击即可升级。

Trust & protection

维度所有者授予信任等级。其他所有人(包括之前的受邀者)均为访客:

  • Visitor —— 可以四处查看、使用门/按钮,但不能建造、破坏、打开容器或攻击所有者的生物。
  • Builder —— 可以建造、破坏和使用容器。
  • Trusted —— 拥有 Builder 的权限 并且 可以邀请其他玩家进入该维度。 管理员(以及任何拥有 pocketdimensions.bypass.protection 权限的人)不受上述限制。爆炸永远不会损坏维度内的方块(可配置)。

Dimension settings & presets

新维度基于 dimension.default-preset(FLAT / VOID / NORMAL)和 dimension.default-environment(NORMAL / NETHER / THE_END)生成。玩家可通过 /pd settings 命令或菜单为自己下一次创建的维度选择自定义设置。现有世界不会被重新生成。/pd setspawn 会更改维度内的出生点;受邀玩家和首次进入者将在此处出现。

存储

在 config.yml(storage.type)中选择后端:

  • JSON(默认)—— 插件文件夹中的 lastlocs.json、pdborders.json、dimensions.json;采用原子序列化写入。前两个文件与 0.0.5 版本使用的文件相同。
  • SQLITE / MYSQL —— 内置 JDBC 驱动,无需安装。切换时会自动导入一次现有的 JSON 数据,并将旧文件重命名为 *.imported。首次启动时创建以下表:pd_locations、pd_borders、pd_meta、pd_trusts、pd_settings。

经济(Vault)—— 默认禁用

  1. 安装 Vault 以及任意经济类插件(如 EssentialsX、CMI…)。
  2. 在 config.yml 中设置 economy.enabled: true 并配置价格。
  3. economy.creation-cost 会在玩家的世界首次创建时收取费用;economy.upgrades 对应 /pd upgrade 命令及菜单中使用的边境层级。 若未安装 Vault(或设置了 economy.enabled: false),所有功能仍可正常使用,但均为免费。

世界管理

空维度会在保存后经过 world-management.unload-delay-seconds 秒卸载;在其中登出的玩家重新加入时会被传送回主世界。entity-cap 会向超出限制的维度所有者发出警告(0 = 关闭)。 在 26.1+ 版本中,服务器将每个维度存储在 <main world>/dimensions/minecraft/... 下;该插件会识别、加载、删除并重置这种布局以及旧的 <server>/pocketdimensionworlds/... 布局,包括那些将文件夹扁平化为 pocketdimension-<uuid> 的主机。

生物传送

使用你的关键物品(或生物传送器工具)右键点击一个生物,即可将其存储到你的维度中或将其取回。站在其他玩家维度中的生物只能由该维度的所有者移动。

  • pocketdimensions.mobteleport.use — 允许使用此功能。
  • pocketdimensions.mobteleport.store — 将生物存入。
  • pocketdimensions.mobteleport.retrieve — 将生物取出。

默认游戏规则

默认值保存在 config.yml(default-gamerules:)中;规则名称在运行时通过遗留兼容方式解析,因此无论服务器版本是 26.x 还是 pre-1.21.11,两种拼写均可正常工作。使用 /pdgamerule 设置的维度级覆盖配置会被存储,并优先于默认值生效。


权限参考

权限 控制内容 默认值
pocketdimensions.receive.key 首次加入时获取钥匙物品 (key-item.give-on-first-join) true
pocketdimensions.feedback 进出标题、音效及进入通知 true
pocketdimensions.bypass.protection 忽略所有维度保护 op
pocketdimensions.commands.givepd /givepd op
pocketdimensions.commands.givepd.tool 给予 mobtool 物品 op
pocketdimensions.commands.pdtp /pdtp 管理员传送 op
pocketdimensions.commands.players.pd 基础 /pd 命令 op
pocketdimensions.commands.player.pd.invite /pd invite, /pd acceptinv op
pocketdimensions.commands.player.pd.kick /pd kick op
pocketdimensions.commands.player.pd.kick.bypass 无法被踢出 op
pocketdimensions.commands.player.pd.trust /pd trust, /pd untrust op
pocketdimensions.commands.player.pd.trust.trusted 授予完整的 trusted 等级 op
pocketdimensions.commands.player.pd.setspawn /pd setspawn op
pocketdimensions.commands.player.pd.upgrade /pd upgrade + 菜单边框物品 op
pocketdimensions.commands.player.pd.settings /pd settings + 菜单设置项 op
pocketdimensions.commands.player.pd.menu 打开 /pd menu op
pocketdimensions.commands.player.pd.menu.teleport 菜单旅行物品 op
pocketdimensions.commands.player.pd.menu.trust 菜单信任部分 op
pocketdimensions.commands.player.pd.menu.settings 菜单预设/环境/通知物品 op
pocketdimensions.commands.player.pd.menu.border 菜单边框物品 op
pocketdimensions.commands.player.pdleave /pdleave op
pocketdimensions.commands.pdgamerule /pdgamerule(按维度持久化) op
pocketdimensions.commands.pdworldborder /pdworldborder op
pocketdimensions.commands.reload /pdreload op
pocketdimensions.commands.admin.list /pdlist op
pocketdimensions.commands.admin.delete /pdadmin delete op
pocketdimensions.commands.admin.reset /pdadmin reset op
pocketdimensions.commands.admin.cleanup /pdadmin cleanup op
pocketdimensions.mobteleport.use 使用生物传送 op
pocketdimensions.mobteleport.store 将生物放入你的维度 op
pocketdimensions.mobteleport.retrieve 从你的维度取出生物 op

推荐玩家权限等级(普通玩家):

- pocketdimensions.commands.players.pd
- pocketdimensions.commands.player.pd.invite
- pocketdimensions.commands.player.pd.kick
- pocketdimensions.commands.player.pd.trust
- pocketdimensions.commands.player.pd.setspawn
- pocketdimensions.commands.player.pd.upgrade
- pocketdimensions.commands.player.pd.settings
- pocketdimensions.commands.player.pd.menu
- pocketdimensions.commands.player.pdleave
- pocketdimensions.mobteleport.use
- pocketdimensions.mobteleport.store
- pocketdimensions.mobteleport.retrieve

受信任/协作权限等级(共享维度所有者):上述所有权限 加上 pocketdimensions.commands.player.pd.trust.trusted。 若要禁用某位玩家的特定功能,请否定其对应节点(例如在 LuckPerms 中使用 -pocketdimensions.commands.player.pd.upgrade);若要在全局范围内禁用,请将对应的 features.* 开关设置为 false。

配置参考

键 类型 / 默认值 效果
default-world-border-size int / 10000 玩家没有自定义大小时的世界边界(直径)。
features.trust-protection bool / true 信任系统和保护监听器的全局开关。
features.dimension-presets bool / true 允许玩家选择预设/环境。
features.setspawn bool / true 允许使用 /pd setspawn。
features.gui-menu bool / true 允许使用 /pd menu。
features.feedback bool / true 标题、声音和进入通知。
features.placeholderapi bool / true 当安装 PlaceholderAPI 时注册占位符。
features.admin-tools bool / true 管理员命令的预留开关(受权限限制)。
storage.type JSON/SQLITE/MYSQL 活动后端;切换时会自动导入 JSON 数据。
storage.sqlite.file string / database.db 插件文件夹内的 SQLite 文件。
storage.mysql.host/port/database/username/password/use-ssl/table-prefix — MySQL 连接信息和表前缀。
dimension.default-preset FLAT/VOID/NORMAL 新维度的生成方式。VOID = 带有小型平台的空世界;NORMAL = 带有随机种子地形的世界。
dimension.default-environment NORMAL/NETHER/THE_END 新维度的环境。
protection.protect-mobs bool / true 访客无法伤害房主的生物。存储实体(箱子矿车/船、盔甲架)即使在此项关闭时也保持保护状态。
protection.block-explosions bool / true 爆炸在维度内不会对方块或实体造成伤害。
protection.block-fire bool / true 访客无法点火,且火焰不会消耗维度内的方块。
protection.extra-containers list / [] 被视为锁定容器的额外材料。
economy.enabled bool / false Vault 收费的主开关。
economy.creation-cost number / 0.0 首次创建维度时的费用。
economy.upgrades list of {size, cost} /pd upgrade 的边界层级(经济功能关闭时为免费)。
feedback.titles bool / true 进出标题。
feedback.sounds bool / true 进出声音。
feedback.sound-enter / feedback.sound-leave sound name 进出时播放的声音。
key-item.material/name/lore — 钥匙物品的外观。%player% 会被替换。
key-item.custom-model-data int / 0 资源包模型(0 = 关闭)。
key-item.glow bool / false 附魔光效。
key-item.give-on-first-join bool / false 每位玩家首次加入时自动发放一次(需要 pocketdimensions.receive.key 权限)。
key-item.interact-cooldown-ms int / 1000 防止双击物品的冷却时间(毫秒)。
key-item.craftable + recipe.shape + recipe.ingredients — 可选的合成配方;合成的钥匙会与合成者绑定。
tools.mob-teleporter.* — 生物工具:required、材质、名称、描述、custom-model-data、glow。
mob-teleport.enabled/mode/entities/exclude.categories/allow-named-mobs — 生物传送规则。
default-gamerules.<rule> bool/int 应用于每个维度的游戏规则;每个维度的 /pdgamerule 覆盖优先级更高。支持 CamelCase 和 snake_case 命名,并在运行时按名称解析。
world-management.auto-unload bool / true 卸载空维度。
world-management.unload-delay-seconds int / 300 空维度卸载前的宽限期(秒)。
world-management.sweep-interval-seconds int / 300 扫描频率(最小 30 秒)。
world-management.entity-cap int / 0 实体数量超过此值时警告所有者(0 = 关闭)。

PlaceholderAPI

%pd_in_pd%, %pd_border%, %pd_visitors%, %pd_dimension_loaded%.

开发者 API

其他插件可监听的 Bukkit 可取消事件:PocketDimensionCreateEvent、PlayerEnterDimensionEvent、PlayerLeaveDimensionEvent、InviteSendEvent、MobTeleportEvent(包路径 mc.lethargos.pocketdimensions.api.event)。

本次版本: 0.0.8-ALPHA | Minecraft 1.19.4 - 26.3 | Java 17+(26.x 服务器需要 Java 25)。


注意: 这是我的早期插件之一,目前仍在积极开发中。肯定存在 Bug。请在我的 Discord 上报告它们 - 或者将它们添加到 。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源