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)—— 默认禁用
- 安装 Vault 以及任意经济类插件(如 EssentialsX、CMI…)。
- 在
config.yml 中设置 economy.enabled: true 并配置价格。
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 上报告它们 - 或者将它们添加到 。
Pocket Dimensions 0.0.8-ALPHA
Pocket Dimensions lets every player own a personal world, invite friends, set trust levels, teleport mobs, and customize generation. One jar supports Minecraft 1.19.4 → 26.3 (Bukkit, Spigot, Paper, Purpur).
Compatibility
| Server version |
Java |
Notes |
| 1.19.4 – 1.21.11 |
17+ |
Legacy Bukkit world folders; camelCase gamerules. |
| 26.1 – 26.2 |
25 |
World data moves under <world>/dimensions/minecraft/...; plugin resolves both layouts automatically. |
| 26.3 |
25 |
Gamerule names are snake_case (keep_inventory, spawn_mobs); the plugin accepts camelCase config values and converts them. 26.3 shelves/cushions and the post-26.1 world layout are protected/supported. |
The jar is compiled against the 1.19.4 API with Java 17 bytecode, so it runs on Java 17 servers and on Java 25 servers running 26.x. Existing configs are upgraded in place on startup: missing keys (including new protection toggles) are added without touching user values; messages.yml keeps custom text and falls back to the bundled defaults for new keys.
Commands
| Command |
Usage |
Permission |
Description |
| /givepd |
/givepd <player> [dimension|mobtool] |
pocketdimensions.commands.givepd |
Gives the PD item bound to <player> (the item only works for them). mobtool requires pocketdimensions.commands.givepd.tool. |
| /pdtp |
/pdtp <player> |
pocketdimensions.commands.pdtp |
Admin teleport into any player's dimension (offline supported). |
| /pd |
/pd <action> [args] |
pocketdimensions.commands.players.pd |
Base command; every action below has its own permission. |
|
/pd invite <player> |
pocketdimensions.commands.player.pd.invite |
Invite a player to the dimension you are standing in (expires in 120s). Works in someone else's dimension only if you are trusted there. |
|
/pd acceptinv [player] |
pocketdimensions.commands.player.pd.invite |
Accept a pending invite; with several invites, pick the sender. |
|
/pd kick <player> |
pocketdimensions.commands.player.pd.kick |
Kick a player from your dimension. |
|
/pd trust <player> [builder|trusted] |
pocketdimensions.commands.player.pd.trust |
Grant trust in your dimension. Default tier: builder. trusted also needs ...pd.trust.trusted. |
|
/pd untrust <player> |
pocketdimensions.commands.player.pd.trust |
Revoke trust. |
|
/pd setspawn |
pocketdimensions.commands.player.pd.setspawn |
Set your dimension's spawn point to where you stand. |
|
/pd upgrade |
pocketdimensions.commands.player.pd.upgrade |
Upgrade your border to the next configured tier (charges money when the economy is enabled). |
|
/pd settings [preset|environment|notify] [value] |
pocketdimensions.commands.player.pd.settings |
View/change your dimension preset, environment and entry notifications. Applies when your dimension is next created. |
|
/pd menu |
pocketdimensions.commands.player.pd.menu |
Open the GUI menu. |
| /pdleave |
/pdleave |
pocketdimensions.commands.player.pdleave |
Leave the current pocket dimension. |
| /pdgamerule |
/pdgamerule <player> <rule> [value] |
pocketdimensions.commands.pdgamerule |
View or set a gamerule in a player's dimension — persisted per dimension and re-applied on every entry. |
| /pdworldborder |
/pdworldborder <player> <size> |
pocketdimensions.commands.pdworldborder |
Set a player's border size directly. |
| /pdreload |
/pdreload |
pocketdimensions.commands.reload |
Reload config, messages, mob-teleport settings, protection extras and the economy hook. Storage type changes need a restart. |
| /pdlist |
/pdlist |
pocketdimensions.commands.admin.list |
List all dimensions: owner, loaded state, border, last seen. |
| /pdadmin |
see below |
pocketdimensions.commands.admin.* |
/pdadmin delete <player> confirm (world and all data), /pdadmin reset <player> confirm (world only, data kept), /pdadmin cleanup <days> confirm (remove dimensions of players inactive for N days). Refuses while players are inside. |
GUI — /pd menu
A two-view inventory. Sections are individually permission-gated:
- Travel (
...pd.menu.teleport) — enter or leave your dimension.
- Trusted players (
...pd.menu.trust) — one skull per trusted player; left-click cycles their tier (builder ↔ trusted), right-click removes. Adding new players: /pd trust <player>.
- Preset / Environment / Notifications (
...pd.menu.settings) — cycle FLAT → VOID → NORMAL and NORMAL → NETHER → THE_END (applies on next creation) and toggle entry notifications.
- World border (
...pd.menu.border) — shows the current and next tier size; click to upgrade.
Trust & protection
Dimension owners grant trust tiers. Everyone else (even past invitees) is a visitor:
- Visitor — can look around, use doors/buttons, but cannot build, break, open containers or hurt the owner's mobs.
- Builder — can build, break and use containers.
- Trusted — builder rights plus can invite other players into the dimension.
Admins (and anyone with
pocketdimensions.bypass.protection) bypass all of it. Explosions never damage blocks inside dimensions (configurable).
Dimension settings & presets
New dimensions are generated from dimension.default-preset (FLAT / VOID / NORMAL) and dimension.default-environment (NORMAL / NETHER / THE_END). Players can pick their own for their next creation via /pd settings or the menu. Existing worlds are never regenerated. /pd setspawn moves the in-dimension spawn; invited players and first entries arrive there.
Storage
Pick the backend in config.yml (storage.type):
- JSON (default) —
lastlocs.json, pdborders.json, dimensions.json in the plugin folder; atomic, serialized writes. The first two are the same files 0.0.5 used.
- SQLITE / MYSQL — bundled JDBC drivers, nothing to install. Switching auto-imports existing JSON data once and renames the old files
*.imported. Tables created on first boot: pd_locations, pd_borders, pd_meta, pd_trusts, pd_settings.
Economy (Vault) — disabled by default
- Install Vault and any economy plugin (EssentialsX, CMI…).
- Set
economy.enabled: true in config.yml and set prices.
economy.creation-cost is charged the first time a player's world is created; economy.upgrades are the border tiers used by /pd upgrade and the menu.
Without Vault (or with economy.enabled: false) everything works but is free.
World Management
Empty dimensions unload (after saving) after world-management.unload-delay-seconds; players who log out inside are returned on rejoin. entity-cap warns owners whose dimension exceeds the limit (0 = off).
On 26.1+ the server stores each dimension under <main world>/dimensions/minecraft/...; the plugin discovers, loads, deletes and resets both that layout and the older <server>/pocketdimensionworlds/... layout, including hosts that flatten the folder to pocketdimension-<uuid>.
Mob Teleportation
Right-click a mob with your key item (or the mob teleporter tool) to store it in your dimension or retrieve it back. Mobs standing in another player's dimension can only be moved by that dimension's owner.
pocketdimensions.mobteleport.use — use the feature at all.
pocketdimensions.mobteleport.store — send mobs in.
pocketdimensions.mobteleport.retrieve — take mobs out.
Default Game Rules
Defaults live in config.yml (default-gamerules:); rule names are resolved at runtime with legacy fallbacks, so both 26.x and pre-1.21.11 spellings work on any server. Per-dimension overrides made with /pdgamerule are stored and win over the defaults.
Permission Reference
| Permission |
What it controls |
Default |
pocketdimensions.receive.key |
Getting the key item on first join (key-item.give-on-first-join) |
true |
pocketdimensions.feedback |
Entry/exit titles, sounds and entry notifications |
true |
pocketdimensions.bypass.protection |
Ignores all dimension protection |
op |
pocketdimensions.commands.givepd |
/givepd |
op |
pocketdimensions.commands.givepd.tool |
Giving the mobtool item |
op |
pocketdimensions.commands.pdtp |
/pdtp admin teleport |
op |
pocketdimensions.commands.players.pd |
Base /pd command |
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 |
Cannot be kicked |
op |
pocketdimensions.commands.player.pd.trust |
/pd trust, /pd untrust |
op |
pocketdimensions.commands.player.pd.trust.trusted |
Granting the full trusted tier |
op |
pocketdimensions.commands.player.pd.setspawn |
/pd setspawn |
op |
pocketdimensions.commands.player.pd.upgrade |
/pd upgrade + menu border item |
op |
pocketdimensions.commands.player.pd.settings |
/pd settings + menu setting items |
op |
pocketdimensions.commands.player.pd.menu |
Opening /pd menu |
op |
pocketdimensions.commands.player.pd.menu.teleport |
Menu travel item |
op |
pocketdimensions.commands.player.pd.menu.trust |
Menu trust section |
op |
pocketdimensions.commands.player.pd.menu.settings |
Menu preset/environment/notification items |
op |
pocketdimensions.commands.player.pd.menu.border |
Menu border item |
op |
pocketdimensions.commands.player.pdleave |
/pdleave |
op |
pocketdimensions.commands.pdgamerule |
/pdgamerule (persists per dimension) |
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 |
Use mob teleportation |
op |
pocketdimensions.mobteleport.store |
Send mobs into your dimension |
op |
pocketdimensions.mobteleport.retrieve |
Take mobs out of your dimension |
op |
Recommended player rank (regular players):
- 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
Trusted/co-op rank (owners of shared dimensions): everything above plus pocketdimensions.commands.player.pd.trust.trusted.
To disable a feature for one player, negate their node (e.g. -pocketdimensions.commands.player.pd.upgrade in LuckPerms); to disable globally, set the matching features.* switch to false.
Config Reference
| Key |
Type / Default |
Effect |
default-world-border-size |
int / 10000 |
Border (diameter) when a player has no custom size. |
features.trust-protection |
bool / true |
Global switch for the trust system and protection listener. |
features.dimension-presets |
bool / true |
Allows players to choose preset/environment. |
features.setspawn |
bool / true |
Allows /pd setspawn. |
features.gui-menu |
bool / true |
Allows /pd menu. |
features.feedback |
bool / true |
Titles, sounds and entry notifications. |
features.placeholderapi |
bool / true |
Registers placeholders when PlaceholderAPI is installed. |
features.admin-tools |
bool / true |
Reserved switch for the admin commands (they are permission-gated). |
storage.type |
JSON/SQLITE/MYSQL |
Active backend; switching auto-imports JSON data. |
storage.sqlite.file |
string / database.db |
SQLite file inside the plugin folder. |
storage.mysql.host/port/database/username/password/use-ssl/table-prefix |
— |
MySQL connection and table prefix. |
dimension.default-preset |
FLAT/VOID/NORMAL |
Generation for new dimensions. VOID = empty world with a small platform; NORMAL = terrain with a random seed. |
dimension.default-environment |
NORMAL/NETHER/THE_END |
Environment for new dimensions. |
protection.protect-mobs |
bool / true |
Visitors cannot hurt the owner's mobs. Storage entities (chest carts/boats, armor stands) stay protected even when this is off. |
protection.block-explosions |
bool / true |
Explosions deal no block or entity damage inside dimensions. |
protection.block-fire |
bool / true |
Visitors cannot start fire, and fire cannot consume blocks inside dimensions. |
protection.extra-containers |
list / [] |
Extra materials treated as locked containers. |
economy.enabled |
bool / false |
Master switch for Vault charges. |
economy.creation-cost |
number / 0.0 |
Charged on first dimension creation. |
economy.upgrades |
list of {size, cost} |
Border tiers for /pd upgrade (free when economy is off). |
feedback.titles |
bool / true |
Entry/exit titles. |
feedback.sounds |
bool / true |
Entry/exit sounds. |
feedback.sound-enter / feedback.sound-leave |
sound name |
Played on entry/exit. |
key-item.material/name/lore |
— |
The key item's look. %player% is replaced. |
key-item.custom-model-data |
int / 0 |
Resource-pack model (0 = off). |
key-item.glow |
bool / false |
Enchant glint. |
key-item.give-on-first-join |
bool / false |
Auto-give once per player (needs pocketdimensions.receive.key). |
key-item.interact-cooldown-ms |
int / 1000 |
Anti-double-click cooldown for the item. |
key-item.craftable + recipe.shape + recipe.ingredients |
— |
Optional crafting recipe; the crafted key binds to the crafter. |
tools.mob-teleporter.* |
— |
Mob tool: required, material, name, lore, custom-model-data, glow. |
mob-teleport.enabled/mode/entities/exclude.categories/allow-named-mobs |
— |
Mob teleport rules. |
default-gamerules.<rule> |
bool/int |
Rules applied to every dimension; per-dimension /pdgamerule overrides win. CamelCase and snake_case names are both accepted and resolved by name at runtime. |
world-management.auto-unload |
bool / true |
Unload empty dimensions. |
world-management.unload-delay-seconds |
int / 300 |
Grace period before an empty dimension unloads. |
world-management.sweep-interval-seconds |
int / 300 |
Sweep frequency (min 30). |
world-management.entity-cap |
int / 0 |
Warn owners above this entity count (0 = off). |
PlaceholderAPI
%pd_in_pd%, %pd_border%, %pd_visitors%, %pd_dimension_loaded%.
Developer API
Cancellable Bukkit events other plugins can listen to: PocketDimensionCreateEvent, PlayerEnterDimensionEvent, PlayerLeaveDimensionEvent, InviteSendEvent, MobTeleportEvent (package mc.lethargos.pocketdimensions.api.event).
This release: 0.0.8-ALPHA | Minecraft 1.19.4 - 26.3 | Java 17+ (26.x servers need Java 25).
NOTE: This is one of my first plugins and it is still under heavy development. There are definitely bugs. Please report them on my discord - or add them to
评论 0
登录后参与评分
还没有评论,来抢沙发吧