LibertyVoiceBans ?️?
LibertyVoiceBans 是一款桥接插件,将 LibertyBans 与 Simple Voice Chat 连接起来。当玩家通过 LibertyBans 被禁言时,他们的语音聊天会自动禁用,直到禁言过期或获得赦免前,他们无法在游戏中说话。
✨ 功能
- 实时同步: 在玩家受罚的瞬间立即静音其麦克风。
- 智能自动解除静音: 在后台持续检查临时禁言的过期时间,并无缝恢复语音聊天。
- 双架构支持: 原生支持独立的单机服务器以及大型代理网络(Velocity + Backend)。
- 防垃圾信息警告: 当禁言玩家尝试说话时,向其发送带有冷却保护的自定义聊天消息作为警告。
?️ 工作原理(模式)
LibertyVoiceBans 具备一个智能配置系统,提供两种模式以适应不同的服务器架构。
1. 代理模式(推荐用于网络)
如果您的服务器使用代理(Velocity),并且 LibertyBans 安装在代理服务器上,则适合使用此模式。
- LibertyVoiceBans-Velocity.jar 安装在代理服务器上。它全局监听 LibertyBans 事件。
- LibertyVoiceBans-Bukkit.jar 安装在后端游戏服务器(Paper/Spigot)上。它等待来自 Velocity 的不可见插件消息。
- 优势: 您甚至不需要在后端服务器上安装 LibertyBans。零数据库不同步问题!
2. 独立模式(适用于单服务器)
如果您不使用代理,仅有一个单独的 Paper/Spigot 服务器,则适合使用此模式。
- LibertyVoiceBans-Bukkit.jar 直接钩入同一服务器上的本地 LibertyBans 安装程序。
- 优势: 小服务器的简单即插即用设置。
? 安装与设置
⚙️ 设置 A:代理网络(Velocity + Paper/Bukkit)
- 将
LibertyVoiceBans-Velocity.jar 放入您的 Velocity plugins 文件夹中。
- 将
LibertyVoiceBans-Bukkit.jar 放入您的 后端服务器(Paper/Bukkit)plugins 文件夹中。
- 重启所有服务器。
- 后端服务器会生成一个
config.yml。确保 mode 设置为 'proxy'。
- (可选) 如果您仅在代理上使用它进行惩罚,您可以安全地从后端服务器中删除 LibertyBans。
⚙️ 设置 B:独立服务器(仅限 Paper/Bukkit)
- 确保您的服务器上已安装
LibertyBans 和 Simple Voice Chat。
- 将
LibertyVoiceBans-Bukkit.jar 放入服务器的 plugins 文件夹中。
- 重启服务器。
- 打开
plugins/LibertyVoiceBans/config.yml。
- 将
mode: 'proxy' 更改为 mode: 'standalone'。
- 最后一次重启服务器。
? 配置 (config.yml)
该 Bukkit 插件生成了一个高度可定制的配置文档:
# LibertyVoiceBans - Bukkit 配置
# 选择操作模式:
#
# 'proxy' -> (推荐)惩罚通过 Velocity 插件跟踪。
# 此特定的后端服务器上不需要安装 LibertyBans。
# 'standalone' -> 惩罚通过本地的 LibertyBans 安装进行跟踪。
# 此服务器上严格需要安装 LibertyBans。
mode: 'proxy'
messages:
prefix: '&8[&cLibertyVoice&8] '
muted-warning: '&c由于您在文字聊天中被禁言,因此无法使用语音聊天!'
settings:
# 发送警告消息的冷却时间(秒)。
# 语音聊天每秒发送数百个数据包。这可以防止聊天垃圾信息。
warning-cooldown: 5
翻译者提示
您可以完全翻译 prefix 和 muted-warning 字段。标准 Minecraft 颜色代码(&c、&8 等)完全支持。
? 故障排除
- 玩家在文字聊天中被禁言但仍能在语音聊天中说话:
- 如果使用 代理模式,请确保代理服务器和后端服务器可以通过插件消息通信。
- 如果使用 独立模式,请验证本地 LibertyBans 数据库是否包含有效的惩罚。
- 插件在后端服务器上加载失败:
- 确保已安装
Simple Voice Chat。LibertyVoiceBans 需要 VoiceChat API 才能正常运行。
LibertyVoiceBans ?️?
LibertyVoiceBans is a bridge plugin that connects LibertyBans with Simple Voice Chat. When a player is muted via LibertyBans, their voice chat is automatically disabled, and they cannot speak in-game until their mute expires or is pardoned.
✨ Features
- Real-time Synchronization: Instantly mutes a player's microphone the moment they are punished.
- Smart Auto-Unmute: Continuously checks for temporary mute expirations in the background and restores voice chat seamlessly.
- Dual Architecture Support: Works natively on single standalone servers AND large proxy networks (Velocity + Backend).
- Anti-Spam Warning: Sends a customizable cooldown-protected chat message to muted players when they try to speak.
?️ How It Works (Modes)
LibertyVoiceBans features a smart configuration system with two modes to fit any server architecture.
1. Proxy Mode (Recommended for Networks)
If your server uses a proxy (Velocity) and LibertyBans is installed on the proxy, this mode is for you.
- LibertyVoiceBans-Velocity.jar is installed on the proxy. It listens to LibertyBans events globally.
- LibertyVoiceBans-Bukkit.jar is installed on your backend game servers (Paper/Spigot). It waits for invisible Plugin Messages from Velocity.
- Advantage: You don't even need to install LibertyBans on your backend servers. Zero database desync issues!
2. Standalone Mode (For Single Servers)
If you don't use a proxy and only have a single Paper/Spigot server, this mode is for you.
- LibertyVoiceBans-Bukkit.jar hooks directly into the local LibertyBans installation on the same server.
- Advantage: Simple plug-and-play setup for small servers.
? Installation & Setup
⚙️ Setup A: Proxy Networks (Velocity + Paper/Bukkit)
- Drop
LibertyVoiceBans-Velocity.jar into your Velocity plugins folder.
- Drop
LibertyVoiceBans-Bukkit.jar into your Backend Server (Paper/Bukkit) plugins folder.
- Restart all servers.
- The backend server will generate a
config.yml. Make sure mode is set to 'proxy'.
- (Optional) You can safely delete LibertyBans from your backend servers if you only use it for punishments on the proxy.
⚙️ Setup B: Standalone Servers (Paper/Bukkit Only)
- Ensure both
LibertyBans and Simple Voice Chat are installed on your server.
- Drop
LibertyVoiceBans-Bukkit.jar into your server's plugins folder.
- Restart the server.
- Open
plugins/LibertyVoiceBans/config.yml.
- Change
mode: 'proxy' to mode: 'standalone'.
- Restart the server one last time.
? Configuration (config.yml)
The Bukkit plugin generates a highly customizable config file:
# LibertyVoiceBans - Bukkit Configuration
# Choose the operation mode:
#
# 'proxy' -> (Recommended) Punishments are tracked via the Velocity plugin.
# LibertyBans is NOT required on this specific backend server.
# 'standalone' -> Punishments are tracked via the local LibertyBans installation.
# LibertyBans is STRICTLY REQUIRED on this server.
mode: 'proxy'
messages:
prefix: '&8[&cLibertyVoice&8] '
muted-warning: '&cYou cannot use voice chat because you are muted in text chat!'
settings:
# The cooldown (in seconds) for sending the warning message.
# Voice chat sends hundreds of packets per second. This prevents chat spam.
warning-cooldown: 5
Tips for Translators
You can fully translate the prefix and muted-warning fields. Standard Minecraft color codes (&c, &8, etc.) are fully supported.
? Troubleshooting
- Players are muted in text but can still speak in voice chat:
- If using Proxy Mode, ensure the proxy and backend servers can communicate via Plugin Messaging.
- If using Standalone Mode, verify that the local LibertyBans database contains the active punishment.
- Plugin fails to load on backend server:
- Ensure
Simple Voice Chat is installed. LibertyVoiceBans requires VoiceChat API to function.
评论 0
登录后参与评分
还没有评论,来抢沙发吧