PortalLock

插件

· 作者 Antehor

使用计时器、命令和 MiniMessage 支持来控制下界与末地的进度。

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

最新 1.1.0 · 26.3 · Paper

一键开服(送7天)

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 构建版本;事件测试使用代理玩家,而非实际连接的游戏客户端。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源