将 Simple Voice Chat 的语音组锁定在白名单内。任何不在你列表中的组都会被自动清理,而任何试图创建自定义组的玩家都会被立即踢出并收到警告。
不再让随机的语音组杂乱无章地占据你的服务器。由你来决定哪些组存在,其余的一切都将被清除。


✨ 特性
- 基于白名单的清理:任何不在你列表中的 Simple Voice Chat 语音组都会按定时器被移除。
- 即时防创建保护:当玩家创建了不被允许的组时,他们会被立即踢出该组,看到操作栏警告,听到提示音,并且会执行你配置的任何额外命令。
- 完全可定制的响应机制:没有任何硬编码内容。运行哪些命令、播放什么声音、玩家看到什么文本:所有设置均在
config.yml中完成。 /vgclean管理员命令:在游戏内重载、列出、手动清理和管理白名单。- 占位符:支持
%player%、%displayname%、%group%、%count%、%flags%,可用于命令和消息中。

? 支持的平台
本插件基于 Paper API 编译,并在 Minecraft 版本号范围内保持向后兼容:因此一个 jar 包即可覆盖以下所有平台,从 1.20 到最新版本:
点击上方的加载器链接可直接跳转到对应的版本列表。
没有 Quilt/Fabric 构建版:Quilt 是一个模组加载器而非插件加载器,且本插件无法在没有 Cardboard 等 Bukkit 兼容层的情况下在其上运行,此处不提供官方支持。

? 安装
- 首先在服务器上安装 Simple Voice Chat:这是硬性依赖项。
- 将
VoiceGroupCleaner-<version>.jar放入你的plugins/文件夹中。 - 重启服务器,然后根据需要编辑
plugins/VoiceGroupCleaner/config.yml。 - 运行
/vgclean reload以应用更改而无需再次重启。

⚙️ 命令
所有子命令均需权限:vgclean.reload (默认:op)
| 命令 | 描述 |
|---|---|
/vgclean reload |
重载 config.yml 并重置清理计时器。 |
/vgclean list |
列出所有 Simple Voice Chat 语音组及其状态(保留、可移除、受保护或自动管理)。 |
/vgclean clean |
立即执行一次清理,无需等待计时器触发。 |
/vgclean keep <name> |
将组名添加到 allowed-groups 并保存。 |
/vgclean remove <name> |
从 allowed-groups 中移除组名并保存。 |

✅ 如何将组加入白名单
有两种方法可以将组添加到白名单:
选项 1:游戏内命令(推荐,无需重启和重载)
/vgclean keep <group-name>
这会将 <group-name> 直接添加到 config.yml 中的 allowed-groups 列表中并立即保存文件:该组从此受到保护。
选项 2:直接编辑 config.yml
allowed-groups:
- "Squad Alpha"
- "Staff Chat"
- "Building Team"
在 allowed-groups 下方作为新行添加确切的组名(区分大小写,必须与 Simple Voice Chat 中的组名匹配),保存文件,然后运行 /vgclean reload 以应用更改。
若要将其从列表中移除,请使用 /vgclean remove <group-name> 或删除其所在行并重新加载。
任何未在此列表中的组都会在下一个计时器轮询时被清理(或者如果你运行 /vgclean clean 则立即清理)。

?️ 配置参考
| 键 | 作用 |
|---|---|
check-interval |
清理扫描运行的频率(以刻为单位,20 = 1 秒)。 |
debug |
当设为 true 时,记录插件执行的每一个操作。 |
ignore-password-protected |
当设为 true 时,受密码保护的群组永远不会被自动移除。 |
allowed-groups |
允许玩家所在的唯一组名列表。其他所有群组都将被视为清理目标。 |
group-create-guard.enabled |
开启或关闭创建即踢出的行为。 |
group-create-guard.delay-ticks |
对不允许的群组采取行动前的延迟时间(以刻为单位)。 |
group-create-guard.commands |
当玩家被踢出时,以该玩家身份运行的一系列命令。可以添加任意数量,每行一个。 |
group-create-guard.sound / sound-volume / sound-pitch |
玩家被踢出时播放给该玩家的音效。任何 Bukkit Sound 名称均可使用。 |
messages.* |
所有面向玩家的字符串,支持 & 颜色编码。 |
group-create-guard.commands 示例:
group-create-guard:
commands:
- "voicechat leave"
- "playsound minecraft:block.anvil.land player %player% ~ ~ ~ 1 1"
- "tell %player% &7此处不允许自定义语音群组。"
每个选项的完整说明请参阅下方链接中的文档。

? 链接

Keeps Simple Voice Chat groups locked to an allow-list. Any group not on your list gets cleaned up automatically, and anyone who tries to make their own custom group gets bounced straight back out: instantly, with a warning.
No more random voice groups cluttering your server. You decide which groups exist, everything else gets swept away.


✨ Features
- Allow-list based cleanup: any Simple Voice Chat group not on your list is removed on a timer.
- Instant group-create guard: the moment a player creates a disallowed group, they're kicked out of it, see an actionbar warning, hear a sound, and any extra commands you've configured run for them.
- Fully configurable reaction: nothing is hardcoded. Which commands run, what sound plays, what text the player sees: all set in
config.yml. /vgcleanadmin command: reload, list, manually clean, and manage the allow-list in-game.- Placeholders:
%player%,%displayname%,%group%,%count%,%flags%across commands and messages.

? Supported Platforms
Compiled against the Paper API, which stays backwards compatible within a Minecraft version line: so one jar covers all of these, from 1.20 through the latest release:
Click a loader above to jump straight to the matching version list.
There is no Quilt/Fabric build: Quilt is a mod loader, not a plugin loader, and this plugin can't run on it without a Bukkit-compatibility layer like Cardboard, which isn't officially supported here.

? Installation
- Install Simple Voice Chat on your server first: it's a hard dependency.
- Drop
VoiceGroupCleaner-<version>.jarinto yourplugins/folder. - Restart the server, then edit
plugins/VoiceGroupCleaner/config.ymlto your liking. - Run
/vgclean reloadto apply changes without a restart.

⚙️ Commands
Permission required for all subcommands: vgclean.reload (default: op)
| Command | Description |
|---|---|
/vgclean reload |
Reloads config.yml and restarts the cleanup timer. |
/vgclean list |
Lists every Simple Voice Chat group and whether it's kept, removable, protected, or auto-managed. |
/vgclean clean |
Runs a cleanup pass immediately instead of waiting for the timer. |
/vgclean keep <name> |
Adds a group name to allowed-groups and saves it. |
/vgclean remove <name> |
Removes a group name from allowed-groups and saves it. |

✅ How to Allow-List a Group
There are two ways to add a group to the allow-list:
Option 1: In-game command (recommended, no restart and reload needed)
/vgclean keep <group-name>
This adds <group-name> straight into allowed-groups in config.yml and saves the file immediately: the group is protected from that point on.
Option 2: Edit config.yml directly
allowed-groups:
- "Squad Alpha"
- "Staff Chat"
- "Building Team"
Add the exact group name (case-sensitive, must match the Simple Voice Chat group name) as a new line under allowed-groups, save the file, then run /vgclean reload to apply it.
To remove a group from the list instead, use /vgclean remove <group-name> or delete its line from config.yml and reload.
Any group not on this list is fair game for cleanup on the next timer sweep (or immediately if you run /vgclean clean).

?️ Configuration Reference
| Key | What it does |
|---|---|
check-interval |
How often (in ticks, 20 = 1 second) the cleanup sweep runs. |
debug |
Logs every action the plugin takes when true. |
ignore-password-protected |
Password-protected groups are never auto-removed when true. |
allowed-groups |
The only group names players are allowed to be in. Everything else is fair game for cleanup. |
group-create-guard.enabled |
Turns the instant kick-on-create behavior on/off. |
group-create-guard.delay-ticks |
Delay before acting on a disallowed group. |
group-create-guard.commands |
List of commands run as the player when they get kicked. Add as many as you like, one per line. |
group-create-guard.sound / sound-volume / sound-pitch |
The sound played on the player when they're kicked. Any Bukkit Sound name works. |
messages.* |
Every player-facing string, &-color-coded. |
Example group-create-guard.commands:
group-create-guard:
commands:
- "voicechat leave"
- "playsound minecraft:block.anvil.land player %player% ~ ~ ~ 1 1"
- "tell %player% &7Custom voice groups aren't allowed here."
Full breakdown of every option lives in the docs linked below.

? Links

下载 VoiceGroupCleaner
下载 VoiceGroupCleaner
下载 VoiceGroupCleaner
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VoiceGroupCleaner
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VoiceGroupCleaner
下载 VoiceGroupCleaner
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VoiceGroupCleaner
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VoiceGroupCleaner
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VoiceGroupCleaner
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VoiceGroupCleaner
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
VoiceGroupCleaner 1.2.0
支持 Paper、Purpur、Spigot、Bukkit 和 Folia,适用于 Minecraft 1.20.1 至 26.2。
group-create-guard.command(单个字符串)已替换为group-create-guard.commands(列表):允许添加任意数量的额外命令(可用),当玩家因被禁止加入群组而被踢出时,这些命令将以该玩家的身份执行(:- 新增
%displayname%占位符,与%player%并列使用。- Actionbar 踢出消息不再带有固定的前缀/图标:仅保留纯彩色文本。
config.yml现在直接链接到完整文档。- 作者已从我的游戏用户名("jjjotby")更改为 1amir2026。
“需要安装 Simple Voice Chat。”
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。

评论 0
登录后参与评分
还没有评论,来抢沙发吧