PortalLock — 控制下界与末地传送门的 Paper 插件
掌控玩家进入下界和末地的时机。 PortalLock 是一款服务端 Minecraft Paper 插件,用于锁定传送门、安排维度开启与关闭时间,以及管理生存多人游戏(SMP)进度,无需客户端模组。
在全新生存服务器启动期间保持下界封闭。为社区龙战开启末地。在活动结束后关闭某个维度,将玩家送回主世界,并让所有人通过 /portal 命令查看下一次开启时间。
专为阶段性生存进度设计
| 功能 |
对服务器的帮助 |
| 独立的下界与末地锁定 |
分别控制每个维度的状态。 |
| 定时开启 与 关闭 |
为新服启动、赛季或活动设置一次性访问窗口。 |
公开的 /portal 命令 |
玩家无需管理员权限即可查看维度状态和开启倒计时。 |
| 安全返回主世界 |
尽可能在玩家保存的入口点附近将其送回主世界,并提供安全的位置回退机制。 |
| 离线玩家检查 |
登录时仍处于关闭状态的离线玩家也会被处理。 |
| Discord Webhook 公告 |
当维度开启时通知你的社区;可选择性地发布关闭公告。 |
| 四种即用语言 |
英语、俄语、乌克兰语和德语。 |
| PlaceholderAPI 计时器 |
在兼容的 TAB、记分板和公告插件中显示开启倒计时和状态。 |
| 可自定义展示效果 |
支持 MiniMessage 文本、动作栏、标题、音效、粒子效果和开启特效。 |
PortalLock 是 SMP、生存、极限模式和季节性 Paper 服务器 的理想选择,适合那些希望实现维度进度解锁,而非允许第一天就无限制使用传送门的服务器。
快速开始
需要 Paper 26.2 或 Paper 26.3 以及 Java 25。 请使用与你的服务器版本匹配的 JAR 文件。仅安装一个 PortalLock JAR,删除旧版本副本,然后重启服务器以生成配置文件。玩家不需要任何模组、资源包或特殊的客户端。
核心传送门控制和 Discord Webhook 无需依赖其他插件。仅在需要使用外部 %portallock_*% 占位符时安装 PlaceholderAPI 2.12.3+。
全新安装后,两个维度默认均处于关闭状态,直到你配置时间表或手动开启它们:
/portallock open nether
/portallock open end
安排下界开启或末地活动时间
在 config.yml 中设置开启和关闭日期。例如,给下界设置一个四小时的活动窗口:
settings:
time-zone: "Europe/Budapest"
dimensions:
nether:
enabled: true
unlock-at: "2027-01-01 18:00:00"
close-at: "2027-01-01 22:00:00"
将示例日期替换为你自己的日期。重载配置,如果之前使用过命令,请应用配置的时间表:
/portallock reload
/portallock schedule nether
时间表使用 一次性时间戳,而不是重复执行的每日或每周任务。命令计时器会保存为具体日期,因此服务器重启不会重置它们,且离线时间会计入倒计时。命令覆盖优先级高于配置文件中的日期,直到你恢复配置文件中的时间表。
喜欢简单的计时器?让下界关闭七天,或者立即开启末地并在两小时后关闭它:
/portallock settime nether 7d
/portallock open end
/portallock setclosetime end 2h
关闭维度而不落下玩家
当某个维度关闭时,PortalLock 会在每个玩家保存的入口点附近寻找一个安全的主世界位置。如果该点不可用,它会尝试保存的主世界/重生点和安全的世界出生点。它避免将玩家直接放置在原始传送门内部。
返回点在玩家数据中持久保存。登录、重生、传送和世界变更检查也涵盖在维度关闭时处于离线状态的玩家。如果玩家没有记录的入口点,则使用安全回退位置。
默认情况下,所有玩家(包括管理员)都会被送回;可以通过 evacuation.respect-bypass: true 尊重有效的员工豁免权限。如果没有可用的安全主世界位置,或者另一个插件阻止了返回传送,受影响的玩家将被断开连接并显示本地化消息。
让玩家查看传送门状态
/portal
/portal nether
/portal end
公开命令显示状态和时间信息,无需管理员权限。
它不会赋予玩家开启、关闭或重载插件的权限。
| 管理员命令 |
用途 |
/portallock open <nether|end> |
立即开启某个维度。 |
/portallock close <nether|end> |
无限期关闭并送还受影响玩家。 |
/portallock settime <nether|end> <time> |
立即关闭并在持续时间后开启。 |
/portallock setclosetime <nether|end> <time> |
计划关闭时间。 |
/portallock schedule <nether|end> |
从配置中恢复日期。 |
/portallock status |
显示管理员状态。 |
/portallock reload |
重载配置、消息和语言。 |
持续时间包括 7d(7天)、12h(12小时)、45m(45分钟)和 30s(30秒)。/plock 是管理员命令别名。
权限按命令分离,portallock.admin 作为管理员总括权限。
维度豁免权限是分开的,默认禁用。
将传送门计时器添加到 TAB 或记分板
安装 PlaceholderAPI 后,PortalLock 会自动注册其扩展。无需单独下载 eCloud 扩展。在支持 PAPI 的显示插件中使用以下占位符:
Nether: %portallock_nether_status%
Opens in: %portallock_nether_remaining%
End: %portallock_end_status%
Opens in: %portallock_end_remaining%
其他占位符包括 %portallock_nether_timer%、%portallock_nether_seconds%、
%portallock_nether_unlock_at% 和 %portallock_nether_close_remaining%,并配有相应的 end 版本。
数字形式的开启秒数对于已开启的维度返回 0,对于未计划开启的关闭维度返回 -1。
格式化计时器使用所选语言。
在 Discord 中宣布传送门开启
配置一个传入的 Discord 频道 webhook,并在配置文件中启用它:
discord:
enabled: true
webhook-url: "PASTE_YOUR_DISCORD_WEBHOOK_URL_HERE"
announce-openings: true
announce-closures: false
无需使用 Discord 机器人。公告将使用你选择的语言以及可自定义的消息文本。请求通过有界队列异步执行,并包含重试和超时机制,而不是阻塞服务器主线程(tick thread)。请妥善保管你的 webhook URL。
选择你的语言和服务器风格
settings:
language: ru
选择 en、ru、uk 或 de,然后运行 /portallock reload。语言设置适用于整个服务器。你可以编辑 locales/*.yml 文件,或在 messages.yml 中添加自定义覆盖内容。
MiniMessage 格式支持为动作栏计时器、聊天消息和开启公告提供一致的视觉效果。你还可以配置开启标题、音效、粒子效果、烟花以及控制台命令。
兼容性与适用范围
PortalLock 针对 Paper 平台上的原版下界和末地访问权限进行优化。它不是自定义维度管理器、传送门网络替代方案或 Folia 插件。不支持 Spigot、Fabric、Forge 以及自定义传送门系统。自动冒烟测试基于固定的 Paper 26.2 和 26.3 构建版本;事件测试使用代理玩家,而非实际连接的游戏客户端。
PortalLock — Nether & End Portal Control for Paper
Control when your players enter the Nether and the End. PortalLock is a server-side Minecraft
Paper plugin for locking portals, scheduling dimension opening and closing, and managing SMP
progression without client mods.
Keep the Nether closed during a fresh survival launch. Open the End for a community dragon fight.
Close a dimension after an event, return players to the Overworld, and let everyone check the next
opening with /portal.
Built for staged survival progression
| Feature |
How it helps your server |
| Independent Nether and End locks |
Control each dimension separately. |
| Scheduled opening and closing |
Set one-time access windows for launches, seasons and events. |
Public /portal command |
Players see dimension status and opening timers without admin permissions. |
| Safe Overworld returns |
Return players near their saved entry point when possible, with safe fallback locations. |
| Offline-player checks |
Players logging in after closure are checked too. |
| Discord webhook announcements |
Notify your community when dimensions open; optionally announce closure. |
| Four ready-to-use languages |
English, Russian, Ukrainian and German. |
| PlaceholderAPI timers |
Show opening countdowns and status in compatible TAB, scoreboard and announcement plugins. |
| Customizable presentation |
MiniMessage text, action bars, titles, sounds, particles and opening effects. |
PortalLock is a focused option for SMP, survival, hardcore and seasonal Paper servers that want
dimension progression instead of unrestricted day-one portal access.
Get started
Requires Paper 26.2 or Paper 26.3 and Java 25. Use the JAR matching your server version.
Install only one PortalLock JAR, remove older copies, and restart the server to generate the configuration.
Players do not need a mod, resource pack or special client.
Core portal controls and Discord webhooks have no required plugin dependency. Install
PlaceholderAPI 2.12.3+ only if you want external %portallock_*% placeholders.
On a fresh installation both dimensions start closed until you configure a schedule or open them:
/portallock open nether
/portallock open end
Schedule your Nether opening or End event
Set opening and closing dates in config.yml. For example, give the Nether a four-hour event window:
settings:
time-zone: "Europe/Budapest"
dimensions:
nether:
enabled: true
unlock-at: "2027-01-01 18:00:00"
close-at: "2027-01-01 22:00:00"
Replace the example dates with your own. Reload, then apply the configured schedule if commands
were used previously:
/portallock reload
/portallock schedule nether
Schedules use one-shot timestamps, not recurring daily or weekly jobs. Command timers are saved
as real dates, so server restarts do not reset them and offline time counts toward the countdown.
Command overrides take priority over configuration dates until you restore the config schedule.
Prefer simple timers? Close the Nether for seven days, or open the End now and close it in two hours:
/portallock settime nether 7d
/portallock open end
/portallock setclosetime end 2h
Close dimensions without leaving players behind
When a dimension closes, PortalLock looks for a safe Overworld position near each player's saved
entry point. If that point is unavailable, it tries saved Overworld/respawn locations and safe world
spawns. It avoids placing a player directly inside the original portal.
Return points persist in player data. Login, respawn, teleport and world-change checks also cover
players who were offline when a dimension closed. If a player has no recorded entry, a safe fallback
is used instead.
By default everyone is returned, including operators; valid staff bypasses can be respected with
evacuation.respect-bypass: true. If no safe Overworld point is available, or another plugin prevents
the return teleport, the affected player is disconnected with a localized message.
Let players check portal status
/portal
/portal nether
/portal end
The public command shows status and timing information without administrator permissions.
It does not give players access to opening, closing or reloading the plugin.
| Admin command |
Purpose |
/portallock open <nether|end> |
Open a dimension now. |
/portallock close <nether|end> |
Close indefinitely and return affected players. |
/portallock settime <nether|end> <time> |
Close now and open after a duration. |
/portallock setclosetime <nether|end> <time> |
Schedule closure. |
/portallock schedule <nether|end> |
Restore dates from the configuration. |
/portallock status |
Show administrative status. |
/portallock reload |
Reload configuration, messages and language. |
Durations include 7d, 12h, 45m and 30s. /plock is an administrative command alias.
Permissions are separated by command, with portallock.admin as the administrative umbrella.
Dimension bypasses are separate and disabled by default.
Add portal timers to TAB or your scoreboard
With PlaceholderAPI installed, PortalLock registers its expansion automatically. No separate
eCloud expansion download is needed. Use these placeholders in a display plugin that supports PAPI:
Nether: %portallock_nether_status%
Opens in: %portallock_nether_remaining%
End: %portallock_end_status%
Opens in: %portallock_end_remaining%
Additional placeholders include %portallock_nether_timer%, %portallock_nether_seconds%,
%portallock_nether_unlock_at% and %portallock_nether_close_remaining%, with matching end versions.
Numeric opening seconds return 0 for an open dimension and -1 for a closed dimension without
a scheduled opening. Formatted timers use the selected language.
Announce portal openings in Discord
Create an incoming Discord channel webhook and enable it in the configuration:
discord:
enabled: true
webhook-url: "PASTE_YOUR_DISCORD_WEBHOOK_URL_HERE"
announce-openings: true
announce-closures: false
No Discord bot is required. Announcements use your selected language and customizable message text.
Requests run asynchronously with a bounded queue, retries and timeouts, rather than blocking the
server tick thread. Keep your webhook URL private.
Choose your language and server style
settings:
language: ru
Choose en, ru, uk or de, then run /portallock reload. The language setting
applies server-wide. Edit locales/*.yml or add custom overrides in messages.yml.
MiniMessage formatting supports a consistent look for action-bar timers, chat messages and opening
announcements. You can also configure opening titles, sounds, particles, fireworks and console commands.
Compatibility and scope
PortalLock targets vanilla Nether and End access on Paper. It is not a custom-dimension manager,
portal-network replacement or Folia plugin. Spigot, Fabric, Forge and custom portal systems are not
supported. Automatic smoke tests cover pinned Paper 26.2 and 26.3 builds; event tests use proxy players,
not connected game clients.
评论 0
登录后参与评分
还没有评论,来抢沙发吧