? bsruRTP 插件
English ภาษาไทย
一款功能强大且通用的 Spigot/Paper 服务器随机传送(RTP)插件。该插件提供两种截然不同的 RTP 模式:供单人玩家使用的经典基于 GUI 的传送,以及用于群体传送的独特、事件驱动的 ZoneRTP 系统。它高度可配置,专为现代 Minecraft 服务器设计。
✨ 特性
标准 RTP (/rtp)
- 基于 GUI 的传送: 直观的菜单让玩家选择要传送到哪个世界。
- 静止倒计时: 在传送前需要玩家保持静止的短暂倒计时。
- 冷却系统: 防止玩家滥用 RTP 命令。
- 安全位置查找: 高级算法寻找安全的传送点,包括检查以避免下界屋顶和熔岩海洋。
ZoneRTP
- 持久计时器: 创建带有循环倒计时的 RTP 区域,持续运行以创造全服事件。
- 群体传送: 当计时器归零时,区域内所有玩家将被传送到同一个随机位置。
- 区域要求: 配置区域要求玩家站在特定的方块类型上,并在特定的垂直高度内。
- 全局可见性: 使用 PlaceholderAPI 在服务器任何地方显示区域倒计时。
通用特性
- 高度可配置: 自定义 GUI、所有消息、声音、半径和时间。
- 完整的管理员控制: 一套强大的命令来创建、删除和管理所有插件功能。
- 多世界支持: 与原版世界以及由 Multiverse-Core 管理的世界完美配合。
- PlaceholderAPI 支持: 深度集成以显示动态信息。
? 兼容性
- Minecraft 版本:
1.17 - 1.21+
- 服务器软件: Spigot, Paper 及其分支。
?️ 安装
- 从 Releases 页面下载最新的
.jar 文件。
- 将下载的
.jar 文件放入服务器的 /plugins 目录中。
- (可选)安装 PlaceholderAPI 以支持占位符。
- 启动或重启你的服务器。
- 根据需要配置生成的
config.yml 和 zones.yml 文件。
? 命令与权限
| 命令 |
描述 |
权限节点 |
默认值 |
/rtp |
打开随机传送 GUI。 |
bsrurtp.use |
true |
/bsrurtp |
显示插件信息。 |
bsrurtp.admin |
op |
/bsrurtp help |
显示所有插件命令。 |
bsrurtp.admin |
op |
/bsrurtp reload |
重新加载所有插件配置。 |
bsrurtp.reload |
op |
/bsrurtp status |
显示插件当前状态。 |
bsrurtp.status |
op |
/bsrurtp tpzone <zone> |
传送你到区域的中心。 |
bsrurtp.tpzone |
op |
/zonertp create ... |
创建新的 RTP 区域。 |
bsrurtp.admin.zone |
op |
/zonertp remove <zone> |
删除一个 RTP 区域。 |
bsrurtp.admin.zone |
op |
? 占位符 (PlaceholderAPI)
%bsrurtp_zone_secs_<zonename>%
- 显示特定循环 RTP 区域的剩余秒数。
- 示例:
%bsrurtp_zone_secs_spawn-event% 将显示 "spawn-event" 区域的倒计时。
- 如果区域不存在或尚未开始计时,则显示 "N/A"。
⚙️ 配置
插件使用两个主要配置文件:
config.yml
此文件控制标准的 /rtp 命令、全局消息、声音和 ZoneRTP 行为。
# ZoneRTP 中垂直检查的高度(从区域的中心 Y 坐标)。
# 例如,如果设置为 4 且区域的 Y 为 65,它将检查 Y 65 到 69 之间的玩家。
zone-vertical-check-height: 4
# 允许使用 /rtp 的世界。
allowWorlds:
- world
- world_nether
- world_the_end
# 每个世界相对于世界出生点的传送半径。
radius:
world: 2000
world_nether: 2000
world_the_end: 2000
# /rtp 命令的冷却设置。
cooldown:
enabled: true
seconds: 5
message: "&c请等待 {cooldown} 秒后再传送!"
# /rtp GUI 的设置。
gui:
title: "&a选择要 RTP 的世界"
slots:
world: 11
world_nether: 13
world_the_end: 15
icons:
world:
material: GRASS_BLOCK
name: "&aRTP 至主世界"
lore:
- "&7在线人数: %server_online%"
- "&7点击进行随机传送。"
world_nether:
material: NETHERRACK
name: "&cRTP 至下界"
lore:
- "&7点击进行随机传送。"
world_the_end:
material: END_STONE
name: "&dRTP 至末地"
lore:
- "&7点击进行随机传送。"
# 各种操作的声音效果。
sounds:
gui_click: "ui.button.click"
waiting: "entity.enderman.teleport"
teleport: "entity.player.levelup"
fail: "block.note_block.bass"
cancel_on_move: "ENTITY_VILLAGER_NO"
zone_countdown_tick: "BLOCK_NOTE_BLOCK_HAT"
zone_teleport: "ENTITY_ENDERMAN_TELEPORT"
# 所有插件消息。
messages:
no_permission: "&c你没有权限使用此命令。"
reload_success: "&a配置重新加载成功!"
reload_failed: "&c配置重新加载失败!"
world_not_allowed: "&c在此世界中不允许使用 RTP。"
already_in_rtp: "&c你已经在等待传送了。"
world_not_found: "&c找不到该世界。"
teleport_fail: "&c未找到安全位置,请重试。"
teleport_success: "&a已成功传送至 {location}"
rtp_start: "&e将在 {seconds} 秒后传送。请勿移动!"
countdown_actionbar: "&e{seconds}s 后传送..."
rtp_cancel_move: "&c因你移动而取消传送。"
rtp_cancel_world: "&c因你切换世界而取消传送。"
# ZoneRTP 的消息
zone_countdown_title: "&a&lRTP 区域"
zone_countdown_subtitle: "&f将在 &e{seconds} &f秒后传送!"
zone_teleport_success: "&b你已通过 RTP 区域被传送!"
? bsruRTP Plugin
English ภาษาไทย
A powerful and versatile Random Teleport (RTP) plugin for Spigot/Paper servers. This plugin offers two distinct RTP modes: a classic GUI-based teleport for individual players and a unique, event-driven ZoneRTP system for group teleports. It is highly configurable and designed for modern Minecraft servers.
✨ Features
Standard RTP (/rtp)
- GUI-Based Teleport: An intuitive menu for players to select which world to teleport to.
- Stand-Still Countdown: A short countdown requires players to stand still before teleporting.
- Cooldown System: Prevents players from spamming the RTP command.
- Safe Location Finding: Advanced algorithm to find safe teleport spots, including checks to avoid the Nether roof and lava oceans.
ZoneRTP
- Persistent Timers: Create RTP zones with looping countdowns that run continuously, creating server-wide events.
- Group Teleport: All players inside a zone when the timer hits zero are teleported to the same random location.
- Zone Requirements: Configure zones to require players to stand on a specific block type and within a specific vertical height.
- Global Visibility: Use PlaceholderAPI to display zone countdowns anywhere on the server.
General Features
- Highly Configurable: Customize GUI, all messages, sounds, radiuses, and timings.
- Full Admin Control: A robust set of commands to create, remove, and manage all plugin features.
- Multi-World Support: Works perfectly with vanilla worlds and worlds managed by Multiverse-Core.
- PlaceholderAPI Support: Deep integration for displaying dynamic information.
? Compatibility
- Minecraft Version:
1.17 - 1.21+
- Server Software: Spigot, Paper, and their forks.
?️ Installation
- Download the latest
.jar file from the Releases page.
- Place the downloaded
.jar file into your server's /plugins directory.
- (Optional) Install PlaceholderAPI for placeholder support.
- Start or restart your server.
- Configure the generated
config.yml and zones.yml files to your liking.
? Commands & Permissions
| Command |
Description |
Permission Node |
Default |
/rtp |
Opens the Random Teleport GUI. |
bsrurtp.use |
true |
/bsrurtp |
Shows plugin information. |
bsrurtp.admin |
op |
/bsrurtp help |
Shows all plugin commands. |
bsrurtp.admin |
op |
/bsrurtp reload |
Reloads all plugin configs. |
bsrurtp.reload |
op |
/bsrurtp status |
Shows the plugin's current status. |
bsrurtp.status |
op |
/bsrurtp tpzone <zone> |
Teleports you to a zone's center. |
bsrurtp.tpzone |
op |
/zonertp create ... |
Creates a new RTP zone. |
bsrurtp.admin.zone |
op |
/zonertp remove <zone> |
Removes an RTP zone. |
bsrurtp.admin.zone |
op |
? Placeholders (PlaceholderAPI)
%bsrurtp_zone_secs_<zonename>%
- Displays the remaining seconds for a specific looping RTP Zone.
- Example:
%bsrurtp_zone_secs_spawn-event% will show the countdown for the "spawn-event" zone.
- Shows "N/A" if the zone does not exist or has not started its timer.
⚙️ Configuration
The plugin uses two main configuration files:
config.yml
This file controls the standard /rtp command, global messages, sounds, and ZoneRTP behavior.
# Height for the vertical check in ZoneRTP (from the zone's center Y).
# For example, if set to 4 and the zone's Y is 65, it will check for players between Y 65 and 69.
zone-vertical-check-height: 4
# Worlds where /rtp is allowed.
allowWorlds:
- world
- world_nether
- world_the_end
# Teleportation radius from the world's spawn point for each world.
radius:
world: 2000
world_nether: 2000
world_the_end: 2000
# Cooldown settings for the /rtp command.
cooldown:
enabled: true
seconds: 5
message: "&cPlease wait {cooldown} more seconds before teleporting again!"
# Settings for the /rtp GUI.
gui:
title: "&aSelect a World to RTP"
slots:
world: 11
world_nether: 13
world_the_end: 15
icons:
world:
material: GRASS_BLOCK
name: "&aRTP to Overworld"
lore:
- "&7Online: %server_online%"
- "&7Click to randomly teleport."
world_nether:
material: NETHERRACK
name: "&cRTP to Nether"
lore:
- "&7Click to randomly teleport."
world_the_end:
material: END_STONE
name: "&dRTP to The End"
lore:
- "&7Click to randomly teleport."
# Sound effects for various actions.
sounds:
gui_click: "ui.button.click"
waiting: "entity.enderman.teleport"
teleport: "entity.player.levelup"
fail: "block.note_block.bass"
cancel_on_move: "ENTITY_VILLAGER_NO"
zone_countdown_tick: "BLOCK_NOTE_BLOCK_HAT"
zone_teleport: "ENTITY_ENDERMAN_TELEPORT"
# All plugin messages.
messages:
no_permission: "&cYou don't have permission to use this command."
reload_success: "&aConfig reloaded successfully!"
reload_failed: "&cFailed to reload config!"
world_not_allowed: "&cRTP is not allowed in this world."
already_in_rtp: "&cYou are already waiting to teleport."
world_not_found: "&cCould not find this world."
teleport_fail: "&cCould not find a safe location. Please try again."
teleport_success: "&aTeleported successfully to {location}"
rtp_start: "&eTeleporting in {seconds} seconds. Do not move!"
countdown_actionbar: "&eTeleporting in {seconds}s..."
rtp_cancel_move: "&cTeleport canceled because you moved."
rtp_cancel_world: "&cTeleport canceled because you changed worlds."
# Messages for ZoneRTP
zone_countdown_title: "&a&lRTP ZONE"
zone_countdown_subtitle: "&fTeleporting in &e{seconds} &fseconds!"
zone_teleport_success: "&bYou have been teleported by an RTP Zone!"
评论 0
登录后参与评分
还没有评论,来抢沙发吧