HelpVoice

🎤 HELPVOICE — Automatic Voice Chat Configuration

---

📋 OVERVIEW

HelpVoice is a lightweight and intelligent companion plugin designed specifically for Simple Voice Chat, completely automating the complex and often frustrating process of port configuration for your Minecraft server. Instead of manually editing configuration files, guessing which ports are available, or dealing with cryptic errors when the default port is already occupied, HelpVoice handles everything automatically in the background.

---

✨ KEY FEATURES

🔌 ZERO-CONFIGURATION SETUP

Simply install this plugin alongside Simple Voice Chat, restart your server, and HelpVoice will immediately begin scanning for an available port, starting with the default 24454, then checking through a customizable list of alternative ports, and finally probing random ports within the 24000 to 26000 range if necessary, with a configurable maximum number of attempts to ensure it finds a working port without endless looping.

💾 SAFE CONFIGURATION MANAGEMENT

Once a free port is successfully discovered, HelpVoice intelligently reads your existing `voicechat.yml` file, or creates a new one with sensible defaults if it doesn't exist, then sets the port value correctly, ensures other essential fields like host and max_voice_distance are properly configured, and saves the file with perfect YAML formatting, while also creating a timestamped backup of your original configuration to prevent any accidental data loss.

🌐 BILINGUAL INTERFACE

After configuration, admins receive clear confirmation messages about which port was selected, and the plugin includes a fully bilingual interface with both English and Russian translations for all messages, errors, status updates, and commands, making it accessible to a wide range of server administrators worldwide.

---

🛠️ ADMIN COMMANDS

| Command | Description | Permission | |---------|-------------|------------| | `/helpvoice status` | View current port and VoiceChat status | `helpvoice.use` | | `/helpvoice reload` | Reload the configuration file | `helpvoice.admin` | | `/helpvoice setport <port>` | Manually assign a specific port | `helpvoice.admin` | | `/helpvoice lang <en/ru>` | Switch between English and Russian | `helpvoice.admin` |

All commands are protected by sensible permissions, with `helpvoice.use` granted to all players by default for basic status checks, and `helpvoice.admin` restricted to operators for administrative functions.

---

⚙️ CONFIGURATION OPTIONS

The configuration file is straightforward and well documented, allowing you to customize:

```yaml language: en # en or ru port: default: 24454 # First port to try alternatives: [24455,24456] # Fallback ports auto-detect: true # Enable/disable detection max-attempts: 10 # Random port attempts voicechat: config-file: "plugins/voicechat/voicechat.yml" backup: true # Backup before modifying