Sakura Random Teleport
由 SakuraZ 开发的配置化随机传送插件,提供可选的图形界面(GUI)、直接传送指令、安全位置检查以及持久化的冷却时间。
功能特性
- 可选 GUI: 使用世界选择菜单或仅命令模式。
- 三个目的地: 主世界、下界和末地。
- 可配置区域: 自定义世界名称、区域宽度和中心坐标。
- 安全位置检查: 检查地形、头部空间、危险源和世界边界。
- 异步区块加载: 异步加载目的地的区块。
- 自定义倒计时: 配置传送延迟、动作栏消息和音效。
- 即时模式: 设置
cooldown-seconds: 0 将禁用冷却时间并跳过倒计时。安全位置检查仍然生效。
- 持久化冷却: 冷却时间在重新连接服务器和重启后依然保留。
- 移动处理: 在同一方块内移动不会取消 RTP。跨越 X 或 Z 方向的方块边界则会取消。
- 隐藏坐标: 默认成功消息仅显示目的地名称。
指令
| 指令 |
描述 |
/rtp |
打开 GUI,或在 GUI 禁用时显示指令用法 |
/rtp overworld |
传送到配置的主世界 |
/rtp nether |
传送到配置的下界 |
/rtp the end |
传送到配置的末地 |
/rtp reload |
在游戏中重载配置;需要管理员权限 |
别名:/randomteleport
直接目的地指令在 GUI 模式和仅命令模式下均有效。
配置
启用世界选择 GUI:
rtp-gui: true
禁用 GUI 并使用目的地指令:
rtp-gui: false
默认传送计时设置:
countdown-seconds: 5
cooldown-seconds: 60
设置 countdown-seconds: 0 可在保留冷却时间的同时跳过倒计时。
设置 cooldown-seconds: 0 可禁用冷却时间并跳过倒计时。
在游戏中使用 /rtp reload 应用配置更改。缺少 rtp-gui 项的现有配置将保持 GUI 模式启用状态。
权限
| 权限节点 |
默认值 |
randomteleportplugin.use |
所有人 |
randomteleportplugin.admin |
操作员 (Operators) |
安装方法
- 停止服务器。
- 将插件 JAR 文件放入
plugins 文件夹。
- 启动服务器。
- 编辑
plugins/RandomTeleportPlugin/config.yml。
- 在游戏中运行
/rtp reload。
更新时,请替换之前的 JAR 文件。请勿保留多个版本同时安装。
兼容性
专为 Paper 和 Purpur 1.21–26.2 设计,使用单个插件 JAR 文件。
- Minecraft 1.21.x: Java 21。
- Minecraft 26.x: Java 25。
- Bukkit, Spigot, and Folia: 不支持。
版本 1.1.0 已在 14 个 Paper 版本和 13 个 Purpur 版本上通过了服务端兼容性测试。
版本 1.1.2 已通过构建和命令解析/配置测试。本次发布未重复进行完整的服务器版本兼容性矩阵测试。
地形检查可减少不安全着陆的情况,但无法保证免受怪物、陷阱或后续世界变化的影响。
由 SakuraZ 制作
Sakura Random Teleport
A configurable random teleport plugin by SakuraZ, featuring an optional GUI, direct teleport commands, safe-location checks, and persistent cooldowns.
Features
- Optional GUI: use a world-selection menu or command-only mode.
- Three destinations: Overworld, Nether, and The End.
- Configurable areas: customize world names, area widths, and center coordinates.
- Safe-location checks: check terrain, headroom, hazards, and world borders.
- Asynchronous chunk loading: load destination chunks asynchronously.
- Custom countdown: configure teleport delays, Actionbar messages, and sounds.
- Instant mode: setting
cooldown-seconds: 0 disables cooldowns and skips the countdown. Safe-location checks still apply.
- Persistent cooldowns: cooldowns survive reconnects and server restarts.
- Movement handling: moving within the same block does not cancel RTP. Crossing an X or Z block boundary cancels it.
- Hidden coordinates: the default success message displays only the destination name.
Commands
| Command |
Description |
/rtp |
Opens the GUI, or shows command usage when the GUI is disabled |
/rtp overworld |
Teleports to the configured Overworld |
/rtp nether |
Teleports to the configured Nether |
/rtp the end |
Teleports to the configured End |
/rtp reload |
Reloads configuration in-game; requires admin permission |
Alias: /randomteleport
Direct destination commands work in both GUI and command-only modes.
Configuration
Enable the world-selection GUI:
rtp-gui: true
Disable the GUI and use destination commands:
rtp-gui: false
Default teleport timings:
countdown-seconds: 5
cooldown-seconds: 60
Set countdown-seconds: 0 to skip the countdown while keeping cooldowns.
Set cooldown-seconds: 0 to disable cooldowns and skip the countdown.
Apply configuration changes using /rtp reload in-game. Existing configurations without rtp-gui keep GUI mode enabled.
Permissions
| Permission |
Default |
randomteleportplugin.use |
Everyone |
randomteleportplugin.admin |
Operators |
Installation
- Stop your server.
- Place the plugin JAR in the
plugins folder.
- Start the server.
- Edit
plugins/RandomTeleportPlugin/config.yml.
- Run
/rtp reload in-game.
When updating, replace the previous JAR. Do not keep multiple versions installed.
Compatibility
Designed for Paper and Purpur 1.21–26.2, using one plugin JAR.
- Minecraft 1.21.x: Java 21.
- Minecraft 26.x: Java 25.
- Bukkit, Spigot, and Folia: not supported.
Version 1.1.0 passed server-side compatibility checks on 14 Paper releases and 13 Purpur releases.
Version 1.1.2 passes build and command-parsing/configuration tests. The full server-version compatibility matrix has not been repeated for this release.
Terrain checks reduce unsafe landings but cannot guarantee protection from mobs, traps, or later world changes.
Created by SakuraZ
评论 0
登录后参与评分
还没有评论,来抢沙发吧