# \ud83c\udf99\ufe0f PvAddonSorter – A PlasmoVoice Add-On for Minecraft Servers<\/p>\n
**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. \ud83d\ude80<\/p>\n
> 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+**.<\/p>\n
## \ud83c\udf1f Features<\/p>\n
– **Flexible Player Filtering**: Control who can **join** or **stay** on your **team** based on whether they **have PlasmoVoice** installed. \ud83c\udfaf
\n– **Kick Modes**: Choose from **three modes** modes to **enforce** voice chat rules:
\n – **NOBODY**: No restrictions, everyone is allowed. \ud83d\ude0a
\n – **NO-VOICE**: Kicks **players** without **voice chat**. \ud83d\udeaa
\n – **VOICE**: Kicks **players** with **voice chat**. \u26a0\ufe0f
\n– **Teleportation**: **Instantly teleport** players with or **without** voice chat to **your** location for **grouping**. \ud83c\udf0d
\n– **Player Listing**: Display lists of **players** based on their **voice** chat **status**. \ud83d\udccb
\n– **Broadcasting**: Send **targeted** messages to **players** with or **without** voice chat. \ud83d\udce2
\n– **Team Assignment**: Assign **Minecraft** teams based on **voice** chat status. \ud83d\udee1\ufe0f
\n– **Configurable Messages**: Customize all **messages** and **settings** `config.yml`. \ud83d\udcdd
\n– **Permission System**: Restrict **commands** and **bypass** checks with `pvaddsonsorter` permissions. \ud83d\udd12
\n– **Tab Completion**: Smart **command** suggestions for **admins**. \ud83d\udcbb
\n– **Lightweight & Robust**: Easy to **install**, **use**, and **performant** on any **server**. \u26a1<\/p>\n
> 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.<\/p>\n
## \u2699\ufe0f How It Works<\/p>\n
**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:
\n– **Kick** players who **don’t** meet voice chat **criteria**.
\n– **Teleport** players to **an** admin’s location for **events** or **team** separation.
\n– **List** players with or **without** voice chat.
\n– **Broadcast** messages to **specific** groups.
\n– **Assign** players to **Minecraft** teams.
\n– **Bypass** checks for **players** with **permissions**.<\/p>\n
> The `VOICE` mode is **sensitive** to **network** latency. **Adjust** the **check-time-in-seconds** in `config.yml` for **better** reliability on **high-latency** servers.<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Minecraft Server**: Spigot\/Paper **1.20.4 or 1.21+**.
\n– **PlasmoVoice**: Version **2.1.4** or **higher** (required **dependency**).<\/p>\n
## \ud83c\udfae Use Cases<\/p>\n
| Scenario | Command | Result |
\n|————————————-|———————————-|————————————————————————|
\n| **Event** requiring **voice** chat | `\/sorter kick no-voice` | **Kicks** players without **PlasmoVoice** and **prevents** joining. |
\n| **Event** excluding **voice** chat | `\/sorter kick voice` | **Kicks** players with **PlasmoVoice** and **enforces** no **voice** chat. |
\n| **Organize** voice chat users | `\/sorter tp voice` | **Teleports** players with **voice** chat to **the** admin’s location. |
\n| **List** players without **voice** chat | `\/sorter list no-voice` | **Displays** a **list** of **players** without **voice** chat. |
\n| **Announce** to **voice** chat users | `\/sorter broadcast voice Hello!` | **Sends** “Hello!” to **players** with **voice** chat. |
\n| **Assign** players to **teams** | `\/sorter team voice VoiceTeam` | **Assigns** players with **voice** chat to **the** `VoiceTeam` team. |
\n| **Reset** restrictions | `\/sorter kick nobody` | **Disables** voice chat checks, **allowing** everyone to **join**. |<\/p>\n
## \ud83d\udcdc Commands<\/p>\n
**Use** the **main** command `\/sorter` (or **aliases** `\/pvsorter`, `\/pvsort`) to **manage** the **add-on**. Below **are** the **available** subcommands:<\/p>\n
| Command | Description | Permission | **Example Usage**: ## \u2699\ufe0f Configuration<\/p>\n The **plugin** generates a `config.yml` file in `plugins\/pv-addon-sorter\/`. You **can** customize messages, **kick** reasons, and **settings**. Key **options** include:<\/p>\n – `check-time-in-seconds`: Delay **(in seconds)** before **checking** voice chat status (default: 3). Control who can manage or bypass the add-on with these permissions:<\/p>\n | Permission | Description | # \ud83d\udee0\ufe0f Installation<\/p>\n 1. **Download** the **latest** `pv-addon-sorter.jar` from **the** Versions page. # \ud83d\udcdd License # \u26a0\ufe0f Notes & Limitations<\/p>\n * Some features (like `VOICE` mode) may not be fully stable on high-latency servers. # \ud83d\udcca Supported Versions # \ud83d\udc1b Bug Reports & Suggestions # \ud83d\udc96 Credits Thank you for using **PvAddonSorter**! Let’s make voice chat management a breeze. \ud83c\udf89<\/p>\n","protected":false},"excerpt":{"rendered":" Plasmo Voice addon for sorting players.<\/p>\n","protected":false},"featured_media":126699,"template":"","meta":{"_minecraft_slug":"pv-addon-sorter","_minecraft_project_id":"clDoQjRD","_minecraft_author":"Oluni_Official","_minecraft_license":"MIT","_minecraft_downloads":84,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"pv-addon-sorter.zip","_minecraft_size_bytes":12406,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:05:39.570499Z","_minecraft_date_created":"2025-06-11T23:17:08.138944Z","_minecraft_date_modified":"2025-06-04T18:28:57.002535Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/pv-addon-sorter","_minecraft_icon_attachment_id":126699,"_minecraft_imported_at":"2026-06-07T10:44:25+00:00","_minecraft_import_hash":"bccfea54421058a87c9784fc2ddc30ab","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,92],"mod_loader":[132],"minecraft_version":[94,62,37,73,74,38,78],"class_list":["post-126698","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-20-4","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5"],"yoast_head":"\n
\n|——————————————–|—————————————————————————–|————————|
\n| `\/sorter kick
\n| `\/sorter tp
\n| `\/sorter list
\n| `\/sorter broadcast
\n| `\/sorter team
\n| `\/sorter reload` | **Reloads** the **configuration** file. | `pvaddsonsorter.admin` |<\/p>\n
\n– `\/sorter kick no-voice` \u2013 **Kicks** players without **voice** chat and **prevents** joining.
\n– `\/sorter tp voice` \u2013 **Teleports** players with **voice** chat to **you**.
\n– `\/sorter list no-voice` \u2013 **Shows** players without **voice** chat.
\n– `\/sorter broadcast voice Join our Discord!` \u2013 **Sends** “Join our Discord!” to **voice** chat users.
\n– `\/sorter team no-voice NoVoiceTeam` \u2013 **Assigns** players without **voice** chat to `NoVoiceTeam`.
\n– `\/sorter reload` \u2013 **Reloads** `config.yml`.<\/p>\n
\n– **Messages** for **commands** (`kick`, `tp`, `list`, `broadcast`, `team`): Customize **all** in-game messages.
\n– **Kick** reasons for `NO-VOICE` and `VOICE` modes.
\n# \ud83d\udd10 Permissions<\/p>\n
\n|————————|————————————————————————-|
\n| `pvaddonsorter.*` | Grants all add-on permissions (admin + bypass). |
\n| `pvaddonsorter.admin` | Allows execution of all `\/sorter` commands. |
\n| `pvaddonsorter.bypass` | Exempts a player from being kicked by the add-on. |<\/p>\n
\n2. **Place** the `.jar` file in **your** server’s `plugins` folder.
\n3. **Ensure** **PlasmoVoice** is **installed** in **the** `plugins` folder.
\n4. **Start** or **restart** your **server** to **generate** `config.yml`.
\n5. **Configure** `config.yml` in `plugins\/pv-addon-sorter\/` to **customize** messages and **settings**.
\n6. **Use** `\/sorter reload` to **apply** changes without **restarting**.<\/p>\n
\nThis project is licensed under the MIT License. See the LICENSE for details.<\/p>\n
\n* The `VOICE` mode relies on detecting an active UDP connection, which may take a few seconds, potentially causing false positives.
\n* **Always** test the add-on in a controlled environment before using it in a live event.<\/p>\n
\n| Minecraft Version | Status |
\n|——————-|————————————|
\n| **1.20.4 1.21+** | \u2705 Supported |
\n| **Older** | \u274c Not tested |<\/p>\n
\nFound a bug or have an idea to improve **PvAddonSorter**? Open an issue on our GitHub Issues page or message me on discord `oluni_official` ! \ud83d\udde3\ufe0f<\/p>\n
\n* Author: Oluni_Official
\n* Built for: PlasmoVoice
\n* Inspiration: Making Minecraft events more dynamic and organized!<\/p>\n