RegionTokens 插件

此 Minecraft 插件允许你创建区域,并向玩家发放基于时间的令牌,以控制他们在每个区域内可以停留的时间。
? 功能
- ?️ 区域管理:使用直观的区域选择工具定义立方体区域
- ? 基于令牌的访问:玩家需要令牌才能进入受限区域
- ⏱️ 时间追踪:令牌倒计时仅在玩家位于区域内时进行
- ? 数据库:使用 SQLite 存储持久化的玩家数据
- ? PlaceholderAPI:完全集成自定义占位符
- ? 基于权限:完整的区域和令牌权限系统
- ? 防作弊:防止通过传送、丢弃令牌或无令牌跳跃来作弊
- ⚙️ 重载命令:无需重启服务器即可热重载配置
- ? 可自定义消息:完全可配置的消息和通知
? 要求
- Java 21+
- Spigot/Paper 1.21.1+
- Gradle(用于从源代码构建)
编译后的 JAR 文件将位于 build/libs/RegionTokens-1.0.0.jar
? 安装
- 从
build/libs/ 下载 RegionTokens-1.0.0.jar
- 将其放入服务器的
plugins/ 文件夹中
- 重启服务器
- 配置文件将在
plugins/RegionTokens/ 中自动生成
? 快速开始
步骤 1:获取区域工具
/rgtk tool
这将给你一把充当区域创建工具的剪刀。
步骤 2:创建一个区域
- 使用工具左击一个方块以设置位置 1
- 使用工具右击一个方块以设置位置 2
- 运行
/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% # 当前令牌名称
?️ 故障排除
玩家无法进入区域
- 检查玩家是否拥有
regiontokens.zones.enter 权限
- 确认其背包内有有效的令牌
- 检查令牌持续时间是否已过期
- 确保令牌已分配给该区域
令牌不倒计时
- 验证玩家是否确实位于区域内
- 检查时间警告阈值是否设置过高
- 查找与
regiontokens.token.use.* 相关的权限问题
区域创建问题
- 确保已设置两个位置点(使用
/rgtk tool)
- 两个位置点必须位于同一个世界
- 位置点 1 和 2 的坐标必须不同
数据库错误
- 检查
playerdata.db 的权限(应为可读/可写)
- 确保 SQLite 未被其他进程锁定
- 尝试删除数据库以重新生成(这将清除所有玩家的计时数据)
? 许可证
保留所有权利。RegionTokens © 2026
? 支持
如有问题、功能请求或疑问,请联系插件作者。
版本: 1.0.0
最后更新: 2026年1月28日
Java 版本: 21+
Minecraft 版本: 1.21.1+
RegionTokens Plugin

This Minecraft plugin lets you create zones and give players time-based tokens that control how long they can stay in each zone.
? Features
- ?️ Zone Management: Define cuboid zones with an intuitive zone selection tool
- ? Token-Based Access: Players need tokens to enter restricted zones
- ⏱️ Time Tracking: Token time only counts down while inside the zone
- ? Database: SQLite storage for persistent player data
- ? PlaceholderAPI: Full integration for custom placeholders
- ? Permission-Based: Complete permission system for zones and tokens
- ? Anti-Exploit: Protection against teleporting, dropping tokens, and jumping without tokens
- ⚙️ Reload Command: Hot-reload configuration without server restart
- ? Customizable Messages: Fully configurable messages and notifications
? Requirements
- Java 21+
- Spigot/Paper 1.21.1+
- Gradle (for building from source)
The compiled JAR will be in build/libs/RegionTokens-1.0.0.jar
? Installation
- Download
RegionTokens-1.0.0.jar from build/libs/
- Place in your server's
plugins/ folder
- Restart the server
- Configuration files will be auto-generated in
plugins/RegionTokens/
? Quick Start
Step 1: Get the Zone Tool
/rgtk tool
This gives you shears that act as the zone creation tool.
Step 2: Create a Zone
- Left-click a block with the tool to set Position 1
- Right-click a block with the tool to set Position 2
- Run
/rgtk zone create <zoneName> to create the zone
Step 3: Create a Token
/rgtk token create <tokenName> [duration]
Examples:
/rgtk token create FarmToken 1h - 1 hour duration
/rgtk token create ArenaToken 30m - 30 minute duration
/rgtk token create VIPToken 2h - 2 hours duration
Duration Formats: 1h, 30m, 60s, 1h30m, etc.
Step 4: Assign Token to Zone
/rgtk token assign <tokenID> <zoneID>
Use these to find IDs:
/rgtk zone list - Lists all zones with IDs
/rgtk token list - Lists all tokens with IDs
Step 5: Configure Token Item (Optional)
/rgtk token item <tokenID> [is-glowing|not-glowing]
Give the token to a player:
/rgtk token give <playerName> <tokenID>
? Complete Command Reference
Zone Commands
| Command |
Description |
Permission |
/rgtk zone create <name> |
Create a new zone |
regiontokens.admin.zones.create |
/rgtk zone list [page] |
List all zones |
regiontokens.admin.zones.list |
/rgtk zone rename <id> <name> |
Rename a zone |
regiontokens.admin.zones.rename |
/rgtk zone kickto <x> <y> <z> |
Set zone kick location |
regiontokens.admin.zones.kickto |
/rgtk zone show <id> |
Display zone boundaries |
regiontokens.admin.zones.list |
/rgtk zone delete <id> |
Delete a zone |
regiontokens.admin.zones.create |
Token Commands
| Command |
Description |
Permission |
/rgtk token create <name> [duration] |
Create a new token |
regiontokens.admin.token.create |
/rgtk token list [page] |
List all tokens |
regiontokens.admin.token.create |
/rgtk token assign <tokenID> <zoneID> |
Assign token to zone |
regiontokens.admin.token.create |
/rgtk token unassign <tokenID> <zoneID> |
Remove token from zone |
regiontokens.admin.token.create |
/rgtk token duration <tokenID> <duration> |
Change token duration |
regiontokens.admin.token.duration |
/rgtk token item <tokenID> [glowing] |
Configure token item |
regiontokens.admin.token.create |
/rgtk token rename <tokenID> <newName> |
Rename a token |
regiontokens.admin.token.create |
/rgtk token lore add <tokenID> <text> |
Add lore line |
regiontokens.admin.token.create |
/rgtk token lore set <tokenID> <line> <text> |
Edit lore line |
regiontokens.admin.token.create |
/rgtk token lore remove <tokenID> <line> |
Remove lore line |
regiontokens.admin.token.create |
/rgtk token give <player> <tokenID> |
Give token to player |
regiontokens.admin.token.create |
/rgtk token delete <tokenID> |
Delete a token |
regiontokens.admin.token.create |
Tool Commands
| Command |
Description |
Permission |
/rgtk tool |
Get the zone selection tool |
regiontokens.admin.tool |
System Commands
| Command |
Description |
Permission |
/rgtk reload |
Reload configuration |
regiontokens.admin.reload |
/rgtk help |
Show help message |
None |
? Permissions
Admin Permissions
regiontokens.admin.tool # Use zone tool
regiontokens.admin.zones.create # Create/delete zones
regiontokens.admin.zones.list # List zones
regiontokens.admin.zones.kickto # Set zone kick location
regiontokens.admin.zones.rename # Rename zones
regiontokens.admin.token.create # Create/delete tokens
regiontokens.admin.token.duration # Change token duration
regiontokens.admin.token.create # Manage token items
regiontokens.admin.token.create # Manage token lore
regiontokens.admin.reload # Reload plugin
regiontokens.role.admin # Admin access to all commands
Player Permissions
regiontokens.zones.enter # Enter token-restricted zones
regiontokens.zones.bypass.* # Bypass all zones
regiontokens.zones.bypass.<zoneId> # Bypass specific zone
regiontokens.token.use.* # Use all tokens
regiontokens.token.use.<tokenId> # Use specific token
? Features in Detail
Multiple Tokens Per Zone
- Assign multiple tokens to a single zone
- Each token can have different durations
- Players can use any of the assigned tokens to enter
Token Countdown
- Tokens count down in real-time while inside the zone
- Time displays in token lore (HH:MM:SS format)
- Warning message when time is running low
- Automatic kick when time expires
Zone Protection
- Movement Block: Prevents walking into zones without tokens
- Teleport Block: Prevents
/tp into zones without tokens
- Fallback Kick: Kicks players found in zones without valid tokens
- Item Drop Detection: Kicks players who drop their tokens
- Inventory Verification: Prevents holding tokens without being in zone
Anti-Exploit Features
- Players cannot stay in zone after dropping tokens
- Teleporting into zone without token is blocked
- Jumping from above into zone triggers automatic kick
- Token time persists if dropped and picked up again
- Bypass permissions for admins to bypass all checks
? Data Storage
plugins/RegionTokens/
├── config.yml # Main configuration
├── zones/
│ ├── 1.yml # Zone data
│ └── 2.yml # Zone data
├── tokens/
│ ├── 1.yml # Token data
│ └── 2.yml # Token data
└── playerdata.db # SQLite database (player times)
⚙️ Configuration
Edit plugins/RegionTokens/config.yml to customize:
plugin:
name: "RegionTokens"
version: "1.0.0"
messages:
prefix: "&8[&bRegionTokens&8]&r"
zone:
created:
title: "&a&lZone Created"
subtitle: "&6{zoneName} &bsuccessfully created"
# ... more messages
token:
created: "{prefix} &eToken created..."
assigned: "{prefix} &eToken {tokenName} &eassigned..."
# ... more messages
pagination:
items-per-page: 5
See config.yml for all customizable options.
? PlaceholderAPI Placeholders
%regiontokens_zone% # Current zone name
%regiontokens_time_left% # Time remaining in token
%regiontokens_token% # Current token name
?️ Troubleshooting
Players can't enter zones
- Check if player has
regiontokens.zones.enter permission
- Verify they have a valid token in inventory
- Check token duration hasn't expired
- Ensure token is assigned to the zone
Tokens not counting down
- Verify player is actually in the zone
- Check if time warning threshold is set too high
- Look for permission issues with
regiontokens.token.use.*
Zone creation issues
- Ensure both positions are set (use
/rgtk tool)
- Both positions must be in the same world
- Position 1 and 2 must be different coordinates
Database errors
- Check
playerdata.db permissions (should be readable/writable)
- Ensure SQLite is not locked by another process
- Try deleting the database to regenerate (clears all player times)
? License
All rights reserved. RegionTokens © 2026
? Support
For issues, feature requests, or questions, contact the plugin author.
Version: 1.0.0
Last Updated: January 28, 2026
Java Version: 21+
Minecraft Version: 1.21.1+
评论 0
登录后参与评分
还没有评论,来抢沙发吧