zbRTPQueue
为 Paper 服务器提供随机传送 1v1 决斗匹配。
将随机传送转化为竞技 PvP。zbRTPQueue 是一个可配置的匹配和决斗插件,允许玩家加入特定世界的队列,与其他玩家配对,并传送到安全的随机位置进行自动化的 1v1 战斗。
无需手动匹配。无需自己寻找对手。只需加入队列,获得匹配,然后开始战斗。
✨ 功能
- ? 1v1 匹配 — 自动从同一世界队列中配对两名玩家进行决斗。
- ? 多世界支持 — 为不同的世界配置单独的队列,包括主世界、下界、末地或自定义世界。
- ? 世界选择 GUI — 一个可配置的库存菜单,让玩家选择他们偏好的决斗世界。
- ? 随机安全传送 — 在可配置的出生点范围内找到合适的位置,并将对手放置在设定的距离之外,面对面站立。
- ⚔️ 自动化决斗 — 在战斗前暂时冻结玩家,防止在倒计时期间移动、攻击、使用物品或受到伤害。
- ⏱️ 可配置倒计时 — 自定义匹配传送倒计时和战斗前的倒计时。
- ? 决斗结果 — 自动检测胜利、失败和平局。首次死亡即结束决斗,战斗中断开连接计为失败。
- ⌛ 决斗时间限制 — 设置最大战斗时长,或完全禁用该限制。
- ? 队列广播 — 向全球公告等待中的玩家,或仅向相关队列中的玩家公告,并支持可配置的防刷屏冷却时间。
- ? 丰富通知 — 自定义聊天消息、标题、副标题、动作栏以及加入通知。
- ? 音效 — 配置队列操作、传送、倒计时、战斗和决斗结果的音效。
- ⚙️ 广泛配置 — 自定义世界条目、显示名称、GUI 材质、队列行为、传送范围、决斗设置、消息等。
- ? 配置重载 — 在游戏中重载插件配置,无需手动重启服务器。
? 命令
| 命令 |
描述 |
/rtpqueue |
打开世界选择菜单并加入队列 |
/rtpqueueleave |
离开当前队列 |
/rtpqueuereload |
重载插件配置 |
别名
/rtpq — /rtpqueue 的别名
/rtpqleave 和 /leavequeue — /rtpqueueleave 的别名
? 权限
| 权限 |
默认值 |
描述 |
zbrtpqueue.use |
所有人 |
加入和离开队列 |
zbrtpqueue.admin |
管理员 |
重载配置 |
?️ 配置
插件包含一个可自定义的 config.yml,其中包含以下设置:
- 世界: 启用或禁用世界,配置 GUI 条目,并设置传送中心和最小/最大出生距离。
- 队列: 设置匹配倒计时,并确定当玩家离开时倒计时的行为方式。
- 传送: 配置查找合适传送位置的尝试次数。
- 决斗: 设置对手距离、战斗倒计时、时间限制和结果通知。
- 消息: 自定义插件消息、占位符和格式。
- 广播: 配置公告范围、冷却时间和消息模板。
- GUI、标题、动作栏与音效: 个性化玩家体验。
文本自定义同时支持传统颜色代码(&a, &l, &#RRGGBB)和 MiniMessage 格式。
? 安装
- 下载
zbRTPQueue JAR 文件。
- 将其放入服务器的
plugins 文件夹中。
- 启动或重启你的 Paper 服务器。
- 打开
plugins/zbRTPQueue/config.yml 并配置你想要使用的世界。
- 调整传送范围、决斗设置、消息和其他选项以适合你的服务器。
- 确保已配置的世界已加载并可访问,然后使用
/rtpqueue 开始匹配。
提示: 自定义你的世界中心和出生点范围,以确保决斗在你预期的 PvP 区域内进行。
? 兼容性
- 平台: Paper
- Minecraft API 版本: 1.21
- 插件版本: 1.0.0
在生产服务器部署之前,请在目标 Minecraft 和 Paper 版本上测试该插件。
?? 致谢
开发者: nis
组织: Zarbunex Private Limited
许可证: CC BY-NC-ND 4.0
重新分发和使用须遵守项目许可证的条款。
排队。传送。战斗。
zbRTPQueue — 让随机传送 1v1 决斗变得简单。
zbRTPQueue
Random-teleport 1v1 duel matchmaking for Paper servers.
Turn random teleportation into competitive PvP. zbRTPQueue is a configurable matchmaking and duel plugin that lets players join world-specific queues, get paired with another player, and teleport to safe random locations for an automated 1v1 fight.
No manual matchmaking. No need to find an opponent yourself. Just join a queue, get matched, and fight.
✨ Features
- ? 1v1 Matchmaking — Automatically pairs two players from the same world queue for a duel.
- ? Multi-World Support — Configure separate queues for different worlds, including the Overworld, Nether, End, or custom worlds.
- ? World Selection GUI — A configurable inventory menu lets players choose their preferred duel world.
- ? Random Safe Teleportation — Finds suitable locations within configurable spawn ranges and places opponents a set distance apart, facing each other.
- ⚔️ Automated Duels — Players are temporarily frozen before the fight, preventing movement, attacks, item usage, and damage during the countdown.
- ⏱️ Configurable Countdown — Customize the matchmaking teleport countdown and the pre-fight countdown.
- ? Duel Results — Automatically detects wins, losses, and draws. The first death ends the duel, and disconnecting during a fight counts as a loss.
- ⌛ Duel Time Limit — Set a maximum fight duration or disable the limit entirely.
- ? Queue Broadcasts — Announce waiting players globally or only to players in the relevant queue, with configurable anti-spam cooldowns.
- ? Rich Notifications — Customize chat messages, titles, subtitles, action bars, and join notifications.
- ? Sound Effects — Configure sounds for queue actions, teleportation, countdowns, fights, and duel results.
- ⚙️ Extensive Configuration — Customize world entries, display names, GUI materials, queue behavior, teleport ranges, duel settings, messages, and more.
- ? Configuration Reload — Reload the plugin configuration in-game without manually restarting the server.
? Commands
| Command |
Description |
/rtpqueue |
Open the world-selection menu and join a queue |
/rtpqueueleave |
Leave your current queue |
/rtpqueuereload |
Reload the plugin configuration |
Aliases
/rtpq — Alias for /rtpqueue
/rtpqleave and /leavequeue — Aliases for /rtpqueueleave
? Permissions
| Permission |
Default |
Description |
zbrtpqueue.use |
Everyone |
Join and leave queues |
zbrtpqueue.admin |
Operators |
Reload the configuration |
?️ Configuration
The plugin includes a customizable config.yml with settings for:
- Worlds: Enable or disable worlds, configure GUI entries, and set teleport centers and minimum/maximum spawn distances.
- Queues: Set matchmaking countdowns and determine how countdowns behave when a player leaves.
- Teleportation: Configure the number of attempts to find suitable teleport locations.
- Duels: Set opponent distance, fight countdown, time limit, and result notifications.
- Messages: Customize plugin messages, placeholders, and formatting.
- Broadcasts: Configure announcement scope, cooldowns, and message templates.
- GUI, Titles, Action Bars & Sounds: Personalize the player experience.
Both legacy color codes (&a, &l, &#RRGGBB) and MiniMessage formatting are supported for text customization.
? Installation
- Download the
zbRTPQueue JAR.
- Place it in your server's
plugins folder.
- Start or restart your Paper server.
- Open
plugins/zbRTPQueue/config.yml and configure the worlds you want to use.
- Adjust the teleport ranges, duel settings, messages, and other options to suit your server.
- Ensure your configured worlds are loaded and available, then use
/rtpqueue to start matchmaking.
Tip: Customize your world centers and spawn ranges to keep duels within your intended PvP areas.
? Compatibility
- Platform: Paper
- Minecraft API version: 1.21
- Plugin version: 1.0.0
Test the plugin on your target Minecraft and Paper version before deploying it to a production server.
?? Credits
Developed by: nis
Organization: Zarbunex Private Limited
License: CC BY-NC-ND 4.0
Redistribution and use are subject to the terms of the project's license.
Queue up. Get teleported. Fight.
zbRTPQueue — Random-teleport 1v1 duels, made simple.
评论 0
登录后参与评分
还没有评论,来抢沙发吧