WorldTimer
一个适用于 Paper 1.20.1 的插件,可为特定世界(例如资源世界)强制执行可配置的时间限制,并通过 LuckPerms 实现基于权限组的覆盖。
功能特性
- 按世界设置时间限制 — 配置玩家在每个世界中可以停留的时长
- 基于权限组的重写机制 — 通过 LuckPerms 权限,不同权限组拥有不同的时间限制和冷却时间
- 冷却系统 — 玩家时间用尽后,必须等待一段时间才能重新进入该世界
- 警告消息 — 在特定的时间阈值时发送可配置的警告
- 过期动作 — 当玩家时间耗尽时执行命令(例如标题、效果等)
- 返回传送 — 玩家将传送回进入前的确切位置
- 持久化存储 — SQLite 数据库可在服务器重启和崩溃后保留数据
- 豁免权限 — 工作人员可按世界豁免所有限制
依赖要求
- Paper 1.20.1+(或兼容分支)
- Java 17+
可选依赖
- LuckPerms — 用于基于权限的时间限制和冷却。如果没有安装它,所有玩家将使用配置文件中的默认值。
- Multiverse-Core — 与 Multiverse 管理的世界无缝配合
安装步骤
- 从发布页面下载最新的
world-timer-x.x.jar
- 将其放入服务器的
plugins/ 文件夹中
- 重启服务器
- 编辑
plugins/WorldTimer/config.yml 以配置你的世界
- 运行
/worldtimer reload 重载配置
配置说明
# 插件检查计时器的频率(秒)
tick-seconds: 1
storage:
type: sqlite
messages:
prefix: "&8[&bWorldTimer&8] &r"
warn: "&e你在 &6%world% &e中剩余时间为 &6%time_remaining% &e。"
expired: "&c你在 &6%world% &c中的时间已耗尽。"
cooldown: "&c你必须等待 &6%cooldown_remaining% &c后才能重新进入 &6%world%&c。"
worlds:
resource: # 世界名称(不区分大小写)
enabled: true
main-world: "survival" # 备用传送世界
teleport-location: "spawn" # 当前使用返回点或出生点
default-limit-seconds: 1800 # 30分钟(若无权限则使用此值)
default-cooldown-seconds: 600 # 10分钟(若无权限则使用此值)
limit-permission-prefix: "worldtimer.limit.resource."
cooldown-permission-prefix: "worldtimer.cooldown.resource."
bypass-permission: "worldtimer.bypass.resource"
warn-at-seconds: [600, 300, 60, 10] # 剩余 10m、5m、1m、10s 时发出警告
expire-commands:
- "title %player% title {\"text\":\"Time is up!\",\"color\":\"red\"}"
权限说明
时间限制权限
格式:worldtimer.limit.<world>.<duration>
| 权限 |
效果 |
worldtimer.limit.resource.30m |
30 分钟限制 |
worldtimer.limit.resource.1h |
1 小时限制 |
worldtimer.limit.resource.2h |
2 小时限制 |
worldtimer.limit.resource.unlimited |
无时间限制 |
时长格式: 30s、30m、2h、1d、unlimited
如果玩家拥有多个时间限制权限,将使用最高的值。
冷却时间权限
格式:worldtimer.cooldown.<world>.<duration>
| 权限 |
效果 |
worldtimer.cooldown.resource.5m |
5 分钟冷却 |
worldtimer.cooldown.resource.10m |
10 分钟冷却 |
worldtimer.cooldown.resource.0s |
无冷却 |
如果玩家拥有多个冷却时间权限,将使用最高的值。
其他权限
| 权限 |
描述 |
worldtimer.bypass.<world> |
豁免某世界的所有限制 |
worldtimer.admin |
完全访问所有命令 |
worldtimer.reload |
访问 /worldtimer reload |
worldtimer.manage |
访问 reset/addtime/setcooldown 命令 |
worldtimer.status |
访问 /worldtimer status |
命令列表
| 命令 |
描述 |
/worldtimer reload |
重载配置 |
/worldtimer status [player] |
查看自己或其他玩家的计时器状态 |
/worldtimer reset <player> <world> |
重置玩家的时间限制和冷却时间 |
/worldtimer addtime <player> <world> <time> |
为玩家增加可用时间 |
/worldtimer setcooldown <player> <world> <time> |
设置或清除玩家的冷却时间 |
别名: /wt
工作原理
进入流程
- 玩家传送至已配置的世界
- 插件检查是否有豁免权限 → 如果有,允许自由进入
- 插件检查是否存在活跃冷却 → 如果存在,阻止进入并显示消息
- 插件保存玩家当前位置作为返回点
- 插件解析权限组确定的时间限制(或使用默认值)
- 开始计时追踪
在世界内期间
- 计时器每个 tick 间隔递增
- 在配置的阈值处发送警告
- 按玩家和世界单独追踪时间
时间耗尽时
- 发送过期消息
- 执行配置的 expire-commands
- 开始冷却(基于权限组或默认值)
- 玩家将传送回其保存的返回点
- 如果不存在返回点,玩家将被传送到主世界的出生点
断开连接安全保护
- 如果玩家在受限世界中断开连接,其计时器会被保存
- 重新加入时,如果计时器已过期或处于冷却状态,他们将被传送至安全位置
- 这防止了玩家通过断开连接或切换服务器来绕过限制
LuckPerms 设置示例
# 默认权限组:30 分钟限制,10 分钟冷却
/lp group default permission set worldtimer.limit.resource.30m true
/lp group default permission set worldtimer.cooldown.resource.10m true
# VIP 权限组:1 小时限制,5 分钟冷却
/lp group vip permission set worldtimer.limit.resource.1h true
/lp group vip permission set worldtimer.cooldown.resource.5m true
# MVP 权限组:2 小时限制,无冷却
/lp group mvp permission set worldtimer.limit.resource.2h true
/lp group mvp permission set worldtimer.cooldown.resource.0s true
# 工作人员:豁免所有限制
/lp group staff permission set worldtimer.bypass.resource true
未安装 LuckPerms
如果未安装 LuckPerms,插件仍可正常工作:
- 所有玩家均使用配置文件中的
default-limit-seconds
- 所有玩家均使用配置文件中的
default-cooldown-seconds
- 通过 Bukkit 权限系统,绕过权限(Bypass permissions)仍然生效
- 启动时会在日志中记录一条警告信息
存储
数据存储在 plugins/WorldTimer/data.db(SQLite)中:
- timer_data — 每位玩家每个世界的:已用秒数、冷却时间戳
- player_worlds — 每位玩家最后已知所在的维度
- return_locations — 保存的返回点(维度、x、y、z、偏航角、俯仰角)
占位符
可在消息中使用:
%player% — 玩家名称
%world% — 维度名称
%time_remaining% — 格式化后的剩余时间(例如:“5m 30s”)
%cooldown_remaining% — 格式化后的冷却剩余时间
构建
mvn clean package
输出文件:target/world-timer-1.0-SNAPSHOT.jar
许可证
MIT
WorldTimer
A Paper 1.20.1 plugin that enforces configurable time limits for specific worlds (e.g., resource worlds) with rank-based overrides via LuckPerms.
Features
- Per-world time limits — Configure how long players can stay in each world
- Rank-based overrides — Different ranks get different time limits and cooldowns via LuckPerms permissions
- Cooldown system — Players must wait before re-entering a world after their time expires
- Warning messages — Configurable warnings at specific time thresholds
- Expiry actions — Run commands when a player's time expires (e.g., titles, effects)
- Return teleport — Players are teleported back to their exact pre-entry location
- Persistent storage — SQLite database survives restarts and crashes
- Bypass permission — Staff can bypass all restrictions per-world
Requirements
- Paper 1.20.1+ (or compatible fork)
- Java 17+
Optional Dependencies
- LuckPerms — For permission-based time limits and cooldowns. Without it, all players use the default values from config.
- Multiverse-Core — Works seamlessly with Multiverse-managed worlds
Installation
- Download the latest
world-timer-x.x.jar from releases
- Place it in your server's
plugins/ folder
- Restart the server
- Edit
plugins/WorldTimer/config.yml to configure your worlds
- Reload with
/worldtimer reload
Configuration
# How often the plugin checks timers (in seconds)
tick-seconds: 1
storage:
type: sqlite
messages:
prefix: "&8[&bWorldTimer&8] &r"
warn: "&eYou have &6%time_remaining% &eremaining in &6%world%&e."
expired: "&cYour time in &6%world% &chas expired."
cooldown: "&cYou must wait &6%cooldown_remaining% &cbefore re-entering &6%world%&c."
worlds:
resource: # World name (case-insensitive)
enabled: true
main-world: "survival" # Fallback teleport world
teleport-location: "spawn" # Currently uses return point or spawn
default-limit-seconds: 1800 # 30 minutes (used if no permission)
default-cooldown-seconds: 600 # 10 minutes (used if no permission)
limit-permission-prefix: "worldtimer.limit.resource."
cooldown-permission-prefix: "worldtimer.cooldown.resource."
bypass-permission: "worldtimer.bypass.resource"
warn-at-seconds: [600, 300, 60, 10] # Warn at 10m, 5m, 1m, 10s remaining
expire-commands:
- "title %player% title {\"text\":\"Time is up!\",\"color\":\"red\"}"
Permissions
Time Limit Permissions
Format: worldtimer.limit.<world>.<duration>
| Permission |
Effect |
worldtimer.limit.resource.30m |
30 minute limit |
worldtimer.limit.resource.1h |
1 hour limit |
worldtimer.limit.resource.2h |
2 hour limit |
worldtimer.limit.resource.unlimited |
No time limit |
Duration formats: 30s, 30m, 2h, 1d, unlimited
If a player has multiple limit permissions, the highest value is used.
Cooldown Permissions
Format: worldtimer.cooldown.<world>.<duration>
| Permission |
Effect |
worldtimer.cooldown.resource.5m |
5 minute cooldown |
worldtimer.cooldown.resource.10m |
10 minute cooldown |
worldtimer.cooldown.resource.0s |
No cooldown |
If a player has multiple cooldown permissions, the highest value is used.
Other Permissions
| Permission |
Description |
worldtimer.bypass.<world> |
Bypass all restrictions for a world |
worldtimer.admin |
Full access to all commands |
worldtimer.reload |
Access to /worldtimer reload |
worldtimer.manage |
Access to reset/addtime/setcooldown commands |
worldtimer.status |
Access to /worldtimer status |
Commands
| Command |
Description |
/worldtimer reload |
Reload configuration |
/worldtimer status [player] |
View timer status for yourself or another player |
/worldtimer reset <player> <world> |
Reset a player's timer and cooldown |
/worldtimer addtime <player> <world> <time> |
Add time to a player's allowance |
/worldtimer setcooldown <player> <world> <time> |
Set or clear a player's cooldown |
Alias: /wt
How It Works
Entry Flow
- Player teleports to a configured world
- Plugin checks for bypass permission → if present, allow freely
- Plugin checks for active cooldown → if active, block entry and show message
- Plugin saves the player's current location as their return point
- Plugin resolves time limit from permissions (or uses default)
- Timer tracking begins
While In World
- Timer increments every tick interval
- Warnings are sent at configured thresholds
- Time is tracked per-player per-world
On Expiry
- Expiry message is sent
- Configured expire-commands are executed
- Cooldown begins (based on permissions or default)
- Player is teleported back to their saved return point
- If no return point exists, player goes to main world spawn
Disconnect Safety
- If a player disconnects while in a limited world, their timer is saved
- On rejoin, if their timer is expired or cooldown is active, they're teleported to safety
- This prevents bypassing limits by disconnecting or switching servers
LuckPerms Setup Example
# Default rank: 30 minute limit, 10 minute cooldown
/lp group default permission set worldtimer.limit.resource.30m true
/lp group default permission set worldtimer.cooldown.resource.10m true
# VIP rank: 1 hour limit, 5 minute cooldown
/lp group vip permission set worldtimer.limit.resource.1h true
/lp group vip permission set worldtimer.cooldown.resource.5m true
# MVP rank: 2 hour limit, no cooldown
/lp group mvp permission set worldtimer.limit.resource.2h true
/lp group mvp permission set worldtimer.cooldown.resource.0s true
# Staff: bypass all restrictions
/lp group staff permission set worldtimer.bypass.resource true
Without LuckPerms
If LuckPerms is not installed, the plugin still works:
- All players use
default-limit-seconds from config
- All players use
default-cooldown-seconds from config
- Bypass permissions still work via Bukkit's permission system
- A warning is logged on startup
Storage
Data is stored in plugins/WorldTimer/data.db (SQLite):
- timer_data — Per-player per-world: seconds used, cooldown timestamp
- player_worlds — Last known world for each player
- return_locations — Saved return points (world, x, y, z, yaw, pitch)
Placeholders
Available in messages:
%player% — Player name
%world% — World name
%time_remaining% — Formatted time remaining (e.g., "5m 30s")
%cooldown_remaining% — Formatted cooldown remaining
Building
mvn clean package
Output: target/world-timer-1.0-SNAPSHOT.jar
License
MIT
评论 0
登录后参与评分
还没有评论,来抢沙发吧