EzRTP 高级随机传送插件
适用于现代 Minecraft 服务器的生产级随机传送插件。
文档:
安装指南:
< 3.0.0版本基于 Java 17 (MC 1.13 - 1.21.11.*) 构建,适用于 Bukkit/Paper/Spigot/Purpur/Folia>= 3.0.0版本基于 Java 25 (MC 26.1.*) 构建,适用于 Bukkit/Paper/Spigot/Purpur/Folia>= 3.1.0版本基于 Java 17 (MC 1.13 - 1.21.11.*) 构建,适用于 Bukkit/Paper/Spigot/Purpur/Folia
Modrinth • SpigotMC • Hangar • Discord
功能概览
- 安全的随机传送,支持配置化的危险方块过滤与恢复行为。
- 生物群系包含/排除过滤、预缓存以及稀有生物群系优化(加权搜索 + 热点追踪)。
- 搜索模式控制:
random(随机)、circle(圆形)、square(方形)、triangle(三角形)、diamond(菱形)。 - 队列控制及按世界和权限组的冷却时间/使用次数限制。
- 带有独立目的地权限的 GUI 目的地选择器。
- 热力图工具 (
/rtp heatmap,/rtp heatmap save) 和模拟样本 (/rtp fake)。 - 命名中心 (
/rtp addcenter,/rtp <center-name>) 及中心编辑 (/rtp setcenter)。 - 通过
network.yml可选的网络选择器条目。 - 可选的 Chunky 预生成命令 (
/rtp pregenerate [world] [radius])。 - 可选的性能与危险位置监控数据导出。
- 兼容 Folia 的现代服务器调度模型运行时行为。
功能预览
生物群系统计仪表板

热力图可视化

世界选择器 GUI

子命令
主要命令
| 命令 | 描述 | 权限 |
|---|---|---|
/rtp |
默认 RTP 流程(根据设置决定使用 GUI 或直接传送) | ezrtp.use |
/forcertp <player> [world] |
强制对目标玩家进行 RTP | ezrtp.forcertp |
/rtp 子命令
| 子命令 | 用法 | 权限 | 备注 |
|---|---|---|---|
reload |
/rtp reload |
ezrtp.reload |
重载配置 |
stats |
/rtp stats |
ezrtp.stats |
总体 RTP 指标 |
stats biomes |
/rtp stats biomes [page] |
ezrtp.stats |
生物群系活动 + 分页 |
stats rare-biomes |
/rtp stats rare-biomes |
ezrtp.stats |
稀有生物群系优化统计 |
stats performance |
/rtp stats performance |
ezrtp.stats |
百分位/计时指标 |
unsafe-stats |
/rtp unsafe-stats |
ezrtp.stats |
危险拒绝分解统计 |
heatmap |
/rtp heatmap [biome] |
ezrtp.heatmap |
提供游戏内热力图地图 |
heatmap save |
/rtp heatmap save |
ezrtp.heatmap |
将热力图 PNG 保存至插件文件夹 |
fake |
`/rtp fake <amount | clear> [world]` | ezrtp.heatmap.fake |
setcenter |
/rtp setcenter <x> <z> 或 /rtp setcenter <world> <x> <z> |
ezrtp.setcenter |
更新世界中心并重载 |
addcenter |
/rtp addcenter <name> |
ezrtp.setcenter |
在玩家位置存储命名中心 |
pregenerate |
/rtp pregenerate [world] [radius] |
ezrtp.pregenerate |
启动由 Chunky 辅助的预热任务 |
额外 RTP 路由
/rtp <center-name>: 使用rtp.yml中的centers.named.<name>进行传送。/rtp <region-id>: 当worldguard.region-command.enabled: true时,基于 WorldGuard 区域进行 RTP。
权限
声明于 plugin.yml
| 权限 | 默认值 | 用途 |
|---|---|---|
ezrtp.use |
true |
使用 /rtp |
ezrtp.reload |
op |
使用 /rtp reload |
ezrtp.stats |
op |
使用 stats/unsafe-stats |
ezrtp.heatmap |
op |
使用热力图生成/导出 |
ezrtp.heatmap.fake |
op |
使用 /rtp fake |
ezrtp.queue.bypass |
op |
绕过队列 |
ezrtp.forcertp |
op |
使用 /forcertp |
运行时/配置中使用
| 权限 | 来源 | 用途 |
|---|---|---|
ezrtp.setcenter |
命令代码 | 访问 setcenter 和 addcenter |
ezrtp.pregenerate |
命令代码 | 访问 /rtp pregenerate |
ezrtp.bypass.cooldown |
limits.yml 默认值 |
冷却时间绕过 |
ezrtp.bypass.limit |
limits.yml 默认值 |
每日/每周限制绕过 |
ezrtp.gui.<name> |
gui.yml 条目 |
独立目的地 GUI 访问权限 |
配置文件
EzRTP 现在按关注点分离配置。
| 文件 | 范围 | 示例键 |
|---|---|---|
config.yml |
核心插件/全局选项 | message-prefix, language, enable-bstats, worldguard.region-command.* |
rtp.yml |
RTP 行为与安全设置 | search-pattern, radius.*, countdown.*, unsafe-blocks, biomes.*, chunky-integration.* |
limits.yml |
冷却时间/使用量/费用配置 | rtp-limits.default, rtp-limits.worlds, allow-gui-during-cooldown |
storage.yml |
限制存储后端 | rtp-limits.storage, rtp-limits.mysql.* |
gui.yml |
GUI 布局与目标世界 | enabled, rows, worlds.*.icon, disable-cache-filtering, rare_biomes.* |
queue.yml |
队列节流控制 | enabled, max-size, start-delay-ticks, interval-ticks |
network.yml |
代理/服务器选择器 | enabled, lobby, servers.<name>.* |
force-rtp.yml |
/forcertp 行为 |
default-world, bypass.cooldown, bypass.permission, bypass.safety |
performance.yml |
可选的性能监控 | performance.monitoring.enabled, warnings.*, metrics.*, percentiles.* |
unsafe-location-monitoring.yml |
可选的不安全位置追踪 | unsafe-location-monitoring.monitoring.enabled, logging.*, metrics.* |
messages/en.yml |
面向用户的文本模板 | teleport-*, queue-*, forcertp-*, heatmap-*, fake-*, stats-* |
当前核心默认值(部分)
# config.yml
message-prefix: "&7[&bEzRTP&7] &r"
language: en
enable-bstats: true
worldguard:
region-command:
enabled: false
autocomplete: false
# rtp.yml
search-pattern: random
max-attempts: 16
countdown-seconds: 5
heatmap:
enabled: false
biomes:
enabled: true
pre-cache:
enabled: false
rare-biome-optimization:
enabled: false
chunky-integration:
enabled: false
# limits.yml
rtp-limits:
default:
cooldown-seconds: 300
daily-limit: 10
weekly-limit: 50
bypass-permissions:
- ezrtp.bypass.cooldown
- ezrtp.bypass.limit
allow-gui-during-cooldown: true
# storage.yml
rtp-limits:
storage: yaml # yaml 或 mysql
要求
- Java 17 或更高版本。
- Bukkit, Paper, Purpur, Spigot 或 Folia 1.7+。
- 可选:Vault/EzEconomy 用于定价功能。
- 可选:WorldGuard/GriefPrevention 用于领地感知行为。
- 可选:Chunky 用于预生成工作流。
支持
- Discord:
- 项目与发布页:

Advanced Random Teleport Plugin
Production-ready random teleport plugin for modern Minecraft servers.
Documentation:
Installation guide:
< 3.0.0build on Java 17 (MC 1.13 - 1.21.11.*) for Bukkit/Paper/Spigot/Purpur/Folia>= 3.0.0build on Java 25 (MC 26.1.*) for Bukkit/Paper/Spigot/Purpur/Folia>= 3.1.0build on Java 17 (MC 1.13 - 1.21.11.*) for Bukkit/Paper/Spigot/Purpur/Folia
Modrinth • SpigotMC • Hangar • Discord
Feature Summary
- Safe random teleport with configurable unsafe-block filtering and recovery behavior.
- Biome include/exclude filtering, pre-cache, and rare-biome optimization (weighted search + hotspot tracking).
- Search pattern control:
random,circle,square,triangle,diamond. - Queue controls and cooldown/usage limits per world and per group.
- GUI destination selector with per-destination permissions.
- Heatmap tools (
/rtp heatmap,/rtp heatmap save) and simulated samples (/rtp fake). - Named centers (
/rtp addcenter,/rtp <center-name>) and center editing (/rtp setcenter). - Optional network selector entries via
network.yml. - Optional Chunky pre-generation command (
/rtp pregenerate [world] [radius]). - Optional performance and unsafe-location monitoring exports.
- Folia-compatible runtime behavior for modern server scheduling models.
Feature Preview
Biome Statistics Dashboard

Heatmap Visualization

World Selector GUI

Subcommands
Main Commands
| Command | Description | Permission |
|---|---|---|
/rtp |
Default RTP flow (GUI or direct teleport based on setup) | ezrtp.use |
/forcertp <player> [world] |
Force RTP for a target player | ezrtp.forcertp |
/rtp Subcommands
| Subcommand | Usage | Permission | Notes |
|---|---|---|---|
reload |
/rtp reload |
ezrtp.reload |
Reload configuration |
stats |
/rtp stats |
ezrtp.stats |
Overall RTP metrics |
stats biomes |
/rtp stats biomes [page] |
ezrtp.stats |
Biome activity + paging |
stats rare-biomes |
/rtp stats rare-biomes |
ezrtp.stats |
Rare-biome optimization stats |
stats performance |
/rtp stats performance |
ezrtp.stats |
Percentile/timing metrics |
unsafe-stats |
/rtp unsafe-stats |
ezrtp.stats |
Unsafe rejection breakdown |
heatmap |
/rtp heatmap [biome] |
ezrtp.heatmap |
Gives in-game heatmap map |
heatmap save |
/rtp heatmap save |
ezrtp.heatmap |
Saves heatmap PNG to plugin folder |
fake |
`/rtp fake <amount | clear> [world]` | ezrtp.heatmap.fake |
setcenter |
/rtp setcenter <x> <z> or /rtp setcenter <world> <x> <z> |
ezrtp.setcenter |
Updates world center and reloads |
addcenter |
/rtp addcenter <name> |
ezrtp.setcenter |
Stores named center at player location |
pregenerate |
/rtp pregenerate [world] [radius] |
ezrtp.pregenerate |
Starts Chunky-assisted warmup tasks |
Extra RTP Routing
/rtp <center-name>: teleports usingcenters.named.<name>fromrtp.yml./rtp <region-id>: WorldGuard region-based RTP whenworldguard.region-command.enabled: true.
Permissions
Declared in plugin.yml
| Permission | Default | Purpose |
|---|---|---|
ezrtp.use |
true |
Use /rtp |
ezrtp.reload |
op |
Use /rtp reload |
ezrtp.stats |
op |
Use stats/unsafe-stats |
ezrtp.heatmap |
op |
Use heatmap generation/export |
ezrtp.heatmap.fake |
op |
Use /rtp fake |
ezrtp.queue.bypass |
op |
Bypass queue |
ezrtp.forcertp |
op |
Use /forcertp |
Used by Runtime/Config
| Permission | Source | Purpose |
|---|---|---|
ezrtp.setcenter |
command code | Access setcenter and addcenter |
ezrtp.pregenerate |
command code | Access /rtp pregenerate |
ezrtp.bypass.cooldown |
limits.yml defaults |
Cooldown bypass |
ezrtp.bypass.limit |
limits.yml defaults |
Daily/weekly limit bypass |
ezrtp.gui.<name> |
gui.yml entries |
Per-destination GUI access |
Configuration Files
EzRTP now splits configuration by concern.
| File | Scope | Example Keys |
|---|---|---|
config.yml |
Core plugin/global options | message-prefix, language, enable-bstats, worldguard.region-command.* |
rtp.yml |
RTP behavior and safety | search-pattern, radius.*, countdown.*, unsafe-blocks, biomes.*, chunky-integration.* |
limits.yml |
Cooldowns/usage/cost profiles | rtp-limits.default, rtp-limits.worlds, allow-gui-during-cooldown |
storage.yml |
Limits storage backend | rtp-limits.storage, rtp-limits.mysql.* |
gui.yml |
GUI layout and destinations | enabled, rows, worlds.*.icon, disable-cache-filtering, rare_biomes.* |
queue.yml |
Queue throttling | enabled, max-size, start-delay-ticks, interval-ticks |
network.yml |
Proxy/server selector | enabled, lobby, servers.<name>.* |
force-rtp.yml |
/forcertp behavior |
default-world, bypass.cooldown, bypass.permission, bypass.safety |
performance.yml |
Optional perf monitoring | performance.monitoring.enabled, warnings.*, metrics.*, percentiles.* |
unsafe-location-monitoring.yml |
Optional unsafe tracking | unsafe-location-monitoring.monitoring.enabled, logging.*, metrics.* |
messages/en.yml |
User-facing text templates | teleport-*, queue-*, forcertp-*, heatmap-*, fake-*, stats-* |
Current Core Defaults (selected)
# config.yml
message-prefix: "&7[&bEzRTP&7] &r"
language: en
enable-bstats: true
worldguard:
region-command:
enabled: false
autocomplete: false
# rtp.yml
search-pattern: random
max-attempts: 16
countdown-seconds: 5
heatmap:
enabled: false
biomes:
enabled: true
pre-cache:
enabled: false
rare-biome-optimization:
enabled: false
chunky-integration:
enabled: false
# limits.yml
rtp-limits:
default:
cooldown-seconds: 300
daily-limit: 10
weekly-limit: 50
bypass-permissions:
- ezrtp.bypass.cooldown
- ezrtp.bypass.limit
allow-gui-during-cooldown: true
# storage.yml
rtp-limits:
storage: yaml # yaml or mysql
Requirements
- Java 17 or newer.
- Bukkit, Paper, Purpur, Spigot, or Folia 1.7+.
- Optional: Vault/EzEconomy for pricing.
- Optional: WorldGuard/GriefPrevention for claim-aware behavior.
- Optional: Chunky for pre-generation workflows.
Support
- Discord:
- Project and releases:

下载 EzRTP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzRTP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzRTP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzRTP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzRTP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzRTP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzRTP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzRTP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzRTP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 EzRTP
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
已修复
- 修复了
/rtp在异步位置搜索期间间歇性失败的问题(在 Purpur 上观察到),错误表现为CompletionException - java.lang.IllegalArgumentException: argument type mismatch。PaperPlatformScheduler和BukkitPlatformScheduler中的 Folia region/global-scheduler 反射桥接代码原本仅捕获Method.invoke()调用周围的ReflectiveOperationException;现在它们还会捕获RuntimeException,并在无法使用时回退到标准的 Bukkit 调度器,而不是让异常传播。即使在不使用 Folia 的服务器上,只要其类路径中包含 Folia regionized-runtime 标记类,也可能出现此问题。 BukkitPlatformScheduler#executeRegion/executeGlobal/executeGlobalDelayed/executeRegionDelayed现在在反射调用 Folia 调度器失败时,一致地回退到标准的 Bukkit 调度器,而不是静默丢弃任务(与现有的PaperPlatformScheduler行为保持一致)。
新增
- 为调度器反射回退修复添加了回归测试覆盖:
PaperPlatformSchedulerReflectionFallbackTest和BukkitPlatformSchedulerReflectionFallbackTest模拟损坏的 region/global-scheduler 反射调用,并验证提交的任务仍能通过标准调度器回退机制正常运行。PlatformRuntimeCapabilities.PURPUR_REGIONIZED常量,记录了触发该 bug 的确切能力组合。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧