RTP-DonutSMP
RTP-DonutSMP 是一个 Paper 插件,提供基于 GUI 的随机传送系统,支持按世界设置并具备安全默认值。玩家使用 /rtp 打开菜单,选择目标世界,即可被传送到该世界配置半径内的安全随机位置。
它专为希望拥有整洁、可配置的随机传送流程的服务端所有者设计,支持布局文件、自定义消息以及实时管理命令。
为什么选择 RTP-DonutSMP
- 带有简单槽位布局文件的 GUI 世界选择器
- 针对每个世界的中心点、半径、冷却时间、价格、图标和描述进行控制
- 全局热等待(Warmup)机制,包含动作栏倒计时及移动取消功能
- 安全位置搜索(避开水域、岩浆和树叶)
- 支持通过 Vault 经济系统进行随机传送收费
- 支持无需重启服务器即可更新设置的管理命令
- 兼容 LuckPerms 权限节点
功能特性
- 支持在菜单中添加超过 3 个世界
- 动作栏显示热等待倒计时(可配置)
- 玩家移动时取消传送
- 安全位置搜索,支持可配置的尝试次数限制
- 全局玩家级冷却时间
- 支持用于半径、价格、冷却时间和中心点的描述占位符
命令
- /rtp
- /rtp reload
- /rtp set <center|radius|cooldown|price> <world> <value>
- /rtp set warmup <seconds>
权限
- rtpdonutsmp.use
- rtpdonutsmp.admin
配置文件结构
该插件使用两个文件:
- config.yml 用于设置、消息和世界定义
- menu.yml 用于菜单大小、标题以及槽位到世界的布局映射
示例世界设置:
settings:
max-tries: 20
global-cooldown: true
warmup-seconds: 5
worlds:
world:
enabled: true
display-name: "&aOverworld"
icon: GRASS_BLOCK
center:
x: 0.0
y: 64.0
z: 0.0
radius: 5000
cooldown: 300
price: 0.0
lore:
- "&7Radius: &f{radius}"
- "&7Price: &f{price}"
- "&7Cooldown: &f{cooldown}s"
示例菜单布局(通过添加更多槽位来增加更多世界):
menu:
size: 27
title: "&6RTP Worlds"
layout:
"11": "world"
"13": "world_nether"
"15": "world_the_end"
"20": "mining_world"
消息
所有面向用户的文本均可在 config.yml 下的 messages 部分进行编辑,包括:
- no-permission
- player-only
- world-not-found
- cooldown
- warmup-actionbar
- warmup-cancelled
- teleport-success
- teleport-failed
兼容性
- 服务端软件:Paper
- Minecraft API 目标版本:1.21.x
- Java:21
安装
- 构建或下载发布的 jar 文件。
- 将其放入服务器的 plugins 文件夹中。
- 启动服务器一次以生成配置文件。
- 编辑 config.yml 和 menu.yml。
- 运行 /rtp reload。
RTP-DonutSMP
RTP-DonutSMP is a Paper plugin that adds a GUI-based random teleport system with per-world settings and safe defaults. Players use /rtp to open a menu, pick a world, and get teleported to a safe random location inside that world's configured radius.
It is built for server owners who want a clean, configurable RTP flow with a layout file, editable messages, and live admin commands.
Why RTP-DonutSMP
- GUI world selector with a simple slot layout file
- Per-world control of center, radius, cooldown, price, icon, and lore
- Global warmup with action bar countdown and cancel-on-move
- Safe location search (avoids water, lava, leaves)
- Vault economy support for RTP pricing
- Admin commands to update settings without restarts
- LuckPerms-friendly permission nodes
Features
- Supports more than 3 worlds in the menu
- Warmup countdown in the action bar (configurable)
- Cancel teleport if the player moves
- Safe location search with configurable attempt limit
- Global per-player cooldown
- Lore placeholders for radius, price, cooldown, and center
Commands
- /rtp
- /rtp reload
- /rtp set <center|radius|cooldown|price> <world> <value>
- /rtp set warmup <seconds>
Permissions
- rtpdonutsmp.use
- rtpdonutsmp.admin
Config Structure
The plugin uses two files:
- config.yml for settings, messages, and world definitions
- menu.yml for menu size, title, and slot -> world layout
Example world settings:
settings:
max-tries: 20
global-cooldown: true
warmup-seconds: 5
worlds:
world:
enabled: true
display-name: "&aOverworld"
icon: GRASS_BLOCK
center:
x: 0.0
y: 64.0
z: 0.0
radius: 5000
cooldown: 300
price: 0.0
lore:
- "&7Radius: &f{radius}"
- "&7Price: &f{price}"
- "&7Cooldown: &f{cooldown}s"
Example menu layout (add more worlds by adding more slots):
menu:
size: 27
title: "&6RTP Worlds"
layout:
"11": "world"
"13": "world_nether"
"15": "world_the_end"
"20": "mining_world"
Messages
All user-facing text is editable in config.yml under messages, including:
- no-permission
- player-only
- world-not-found
- cooldown
- warmup-actionbar
- warmup-cancelled
- teleport-success
- teleport-failed
Compatibility
- Server software: Paper
- Minecraft API target: 1.21.x
- Java: 21
Install
- Build or download the release jar.
- Place it in your server plugins folder.
- Start the server once to generate config files.
- Edit config.yml and menu.yml.
- Run /rtp reload.
评论 0
登录后参与评分
还没有评论,来抢沙发吧