voicechat-addon | The best addon for Simple and Plasmo voice chats!

VoiceChatAddon is a server-side plugin that connects players using Simple Voice Chat and Plasmo Voice through a bidirectional proximity voice bridge.

Players can use either supported client mod and still hear nearby players using the other one. The plugin relays encoded voice frames in both directions, preserves the configured speaking distance, supports Simple Voice Chat whisper distance and prevents duplicate audio for players who have both voice mods installed.

VoiceChatAddon also includes install detection, one-time rewards, PlaceholderAPI status placeholders, SQLite and MySQL storage, IP-based reward protection, a configurable action system, an optional LiteBans mute integration and an administrator debug command.


Main Features

• Bidirectional Simple Voice Chat ↔ Plasmo Voice bridge.
• Cross-mod proximity voice without an additional client-side addon.
• Players only need one of the two supported voice mods.
• Distance preservation in both bridge directions.
• Simple Voice Chat whisper distance support.
• Maximum bridged distance protection.
• Duplicate audio prevention for dual-mod clients.
• Independent Simple Voice Chat and Plasmo Voice detection.
• Configurable list of enabled voice systems.
• Reward modes: ANY, BOTH, SIMPLE and PLASMO.
• Separate actions for Simple, Plasmo and dual-mod rewards.
• One-time reward claims stored persistently.
• Optional IP-based alt-account reward protection.
• SQLite and MySQL support through HikariCP.
• PlaceholderAPI player status placeholder.
• Relational compatibility placeholder.
• Online voice-user counters.
• Configurable status icons with MiniMessage formatting.
• Optional LiteBans mute synchronization for both voice systems.
• Configurable muted-action cooldown.
• MiniMessage and PlaceholderAPI support in actions.
• Messages, broadcasts, commands, sounds, titles, action bars and boss bars.
• Particles, fireworks, effects and optional Vault economy actions.
• Configuration reload command.
• Detailed per-player debug report.

How It Works

Install the server versions of Simple Voice Chat and Plasmo Voice on the same Paper backend, then enable both systems in VoiceChatAddon.

A player may connect with either client mod:

• A Simple Voice Chat player can be heard by nearby Plasmo Voice players.
• A Plasmo Voice player can be heard by nearby Simple Voice Chat players.
• Players using the same voice mod continue to communicate through that mod normally.

No VoiceChatAddon client mod is required. Players only need their preferred supported voice mod.


Bidirectional Proximity Bridge

The bridge relays voice in both directions:

Voice data is forwarded as encoded audio frames without an additional decode-and-reencode step.

The bridge becomes active when:

• Simple Voice Chat is installed and enabled on the server.
• Plasmo Voice is installed and enabled on the server.
• Both SIMPLE and PLASMO are present in settings.voiceChats.
• settings.bridgeVoiceChats is enabled.
• Both voice APIs and the Plasmo Voice proximity line are available.

Example:


Distance and Whisper Handling

For Simple Voice Chat speakers, VoiceChatAddon uses the server's configured voice-chat distance. Whispering uses approximately one third of that distance.

For Plasmo Voice speakers, the distance contained in the active proximity voice packet is preserved.

Bridged distance is clamped between 1 and 128 blocks as a safety limit.


Duplicate Audio Protection

VoiceChatAddon tracks which voice mods are available to every online player.

If a speaker has both supported voice mods, the addon does not relay that speaker through the bridge. It also filters bridged audio for listeners who already receive the original voice stream through the source mod.

This prevents the same voice packet from being heard twice.


Voice Detection and Rewards

Players can use:

The plugin checks whether the player has a configured voice mod and executes the matching reward action section.

Available reward sections:

actions.reward is used when the player has both voice mods.

actions.reward_simple is used when Simple Voice Chat is detected.

actions.reward_plasmo is used when Plasmo Voice is detected.

actions.install is used when the configured reward condition is not met.


Reward Modes

The required voice condition is configured through settings.mode.

Example:


One-Time Claims and IP Protection

Each successful reward claim is stored using the player's UUID, name, IP address and claim time.

The same UUID cannot claim the reward twice.

When settings.antiIPAbuse is enabled, another account using an IP address that has already received the reward is also blocked.

This protection can be disabled if multiple legitimate players use the same network.


Storage

VoiceChatAddon supports two storage types:

SQLite is used by default and stores data in:

MySQL example:

Connections are managed through HikariCP.


LiteBans Integration

If LiteBans is installed, VoiceChatAddon checks the player's active LiteBans mute before accepting outgoing voice packets.

Muted players are prevented from speaking through:

• Simple Voice Chat.
• Plasmo Voice.
• The cross-mod bridge.

When a muted player attempts to speak, the plugin executes actions.muted.

The notification cooldown is configurable in milliseconds:

Mute results are cached briefly to avoid querying the LiteBans database for every audio packet.


PlaceholderAPI

Available standard placeholders:

%voicechataddon_voice% returns the configured available or unavailable icon for the player.

%voicechataddon_voice_total% returns the number of online players using at least one configured voice mod.

%voicechataddon_voice_simple% returns the number of online Simple Voice Chat users.

%voicechataddon_voice_plasmo% returns the number of online Plasmo Voice users.

Available relational placeholder:

The relational placeholder compares the viewer and target player:

• available - the target can be heard by the viewer through a shared voice mod or the active bridge.
• incompatible - the target has voice chat, but the viewer cannot hear that voice system.
• unavailable - the target has none of the configured voice mods.

The three icons are fully configurable with MiniMessage:


Action System

All reward, install, mute, error and reload responses are configured as action lists.

Supported action types:

Built-in placeholders:

PlaceholderAPI placeholders can also be used in action text and commands.

Example:

Vault actions require Vault and a registered economy provider.


Configuration

Main configuration file:

Core settings example:

Use /voice reload after editing the configuration.


Commands

/voice checks the player's voice mod and processes the one-time reward.

/voice reload reloads the configuration, bridge state and cached voice statuses.

/voicechataddon <player> creates a detailed debug report for an online player, including detected voice clients, API state, bridge readiness and viewer compatibility.


Permissions

voicechat.addon.reload allows using /voice reload.

voicechat.addon.debug allows using /voicechataddon <player>.

Both permissions default to server operators.

The normal /voice reward command does not require a permission.


Requirements

• Java 21 or newer.
• Minecraft 1.21.x.
• Paper 1.21.x or a compatible Paper-based server fork.
• PlaceholderAPI.
• Simple Voice Chat and/or Plasmo Voice.

For cross-mod voice bridging, both Simple Voice Chat and Plasmo Voice must be installed on the same backend server.

Optional integrations:

• LiteBans - blocks voice transmission while a player is muted.
• Vault and an economy plugin - enables Vault economy actions.

Installation

1. Install PlaceholderAPI on the backend server.
2. Install the server versions of Simple Voice Chat, Plasmo Voice, or both.
3. Configure the UDP ports and networking of each voice plugin according to its own documentation.
4. Place VoiceChatAddon.jar into the backend server's plugins folder.
5. Install LiteBans and/or Vault if their integrations are required.
6. Start or restart the server.
7. Open plugins/voicechat-addon/config.yml.
8. Configure voice systems, reward mode, storage and actions.
9. Restart the server or use /voice reload for supported configuration changes.

Notes

• VoiceChatAddon is installed on the Paper backend, not on Velocity or another proxy.
• Install it on every backend where detection, rewards, placeholders or bridging are required.
• The bridge requires both server-side voice plugins, but each player only needs one supported client mod.
• The cross-mod bridge is designed for proximity voice. Private groups and channels remain managed separately by each voice mod and are not merged across the two systems.
• VoiceChatAddon does not open or configure UDP ports for the voice plugins.
• Reward claims are persistent and are limited to one claim per UUID.
• IP addresses are stored when reward claims are recorded; disable antiIPAbuse if IP-based blocking is not wanted.
• Correct real-IP forwarding is required when IP protection is used behind a proxy.
• Review and configure the bundled reward actions before allowing players to use /voice.
• A reward claim is stored before its actions run, so failed reward commands do not automatically allow another claim.
• Changing the database type or MySQL credentials requires a full server restart.
• Players with both client mods are excluded from bridge relaying to prevent duplicate audio.
• Folia support is not declared.

Credits

Voice bridge logic is adapted from PfauMC/voice-bridge and distributed under the MIT License.