CappyRTPGUI
CappyRTPGUI 是一款现代化、轻量级且跨平台适配的随机传送菜单插件,专为运行 Minecraft 1.21 及更高版本的 Paper 和 Purpur 服务器打造。它直接集成于 BetterRTP 引擎之上,以针对不同玩家客户端平台量身定制的简洁原生用户界面,取代了传统的基于箱子(Chest)的菜单。
为什么选择 CappyRTPGUI?
传统用于传送的箱子库存 GUI 在现代客户端上往往显得过时且笨拙。CappyRTPGUI 通过利用原生 UI 系统重新设计了随机传送体验:
- 沉浸式客户端对话框: 为现代 Java 版玩家提供使用 Paper Dialog API 构建的现代弹出式对话框屏幕。
- 真正的跨平台支持: 自动检测 Bedrock Edition 玩家并打开响应式的 Bedrock 表单,而不是强制显示虚假的箱子库存。
- 零配置冲突: 依赖 BetterRTP 经过验证的安全传送算法,不会创建重复或冲突的经济规则。
- 安全兼容性回退: 确保通过 ViaVersion 加入的旧版 Java 客户端仍能通过轻量级的库存回退机制平滑使用该插件。
它做什么?
当玩家执行 /rtp 或 /rtpgui 命令时,插件会检查其客户端类型和协议版本,以呈现最合适的界面:
1. 现代 Java 版(Paper Dialog API)
- 渲染一个居中的 3D 旋转方块,对应目的地世界(主世界为草方块,下界为下界岩,末地为末地石)。
- 当玩家在选项之间切换时,动态更新 3D 旋转方块。
- 在对话框体内显示丰富的世界背景信息、传送扫描半径和安全着陆徽章。
2. Bedrock / PE 玩家(Floodgate + Geyser)
- 通过 Floodgate API 自动识别。
- 打开原生的 Bedrock
SimpleForm,包含自定义纹理图标和响应式操作按钮,实现零输入延迟。
3. 旧版 Java 玩家(ViaVersion 回退)
- 来自缺乏 Dialog API 数据包支持的旧版 Minecraft 的玩家将收到标准的 27 格箱子库存,并启用点击保护以防止踢出、数据包丢失或客户端崩溃。
要求与依赖项
在安装之前,请确保您的服务器环境满足以下要求:
命令与权限
/rtp 或 /rtpgui — 为执行命令的玩家打开随机传送菜单。
cappyrtp.use — 使用此命令所需权限。
cappyrtp.world.overworld — 允许选择并传送至主世界。
cappyrtp.world.nether — 允许选择并传送至下界。
cappyrtp.world.end — 允许选择并传送至末地。
安装
- 验证您的服务器正在运行 Paper 1.21+ 且 BetterRTP 处于活动状态。
- 下载最新的
CappyRTPGUI.jar 并将其放入服务器的 plugins/ 目录中。
- 重启服务器以生成配置文件。
- 在
plugins/CappyRTPGUI/config.yml 和 bedrock_gui.yml 中自定义世界名称、文本格式和背景故事。
数据收集与指标披露
本插件使用 bStats 收集匿名服务器统计数据,如 Java 版本、服务器软件和玩家数量。这些数据有助于开发者了解版本采用情况并指导未来的更新。
- 您可以通过在
plugins/bStats/config.yml 中将 enabled: false 随时禁用 bStats 跟踪。
社区与支持
需要帮助设置插件、报告问题或建议新功能吗?
CappyRTPGUI
CappyRTPGUI is a modern, lightweight, and platform-adaptive Random Teleport menu plugin built for Paper and Purpur servers running Minecraft 1.21 and newer. Hooked directly into the BetterRTP engine, it replaces traditional chest-based menus with clean, client-native user interfaces tailored to each player's client platform.
Why Choose CappyRTPGUI?
Traditional chest inventory GUIs for teleportation often feel outdated and clunky on modern clients. CappyRTPGUI redesigns the random teleport experience by leveraging native UI systems:
- Immersive Client Dialogs: Delivers a modern popup dialog screen using the Paper Dialog API for modern Java Edition players.
- True Cross-Platform Support: Automatically detects Bedrock Edition players and opens a responsive Bedrock form instead of forcing a fake chest inventory.
- Zero Configuration Conflicts: Relies on BetterRTP's proven safe-teleportation algorithms without creating duplicate or conflicting economy rules.
- Safe Compatibility Fallback: Ensures older Java clients joining through ViaVersion can still use the plugin smoothly via a lightweight inventory fallback.
What Does It Do?
When a player runs /rtp or /rtpgui, the plugin checks their client type and protocol version to present the most suitable interface:
1. Modern Java Edition (Paper Dialog API)
- Renders a centered 3D rotating block corresponding to the destination world (Grass Block for Overworld, Netherrack for Nether, End Stone for The End).
- Dynamically updates the 3D rotating block when the player toggles between world options.
- Displays rich world lore, teleport scan radius, and safe-landing badges inside the dialog body.
2. Bedrock / PE Players (Floodgate + Geyser)
- Automatically recognized through the Floodgate API.
- Opens a native Bedrock
SimpleForm containing custom texture icons and responsive action buttons with zero input lag.
3. Legacy Java Players (ViaVersion Fallback)
- Players joining from older Minecraft versions that lack Dialog API packet support receive a standard 27-slot chest inventory with click protections enabled to prevent kicks, packet drops, or client crashes.
Requirements & Dependencies
Before installing, make sure your server environment meets the following requirements:
- Server Core: Paper, Purpur, or compatible forks running 1.21+ on Java 21.
- Required Dependency: BetterRTP must be installed and running on your server.
- Optional (Bedrock Support): Floodgate & Geyser.
- Optional (Legacy Client Support): ViaVersion.
Commands & Permissions
/rtp or /rtpgui — Opens the random teleport menu for the executing player.
cappyrtp.use — Required to use the command.
cappyrtp.world.overworld — Allows selecting and teleporting to the Overworld.
cappyrtp.world.nether — Allows selecting and teleporting to the Nether.
cappyrtp.world.end — Allows selecting and teleporting to The End.
Installation
- Verify that your server is running Paper 1.21+ and that BetterRTP is active.
- Download the latest
CappyRTPGUI.jar and place it into your server's plugins/ directory.
- Restart the server to generate the configuration files.
- Customize world names, text formatting, and lore inside
plugins/CappyRTPGUI/config.yml and bedrock_gui.yml.
Data Collection & Metrics Disclosure
This plugin uses bStats to collect anonymous server statistics such as Java version, server software, and player counts. This data helps the developer understand version adoption and guide future updates.
- You can disable bStats tracking at any time by setting
enabled: false in plugins/bStats/config.yml.
Community & Support
Need help setting up the plugin, reporting an issue, or suggesting new features?
- Join our community Discord:
评论 0
登录后参与评分
还没有评论,来抢沙发吧