WorldTimer

插件

· 作者 blueobsidian196

WorldTimer 提供基于世界的游戏时长限制,支持按权限组覆盖、警告提示、冷却时间及安全返回传送。非常适合用于限制资源/挖矿世界的游玩时间,同时保持主世界无限制。

0 本站下载 0 关注 更新于 8 个月前

最新 1.0.1 · 1.20.6 · Bukkit / Paper

一键开服(送7天)

WorldTimer

一个适用于 Paper 1.20.1 的插件,可为特定世界(例如资源世界)强制执行可配置的时间限制,并通过 LuckPerms 实现基于权限组的覆盖。

功能特性

  • 按世界设置时间限制 — 配置玩家在每个世界中可以停留的时长
  • 基于权限组的重写机制 — 通过 LuckPerms 权限,不同权限组拥有不同的时间限制和冷却时间
  • 冷却系统 — 玩家时间用尽后,必须等待一段时间才能重新进入该世界
  • 警告消息 — 在特定的时间阈值时发送可配置的警告
  • 过期动作 — 当玩家时间耗尽时执行命令(例如标题、效果等)
  • 返回传送 — 玩家将传送回进入前的确切位置
  • 持久化存储 — SQLite 数据库可在服务器重启和崩溃后保留数据
  • 豁免权限 — 工作人员可按世界豁免所有限制

依赖要求

  • Paper 1.20.1+(或兼容分支)
  • Java 17+

可选依赖

  • LuckPerms — 用于基于权限的时间限制和冷却。如果没有安装它,所有玩家将使用配置文件中的默认值。
  • Multiverse-Core — 与 Multiverse 管理的世界无缝配合

安装步骤

  1. 从发布页面下载最新的 world-timer-x.x.jar
  2. 将其放入服务器的 plugins/ 文件夹中
  3. 重启服务器
  4. 编辑 plugins/WorldTimer/config.yml 以配置你的世界
  5. 运行 /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

工作原理

进入流程

  1. 玩家传送至已配置的世界
  2. 插件检查是否有豁免权限 → 如果有,允许自由进入
  3. 插件检查是否存在活跃冷却 → 如果存在,阻止进入并显示消息
  4. 插件保存玩家当前位置作为返回点
  5. 插件解析权限组确定的时间限制(或使用默认值)
  6. 开始计时追踪

在世界内期间

  • 计时器每个 tick 间隔递增
  • 在配置的阈值处发送警告
  • 按玩家和世界单独追踪时间

时间耗尽时

  1. 发送过期消息
  2. 执行配置的 expire-commands
  3. 开始冷却(基于权限组或默认值)
  4. 玩家将传送回其保存的返回点
  5. 如果不存在返回点,玩家将被传送到主世界的出生点

断开连接安全保护

  • 如果玩家在受限世界中断开连接,其计时器会被保存
  • 重新加入时,如果计时器已过期或处于冷却状态,他们将被传送至安全位置
  • 这防止了玩家通过断开连接或切换服务器来绕过限制

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

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源