?️ PvAddonSorter - Minecraft 服务器的 PlasmoVoice 附加组件
PvAddonSorter 是一款 Minecraft 服务器插件,也是 PlasmoVoice 的附加组件,旨在根据玩家的语音聊天状态来管理玩家。无论您是主办特殊活动、管理服务器还是组织游戏内容,此附加组件都能让您轻松筛选、踢出、传送、列出、广播消息或为有或没有语音聊天的玩家分配队伍。?
某些功能(如 VOICE 模式)在高延迟服务器上可能无法完全稳定。必须安装 PlasmoVoice 插件!该插件已使用 PlasmoVoice 版本 2.1.4+ 进行了测试。
? 功能特性
- 灵活的玩家筛选:根据玩家是否安装了 PlasmoVoice,控制谁可以加入或留在您的队伍中。?
- 踢出模式:从三种模式中选择以执行语音聊天规则:
- NOBODY(无人):无限制,允许所有人。?
- NO-VOICE(无语音):踢出没有语音聊天的玩家。?
- VOICE(有语音):踢出有语音聊天的玩家。⚠️
- 传送功能:即时传送有或没有语音聊天的玩家到您所在的位置进行分组。?
- 玩家列表:根据玩家的语音聊天状态显示玩家列表。?
- 广播消息:向有或没有语音聊天的玩家发送定向消息。?
- 队伍分配:根据语音聊天状态分配 Minecraft 队伍。?️
- 可配置的消息:自定义所有消息和设置
config.yml。?
- 权限系统:通过
pvaddsonsorter 权限限制命令并绕过检查。?
- Tab 补全:为管理员提供智能命令建议。?
- 轻量且健壮:易于安装、使用,并在任何服务器上保持高性能。⚡
VOICE 模式(踢出有语音聊天的玩家)在ping 值较高或频繁出现连接问题的服务器上可能不稳定,因为玩家可能在稳定之前就显示为已连接。在卡顿的服务器上请谨慎使用。
⚙️ 工作原理
PvAddonSorter 与 PlasmoVoice 集成,在玩家加入时监控其语音聊天状态。它使用延迟检查(默认:3 秒,可配置)以确保通过 UDP 准确检测 PlasmoVoice。根据配置的模式,它可以:
- 踢出不符合语音聊天条件的玩家。
- 传送玩家到管理员位置用于活动或队伍分离。
- 列出有或没有语音聊天的玩家。
- 向特定组广播消息。
- 将玩家分配到 Minecraft 队伍。
- 绕过具有权限的玩家的检查。
VOICE 模式对网络延迟敏感。在 config.yml 中调整 check-time-in-seconds(检查时间秒数),以提高在高延迟服务器上的可靠性。
? 要求
- Minecraft 服务器:Spigot/Paper 1.20.4 或 1.21+。
- PlasmoVoice:版本 2.1.4 或更高(必需依赖项)。
? 使用场景
| 场景 |
命令 |
结果 |
| 需要语音聊天的活动 |
/sorter kick no-voice |
踢出没有 PlasmoVoice 的玩家并阻止其加入。 |
| 排除语音聊天的活动 |
/sorter kick voice |
踢出有 PlasmoVoice 的玩家并强制执行无语音聊天。 |
| 组织语音聊天用户 |
/sorter tp voice |
传送有语音聊天的玩家到管理员所在位置。 |
| 列出没有语音聊天的玩家 |
/sorter list no-voice |
显示没有语音聊天的玩家的列表。 |
| 向语音聊天用户公告 |
/sorter broadcast voice Hello! |
向有语音聊天的玩家发送“Hello!”。 |
| 分配玩家到队伍 |
/sorter team voice VoiceTeam |
将有语音聊天的玩家分配到 VoiceTeam 队伍。 |
| 重置限制 |
/sorter kick nobody |
禁用语音聊天检查,允许所有人加入。 |
? 命令
使用主命令 /sorter(或别名 /pvsorter, /pvsort)来管理此附加组件。以下是可用的子命令:
| 命令 |
描述 |
权限 |
/sorter kick <nobody|no-voice|voice> |
设置踢出模式并踢出不符合条件的玩家。 |
pvaddsonsorter.admin |
/sorter tp <voice|no-voice> |
传送有或没有语音聊天的玩家到您的位置。 |
pvaddsonsorter.admin |
/sorter list <voice|no-voice> |
列出有或没有语音聊天的玩家。 |
pvaddsonsorter.admin |
/sorter broadcast <voice|no-voice> <message> |
向有或没有语音聊天的玩家发送消息。 |
pvaddsonsorter.admin |
/sorter team <voice|no-voice> <team-name> |
将有或没有语音聊天的玩家分配到一个队伍。 |
pvaddsonsorter.admin |
/sorter reload |
重新加载配置文件。 |
pvaddsonsorter.admin |
用法示例:
/sorter kick no-voice – 踢出没有语音聊天的玩家并阻止其加入。
/sorter tp voice – 传送有语音聊天的玩家到你身边。
/sorter list no-voice – 显示没有语音聊天的玩家列表。
/sorter broadcast voice Join our Discord! – 向语音聊天用户发送“Join our Discord!”。
/sorter team no-voice NoVoiceTeam – 将没有语音聊天的玩家分配到 NoVoiceTeam 队伍。
/sorter reload – 重载 config.yml。
⚙️ 配置
该插件会在 plugins/pv-addon-sorter/ 目录下生成一个 config.yml 文件。你可以自定义消息、踢出原因以及设置。主要选项包括:
check-time-in-seconds: 检查语音聊天状态前的延迟时间(以秒为单位)(默认值:3)。
- 命令(
kick、tp、list、broadcast、team)的消息:自定义所有游戏内消息。
NO-VOICE 和 VOICE 模式下的踢出原因。
? 权限
通过以下权限控制谁可以管理或绕过此附加组件:
| 权限 |
描述 |
pvaddonsorter.* |
授予所有附加组件权限(管理员 + 绕过)。 |
pvaddonsorter.admin |
允许执行所有 /sorter 命令。 |
pvaddonsorter.bypass |
使玩家免于被该附加组件踢出。 |
?️ 安装
- 从 Versions 页面下载最新的
pv-addon-sorter.jar。
- 将
.jar 文件放置在服务器的 plugins 文件夹中。
- 确保
plugins 文件夹中已安装 PlasmoVoice。
- 启动或重启服务器以生成
config.yml。
- 配置
plugins/pv-addon-sorter/ 中的 config.yml 以自定义消息和设置。
- 使用
/sorter reload 来应用更改而无需重启服务器。
? 许可证
本项目采用 MIT 许可证。有关详细信息,请参阅 LICENSE 文件。
⚠️ 注意事项与限制
- 某些功能(如
VOICE 模式)在高延迟服务器上可能无法完全稳定运行。
VOICE 模式依赖于检测活跃的 UDP 连接,这可能需要几秒钟,可能会导致误报。
- 在用于正式活动之前,请始终在受控环境中测试此附加组件。
? 支持版本
| Minecraft 版本 |
状态 |
| 1.20.4 1.21+ |
✅ 支持 |
| 旧版本 |
❌ 未测试 |
? Bug 报告与建议
发现了 Bug 或有改进 PvAddonSorter 的想法?在我们的 GitHub Issues 页面上提交问题,或在 Discord 上联系我 oluni_official!?️
? 致谢
- 作者:Oluni_Official
- 专为 PlasmoVoice 打造
- 灵感来源:让 Minecraft 活动更加动态和有序!
感谢使用 PvAddonSorter!让我们让语音聊天管理变得轻松愉快。?
?️ PvAddonSorter - A PlasmoVoice Add-On for Minecraft Servers
PvAddonSorter is a Minecraft server plugin and add-on for PlasmoVoice, designed to manage players based on their voice chat status. Whether you're hosting a special event, moderating a server, or organizing gameplay, this add-on makes it easy to filter, kick, teleport, list, broadcast messages, or assign teams to players with or without voice chat. ?
Some features, like VOICE mode, may not be fully stable on high-latency servers. PlasmoVoice plugin is required! The plugin was tested with PlasmoVoice version 2.1.4+.
? Features
- Flexible Player Filtering: Control who can join or stay on your team based on whether they have PlasmoVoice installed. ?
- Kick Modes: Choose from three modes modes to enforce voice chat rules:
- NOBODY: No restrictions, everyone is allowed. ?
- NO-VOICE: Kicks players without voice chat. ?
- VOICE: Kicks players with voice chat. ⚠️
- Teleportation: Instantly teleport players with or without voice chat to your location for grouping. ?
- Player Listing: Display lists of players based on their voice chat status. ?
- Broadcasting: Send targeted messages to players with or without voice chat. ?
- Team Assignment: Assign Minecraft teams based on voice chat status. ?️
- Configurable Messages: Customize all messages and settings
config.yml. ?
- Permission System: Restrict commands and bypass checks with
pvaddsonsorter permissions. ?
- Tab Completion: Smart command suggestions for admins. ?
- Lightweight & Robust: Easy to install, use, and performant on any server. ⚡
The VOICE mode (kicking players with voice chat) may be unstable be on stable on servers with high ping or frequent connection issues, as players might appear connected before stabilizing. Use with caution on laggy servers.
⚙️ How It Works
PvAddonSorter integrates with PlasmoVoice to monitor players voice chat status upon joining. It uses a delayed check (default: 3 seconds, configurable) to ensure accurate detection of PlasmoVoice via UDP. Based on the configured mode, it can:
- Kick players who don't meet voice chat criteria.
- Teleport players to an admin's location for events or team separation.
- List players with or without voice chat.
- Broadcast messages to specific groups.
- Assign players to Minecraft teams.
- Bypass checks for players with permissions.
The VOICE mode is sensitive to network latency. Adjust the check-time-in-seconds in config.yml for better reliability on high-latency servers.
? Requirements
- Minecraft Server: Spigot/Paper 1.20.4 or 1.21+.
- PlasmoVoice: Version 2.1.4 or higher (required dependency).
? Use Cases
| Scenario |
Command |
Result |
| Event requiring voice chat |
/sorter kick no-voice |
Kicks players without PlasmoVoice and prevents joining. |
| Event excluding voice chat |
/sorter kick voice |
Kicks players with PlasmoVoice and enforces no voice chat. |
| Organize voice chat users |
/sorter tp voice |
Teleports players with voice chat to the admin's location. |
| List players without voice chat |
/sorter list no-voice |
Displays a list of players without voice chat. |
| Announce to voice chat users |
/sorter broadcast voice Hello! |
Sends "Hello!" to players with voice chat. |
| Assign players to teams |
/sorter team voice VoiceTeam |
Assigns players with voice chat to the VoiceTeam team. |
| Reset restrictions |
/sorter kick nobody |
Disables voice chat checks, allowing everyone to join. |
? Commands
Use the main command /sorter (or aliases /pvsorter, /pvsort) to manage the add-on. Below are the available subcommands:
| Command |
Description |
Permission |
/sorter kick <nobody|no-voice|voice> |
Sets kick mode and kicks players who don't meet criteria. |
pvaddsonsorter.admin |
/sorter tp <voice|no-voice> |
Teleports players with or without voice chat to your location. |
pvaddsonsorter.admin |
/sorter list <voice|no-voice> |
Lists players with or without voice chat. |
pvaddsonsorter.admin |
/sorter broadcast <voice|no-voice> <message> |
Sends a message to players with or without voice chat. |
pvaddsonsorter.admin |
/sorter team <voice|no-voice> <team-name> |
Assigns players with or without voice chat to a team. |
pvaddsonsorter.admin |
/sorter reload |
Reloads the configuration file. |
pvaddsonsorter.admin |
Example Usage:
/sorter kick no-voice – Kicks players without voice chat and prevents joining.
/sorter tp voice – Teleports players with voice chat to you.
/sorter list no-voice – Shows players without voice chat.
/sorter broadcast voice Join our Discord! – Sends "Join our Discord!" to voice chat users.
/sorter team no-voice NoVoiceTeam – Assigns players without voice chat to NoVoiceTeam.
/sorter reload – Reloads config.yml.
⚙️ Configuration
The plugin generates a config.yml file in plugins/pv-addon-sorter/. You can customize messages, kick reasons, and settings. Key options include:
check-time-in-seconds: Delay (in seconds) before checking voice chat status (default: 3).
- Messages for commands (
kick, tp, list, broadcast, team): Customize all in-game messages.
- Kick reasons for
NO-VOICE and VOICE modes.
? Permissions
Control who can manage or bypass the add-on with these permissions:
| Permission |
Description |
pvaddonsorter.* |
Grants all add-on permissions (admin + bypass). |
pvaddonsorter.admin |
Allows execution of all /sorter commands. |
pvaddonsorter.bypass |
Exempts a player from being kicked by the add-on. |
?️ Installation
- Download the latest
pv-addon-sorter.jar from the Versions page.
- Place the
.jar file in your server's plugins folder.
- Ensure PlasmoVoice is installed in the
plugins folder.
- Start or restart your server to generate
config.yml.
- Configure
config.yml in plugins/pv-addon-sorter/ to customize messages and settings.
- Use
/sorter reload to apply changes without restarting.
? License
This project is licensed under the MIT License. See the LICENSE for details.
⚠️ Notes & Limitations
- Some features (like
VOICE mode) may not be fully stable on high-latency servers.
- The
VOICE mode relies on detecting an active UDP connection, which may take a few seconds, potentially causing false positives.
- Always test the add-on in a controlled environment before using it in a live event.
? Supported Versions
| Minecraft Version |
Status |
| 1.20.4 1.21+ |
✅ Supported |
| Older |
❌ Not tested |
? Bug Reports & Suggestions
Found a bug or have an idea to improve PvAddonSorter? Open an issue on our GitHub Issues page or message me on discord oluni_official ! ?️
? Credits
- Author: Oluni_Official
- Built for: PlasmoVoice
- Inspiration: Making Minecraft events more dynamic and organized!
Thank you for using PvAddonSorter! Let's make voice chat management a breeze. ?
评论 0
登录后参与评分
还没有评论,来抢沙发吧