? RandomTeleport — Wild Teleport, Reinvented
专为 Paper 打造的最高自由度 RTP 插件——支持按世界设置冷却时间、每日使用次数限制、交互式 GUI,以及 LuckPerms 集成,零冗余代码。
✦ 什么是 RandomTeleport?
RandomTeleport 让玩家通过一条指令即可探索整个世界。打开交互式的地图选择菜单,选择目的地,然后被传送到一个安全的随机位置——伴有音效、粒子效果和倒计时,确保体验流畅顺滑。
本插件专为 Paper 1.21+ 从头构建,旨在保持代码整洁、高性能且完全可定制,绝不包含任何多余的代码行。
✦ 为什么选择 RandomTeleport?
与臃肿的替代品不同,RandomTeleport 专注于真正重要的功能:
- 无硬性依赖 — Vault 和 LuckPerms 均为可选,插件可独立运行
- 原生 Paper 性能 — 专门为 Paper 的异步 API 构建
- 单一配置文件 — 所有配置均在 config.yml 中,整洁有序
- 实时状态显示 — 玩家可直接在 GUI 中看到冷却时间和每日使用次数
- 真正的 LuckPerms 集成 — 支持原生 API,并能正确解析组继承关系
✦ 功能特性
? 核心玩法
- 交互式 GUI — 精美的物品栏菜单,用于选择世界。普通玩家不可见被禁用的世界,但管理员可见。
- 每日使用次数限制 — 限制每个世界每天的 RTP 使用次数,并通过 LuckPerms 实现按组覆盖。每天午夜自动重置。
- 按世界冷却时间 — 每个世界都有独立的冷却配置,并支持基于组的覆盖(原生支持 LuckPerms)。
- 实时 GUI 反馈 — 每个世界按钮的物品描述中均显示冷却状态和每日使用次数。
- 自定义玩家头像图标 — 使用 Paper 原生的 PlayerProfile API,为每个世界显示玩家头颅而非方块。
? 安全与性能
- 智能地点查找 — 采用异步多线程搜索,支持可配置的区块黑名单、液体规避、虚空保护及区块预加载。
- 倒计时系统 — 传送前提供可配置的倒计时,移动、受到伤害或输入命令时可取消。
- 致盲效果 — 可选的致盲效果,应用于倒计时期间和传送后,以增强沉浸感过渡。
? 经济与权限
- 经济支持 — 可选的 Vault 集成,支持按组定价,并在传送失败时自动退款。
- LuckPerms 就绪 — 原生 LuckPerms API 集成,支持主组 → 继承组 → 权限回退的解析逻辑。
- 细粒度权限控制 — 按世界访问权限 (
rtp.world.<name>)、冷却绕过 (rtp.bypass.cooldown.<name>)、使用次数绕过 (rtp.bypass.uses) 及管理工具权限。
⚙️ 管理工具
- 热重载 —
/rtpadmin reload 可在不重启服务器的情况下重新加载配置。
- 使用量管理 — 重置每日计数器、清除冷却时间、切换绕过状态。
- 结构化日志记录 — 每次传送、失败尝试、经济交易和管理操作均按类别记录日志。
- 隐藏的命令补全 — 非管理员玩家完全看不到
/rtpadmin 命令补全。
? 自定义
- 特效系统 — 出发和落地时的自定义音效和粒子。支持标题栏和操作栏提示。
- 灵活配置 — 世界图标、GUI 布局、填充物品、冷却组、经济金额、日志类别及异步性能设置等均可调整。
✦ 命令
| 命令 |
描述 |
/rtp |
打开世界选择器 GUI |
/rtp [world] |
直接传送至指定世界 |
/rtp [player] [world] |
传送其他玩家(管理员) |
/rtpadmin reload |
重新加载配置 |
/rtpadmin cooldown <player> [world] |
清除玩家的冷却时间 |
/rtpadmin uses reset <player> |
重置每日使用次数计数器 |
/rtpadmin bypass <player> |
切换冷却绕过状态 |
/rtpadmin stats [player] |
查看传送统计信息 |
✦ 权限
| 权限节点 |
描述 |
rtp.use |
可使用 /rtp 命令 |
rtp.world.<name> |
可访问特定世界 |
rtp.bypass.cooldown |
绕过所有冷却时间 |
rtp.bypass.cooldown.<world> |
绕过特定世界的冷却时间 |
rtp.bypass.uses |
绕过每日使用次数限制 |
rtp.bypass.economy |
绕过经济费用 |
rtp.others |
可传送其他玩家 |
rtp.admin |
可使用所有管理命令 |
✦ 兼容性
|
|
| 服务端软件 |
仅限 Paper |
| Minecraft 版本 |
1.21.0 — 1.21.4+ (所有 1.21.x 版本) |
| Java 版本 |
21+ |
| 可选依赖 |
Vault (经济), LuckPerms (权限组) |
⚠️ 不支持 Spigot。 本插件使用了 Paper 独占的 API。
✦ 配置
所有内容均可在单一的 config.yml 中进行配置——包括世界图标(含自定义玩家头颅)、GUI 布局、填充物品、音效、粒子、冷却组、每日使用次数限制、经济金额、日志类别、异步性能设置等。无需辅助文件,毫无杂乱。
示例世界配置:
worlds:
world:
enabled: true
icon: PLAYER_HEAD
head-uuid: "ddb0f735-90ac-44e2-8578-a7dd5a1abfc5"
display-name: "&a&lOverworld"
cooldown:
default-seconds: 300
groups:
admin: 0
vip: 120
default: 300
uses:
default-uses: 5
groups:
admin: 0
vip: 10
default: 5
✦ 快速入门
- 安装 — 将
RandomTeleport.jar 放入你的 plugins/ 文件夹
- 重启 — 启动你的 Paper 服务器 (1.21+)
- 配置 — 根据需要编辑
plugins/RandomTeleport/config.yml
- 重载 — 使用
/rtpadmin reload 应用更改而无需重启服务器
- 测试 — 运行
/rtp 并开始探索!
可选: 安装 Vault 以启用经济集成,安装 LuckPerms 以获得基于组的进阶权限控制。
由 valival_ 用心制作
? RandomTeleport — Wild Teleport, Reinvented
The most configurable RTP plugin for Paper — per-world cooldowns, daily use limits, interactive GUI, LuckPerms integration, and zero bloat.
✦ What is RandomTeleport?
RandomTeleport lets your players explore the world with a single command. Open an interactive world selector menu, pick your destination, and get teleported to a safe random location — with sounds, particles, and a countdown to keep things smooth.
Built from the ground up for Paper 1.21+, it's designed to be clean, performant, and fully customizable without a single unnecessary line.
✦ Why RandomTeleport?
Unlike bloated alternatives, RandomTeleport focuses on what matters:
- Zero hard dependencies — Vault and LuckPerms are optional, plugin works standalone
- Paper-native performance — Built specifically for Paper's async APIs
- One config file — Everything in config.yml, no mess
- Real-time status display — Players see cooldowns AND daily uses directly in the GUI
- True LuckPerms integration — Native API support with group inheritance resolution
✦ Features
? Core Gameplay
- Interactive GUI — Beautiful inventory menu with world selection. Disabled worlds are hidden from regular players but visible to admins.
- Daily use limits — Limit RTP uses per world per day, with per-group overrides via LuckPerms. Resets at midnight automatically.
- Per-world cooldowns — Each world has its own cooldown configuration with group-based overrides (LuckPerms native support).
- Real-time GUI feedback — Each world button shows cooldown status AND daily use count in the item lore.
- Custom player-head icons — Display player skulls for each world instead of blocks using Paper's native PlayerProfile API.
? Safety & Performance
- Smart location finder — Async multi-threaded search with configurable block blacklist, liquid avoidance, void protection, and chunk pre-loading.
- Countdown system — Configurable countdown before teleportation, cancellable on move, damage, or command.
- Blindness effect — Optional blindness during countdown and post-teleport for immersive transitions.
? Economy & Permissions
- Economy support — Optional Vault integration with per-group pricing and automatic refund on teleport failure.
- LuckPerms-ready — Native LuckPerms API integration with primary group → inherited groups → permission fallback resolution.
- Fine-grained permissions — Per-world access (
rtp.world.<name>), cooldown bypass (rtp.bypass.cooldown.<name>), uses bypass (rtp.bypass.uses), and admin tools.
⚙️ Admin Tools
- Hot reload —
/rtpadmin reload reloads configuration without server restart.
- Usage management — Reset daily counters, clear cooldowns, toggle bypasses.
- Structured logging — Every teleport, failed attempt, economy transaction, and admin action is logged by category.
- Hidden tab-completion —
/rtpadmin is completely invisible to non-admin players.
? Customization
- Effects system — Custom sounds and particles on departure and landing. Title + action bar support.
- Flexible configuration — World icons, GUI layout, filler items, cooldown groups, economy amounts, log categories, and async performance settings.
✦ Commands
| Command |
Description |
/rtp |
Open the world selector GUI |
/rtp [world] |
Teleport directly to a world |
/rtp [player] [world] |
Teleport another player (admin) |
/rtpadmin reload |
Reload the configuration |
/rtpadmin cooldown <player> [world] |
Clear a player's cooldown |
/rtpadmin uses reset <player> |
Reset daily use counters |
/rtpadmin bypass <player> |
Toggle cooldown bypass |
/rtpadmin stats [player] |
View teleport statistics |
✦ Permissions
| Permission |
Description |
rtp.use |
Access to /rtp command |
rtp.world.<name> |
Access to specific world |
rtp.bypass.cooldown |
Bypass all cooldowns |
rtp.bypass.cooldown.<world> |
Bypass cooldown for specific world |
rtp.bypass.uses |
Bypass daily use limits |
rtp.bypass.economy |
Bypass economy costs |
rtp.others |
Teleport other players |
rtp.admin |
Access to all admin commands |
✦ Compatibility
|
|
| Server software |
Paper only |
| Minecraft versions |
1.21.0 — 1.21.4+ (all 1.21.x) |
| Java |
21+ |
| Optional dependencies |
Vault (economy), LuckPerms (permission groups) |
⚠️ Spigot is not supported. This plugin uses Paper-exclusive APIs.
✦ Configuration
Everything is configurable from a single config.yml — world icons (including custom player heads), GUI layout, filler items, sounds, particles, cooldown groups, daily use limits, economy amounts, log categories, async performance settings, and more. No secondary files, no clutter.
Example world configuration:
worlds:
world:
enabled: true
icon: PLAYER_HEAD
head-uuid: "ddb0f735-90ac-44e2-8578-a7dd5a1abfc5"
display-name: "&a&lOverworld"
cooldown:
default-seconds: 300
groups:
admin: 0
vip: 120
default: 300
uses:
default-uses: 5
groups:
admin: 0
vip: 10
default: 5
✦ Quick Start
- Install — Drop
RandomTeleport.jar into your plugins/ folder
- Restart — Start your Paper server (1.21+)
- Configure — Edit
plugins/RandomTeleport/config.yml to your liking
- Reload — Use
/rtpadmin reload to apply changes without restart
- Test — Run
/rtp and explore!
Optional: Install Vault for economy integration and LuckPerms for advanced group-based permissions.
Made with love by valival_
评论 0
登录后参与评分
还没有评论,来抢沙发吧