Region Tokens

插件

· 作者 ItzSD

这个 Minecraft 插件允许你创建区域,并向玩家发放有时效性的令牌,以控制他们在每个区域内可以停留的时间。

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

最新 1.0.0 · 1.21.11 · Paper

一键开服(送7天)

RegionTokens 插件

Region Tokens

此 Minecraft 插件允许你创建区域,并向玩家发放基于时间的令牌,以控制他们在每个区域内可以停留的时间。

? 功能

  • ?️ 区域管理:使用直观的区域选择工具定义立方体区域
  • ? 基于令牌的访问:玩家需要令牌才能进入受限区域
  • ⏱️ 时间追踪:令牌倒计时仅在玩家位于区域内时进行
  • ? 数据库:使用 SQLite 存储持久化的玩家数据
  • ? PlaceholderAPI:完全集成自定义占位符
  • ? 基于权限:完整的区域和令牌权限系统
  • ? 防作弊:防止通过传送、丢弃令牌或无令牌跳跃来作弊
  • ⚙️ 重载命令:无需重启服务器即可热重载配置
  • ? 可自定义消息:完全可配置的消息和通知

? 要求

  • Java 21+
  • Spigot/Paper 1.21.1+
  • Gradle(用于从源代码构建)

编译后的 JAR 文件将位于 build/libs/RegionTokens-1.0.0.jar

? 安装

  1. 从 build/libs/ 下载 RegionTokens-1.0.0.jar
  2. 将其放入服务器的 plugins/ 文件夹中
  3. 重启服务器
  4. 配置文件将在 plugins/RegionTokens/ 中自动生成

? 快速开始

步骤 1:获取区域工具

/rgtk tool

这将给你一把充当区域创建工具的剪刀。

步骤 2:创建一个区域

  1. 使用工具左击一个方块以设置位置 1
  2. 使用工具右击一个方块以设置位置 2
  3. 运行 /rgtk zone create <zoneName> 创建该区域

步骤 3:创建一个令牌

/rgtk token create <tokenName> [duration]

示例:

  • /rgtk token create FarmToken 1h - 时长 1 小时
  • /rgtk token create ArenaToken 30m - 时长 30 分钟
  • /rgtk token create VIPToken 2h - 时长 2 小时

时长格式:1h、30m、60s、1h30m 等。

步骤 4:将令牌分配给区域

/rgtk token assign <tokenID> <zoneID>

使用以下命令查找 ID:

  • /rgtk zone list - 列出所有带 ID 的区域
  • /rgtk token list - 列出所有带 ID 的令牌

步骤 5:配置令牌物品(可选)

/rgtk token item <tokenID> [is-glowing|not-glowing]

将令牌给予玩家:

/rgtk token give <playerName> <tokenID>

? 完整命令参考

区域命令

命令 描述 权限
/rgtk zone create <name> 创建新区域 regiontokens.admin.zones.create
/rgtk zone list [page] 列出所有区域 regiontokens.admin.zones.list
/rgtk zone rename <id> <name> 重命名区域 regiontokens.admin.zones.rename
/rgtk zone kickto <x> <y> <z> 设置区域踢出位置 regiontokens.admin.zones.kickto
/rgtk zone show <id> 显示区域边界 regiontokens.admin.zones.list
/rgtk zone delete <id> 删除区域 regiontokens.admin.zones.create

令牌命令

命令 描述 权限
/rgtk token create <name> [duration] 创建新令牌 regiontokens.admin.token.create
/rgtk token list [page] 列出所有令牌 regiontokens.admin.token.create
/rgtk token assign <tokenID> <zoneID> 将令牌分配给区域 regiontokens.admin.token.create
/rgtk token unassign <tokenID> <zoneID> 从区域移除令牌 regiontokens.admin.token.create
/rgtk token duration <tokenID> <duration> 更改令牌时长 regiontokens.admin.token.duration
/rgtk token item <tokenID> [glowing] 配置令牌物品 regiontokens.admin.token.create
/rgtk token rename <tokenID> <newName> 重命名令牌 regiontokens.admin.token.create
/rgtk token lore add <tokenID> <text> 添加描述行 regiontokens.admin.token.create
/rgtk token lore set <tokenID> <line> <text> 编辑描述行 regiontokens.admin.token.create
/rgtk token lore remove <tokenID> <line> 移除描述行 regiontokens.admin.token.create
/rgtk token give <player> <tokenID> 将令牌给予玩家 regiontokens.admin.token.create
/rgtk token delete <tokenID> 删除令牌 regiontokens.admin.token.create

工具命令

命令 描述 权限
/rgtk tool 获取区域选择工具 regiontokens.admin.tool

系统命令

命令 描述 权限
/rgtk reload 重载配置 regiontokens.admin.reload
/rgtk help 显示帮助信息 无

? 权限

管理员权限

regiontokens.admin.tool                    # 使用区域工具
regiontokens.admin.zones.create            # 创建/删除区域
regiontokens.admin.zones.list              # 列出区域
regiontokens.admin.zones.kickto            # 设置区域踢出位置
regiontokens.admin.zones.rename            # 重命名区域
regiontokens.admin.token.create            # 创建/删除令牌
regiontokens.admin.token.duration          # 更改令牌时长
regiontokens.admin.token.create            # 管理令牌物品
regiontokens.admin.token.create            # 管理令牌描述
regiontokens.admin.reload                  # 重载插件
regiontokens.role.admin                    # 管理员对所有命令的访问权限

玩家权限

regiontokens.zones.enter                   # 进入需令牌的受限区域
regiontokens.zones.bypass.*                # 绕过所有区域
regiontokens.zones.bypass.<zoneId>         # 绕过特定区域
regiontokens.token.use.*                   # 使用所有令牌
regiontokens.token.use.<tokenId>           # 使用特定令牌

? 功能详情

一个区域对应多个令牌

  • 可将多个令牌分配给单个区域
  • 每个令牌可以有不同的时长
  • 玩家可以使用已分配的任意令牌进入

令牌倒计时

  • 在区域范围内时,令牌数量实时递减
  • 时间显示在令牌的描述信息中(HH:MM:SS 格式)
  • 时间不足时发出警告消息
  • 时间耗尽后自动踢出玩家

区域保护

  • 移动限制:阻止未持有令牌的玩家进入区域
  • 传送限制:阻止使用 /tp 指令进入未持有令牌的区域
  • 回退踢出:将发现处于区域内但未持有有效令牌的玩家踢出
  • 物品掉落检测:踢出丢弃令牌的玩家
  • 背包验证:防止玩家在非区域状态下持有令牌

防作弊功能

  • 玩家丢弃令牌后无法继续停留在区域内
  • 阻止未持有令牌的情况下传送到区域内
  • 从上方跳跃进入区域会触发自动踢出
  • 令牌被丢弃并再次拾取后,剩余时间保持不变
  • 管理员拥有绕过所有检查的权限

? 数据存储

plugins/RegionTokens/
├── config.yml                  # 主配置文件
├── zones/
│   ├── 1.yml                  # 区域数据
│   └── 2.yml                  # 区域数据
├── tokens/
│   ├── 1.yml                  # 令牌数据
│   └── 2.yml                  # 令牌数据
└── playerdata.db              # SQLite 数据库(玩家计时数据)

⚙️ 配置

编辑 plugins/RegionTokens/config.yml 以进行自定义设置:

plugin:
  name: "RegionTokens"
  version: "1.0.0"

messages:
  prefix: "&8[&bRegionTokens&8]&r"
  
  zone:
    created:
      title: "&a&l区域已创建"
      subtitle: "&6{zoneName} &b已成功创建"
    # ... 更多消息
  
  token:
    created: "{prefix} &e令牌已创建..."
    assigned: "{prefix} &e令牌 {tokenName} &b已分配..."
    # ... 更多消息

pagination:
  items-per-page: 5

有关所有可自定义选项,请参阅 config.yml。

? PlaceholderAPI 占位符

%regiontokens_zone%          # 当前区域名称
%regiontokens_time_left%     # 令牌剩余时间
%regiontokens_token%         # 当前令牌名称

?️ 故障排除

玩家无法进入区域

  1. 检查玩家是否拥有 regiontokens.zones.enter 权限
  2. 确认其背包内有有效的令牌
  3. 检查令牌持续时间是否已过期
  4. 确保令牌已分配给该区域

令牌不倒计时

  1. 验证玩家是否确实位于区域内
  2. 检查时间警告阈值是否设置过高
  3. 查找与 regiontokens.token.use.* 相关的权限问题

区域创建问题

  1. 确保已设置两个位置点(使用 /rgtk tool)
  2. 两个位置点必须位于同一个世界
  3. 位置点 1 和 2 的坐标必须不同

数据库错误

  1. 检查 playerdata.db 的权限(应为可读/可写)
  2. 确保 SQLite 未被其他进程锁定
  3. 尝试删除数据库以重新生成(这将清除所有玩家的计时数据)

? 许可证

保留所有权利。RegionTokens © 2026

? 支持

如有问题、功能请求或疑问,请联系插件作者。


版本: 1.0.0
最后更新: 2026年1月28日
Java 版本: 21+
Minecraft 版本: 1.21.1+

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源