Smart-rtp

插件

· 作者 Valival

Paper 最可配置的 RTP 插件

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

最新 2.0.0 · 1.21.11 · Paper

一键开服(送7天)

? 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

✦ 快速入门

  1. 安装 — 将 RandomTeleport.jar 放入你的 plugins/ 文件夹
  2. 重启 — 启动你的 Paper 服务器 (1.21+)
  3. 配置 — 根据需要编辑 plugins/RandomTeleport/config.yml
  4. 重载 — 使用 /rtpadmin reload 应用更改而无需重启服务器
  5. 测试 — 运行 /rtp 并开始探索!

可选: 安装 Vault 以启用经济集成,安装 LuckPerms 以获得基于组的进阶权限控制。


由 valival_ 用心制作

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源