Plasmo Voice

Beta

This is a beta version, and it still requires testing, especially the separate per-player sockets to backend servers. If you encounter any issues, please report them on [GitHub](https://github.com/plasmoapp/plasmo-voice/issues) or [Discord](https://discord.gg/uueEqzwCJJ). Versions 2.1.x and 2.2.x are protocol-compatible, so there's no need to worry if server or client hasn't been updated to 2.2.x. --- - Java 21 is now required. - Proxy now opens a separate socket to the backend server for each player instead of sending backend traffic through the public voice socket, which was a bottleneck under high load. [#535](https://github.com/plasmoapp/plasmo-voice/pull/535) - Updated slib to 2.1.0, which breaks addons that use: - McCommandManager#register with Brigadier commands. Register them with McBrigadierRegistry from McBrigadierCommandsRegisterEvent listener instead. - MessageTextConverter. Use McTextMessage.of(component) instead. - Added optional SO_REUSEPORT support ([reuse_port] in config.toml, Linux only). When enabled, multiple sockets on separate threads share the voice port instead of one. - Number of UDP threads can now be set with -Dplasmovoice.udp_threads (default: CPU cores * 2). - UDP server now copies fewer buffers, batches socket writes and forwards backend packets without decoding them.

Beta

This is a beta version, and it still requires testing, especially the separate per-player sockets to backend servers. If you encounter any issues, please report them on [GitHub](https://github.com/plasmoapp/plasmo-voice/issues) or [Discord](https://discord.gg/uueEqzwCJJ). Versions 2.1.x and 2.2.x are protocol-compatible, so there's no need to worry if server or client hasn't been updated to 2.2.x. --- - Java 21 is now required. - Proxy now opens a separate socket to the backend server for each player instead of sending backend traffic through the public voice socket, which was a bottleneck under high load. [#535](https://github.com/plasmoapp/plasmo-voice/pull/535) - Updated slib to 2.1.0, which breaks addons that use: - McCommandManager#register with Brigadier commands. Register them with McBrigadierRegistry from McBrigadierCommandsRegisterEvent listener instead. - MessageTextConverter. Use McTextMessage.of(component) instead. - Added optional SO_REUSEPORT support ([reuse_port] in config.toml, Linux only). When enabled, multiple sockets on separate threads share the voice port instead of one. - Number of UDP threads can now be set with -Dplasmovoice.udp_threads (default: CPU cores * 2). - UDP server now copies fewer buffers, batches socket writes and forwards backend packets without decoding them.

Beta

This is a beta version, and it still requires testing. If you encounter any issues, please report them on [GitHub](https://github.com/plasmoapp/plasmo-voice/issues) or [Discord](https://discord.gg/uueEqzwCJJ). Versions 2.1.x and 2.2.x are protocol-compatible, so there's no need to worry if server or client hasn't been updated to 2.2.x. --- - Plasmo Voice is now a Paper plugin. Spigot is no longer supported, use Paper or Folia 1.21+. - Commands now use Brigadier: - /vmute now requires duration before reason: /vmute <player> permanent <reason> instead of /vmute <player> <reason>. - /vmute now rejects invalid durations (0, 10x, overflowing values, u timestamps in the past) instead of treating them as part of the reason and muting permanently. - /vmute and /vunmute now accept target selectors, e.g. /vmute @a[distance=..10] 5m. - /vunmute now accepts the UUID of a muted player even when their name can't be resolved. - /vrc now uses actual command executor as reconnect target, so /execute as <player> run vrc will reconnect <player>. - Commands can now be used in datapack functions without macros. - Updated slib to 2.1.0, which breaks addons that use: - McCommandManager#register with Brigadier commands. Register them with McBrigadierRegistry from McBrigadierCommandsRegisterEvent listener instead. - MessageTextConverter. Use McTextMessage.of(component) instead. - Vanish is now alwayts handled through Paper's player visibility API, so direct SuperVanish/PremiumVanish integration was removed. - Added optional SO_REUSEPORT support ([voice.reuse_port] in config.toml, Linux only). When enabled, multiple sockets on separate threads share the voice port instead of one. - Number of UDP threads can now be set with -Dplasmovoice.udp_threads (default: CPU cores * 2). - Number of UDP threads no longer follows netty-threads from spigot.yml. - UDP server now copies fewer buffers, batches socket writes and doesn't create packet events when nothing listens to them. - In our benchmark, one socket now sends ~1.2x more packets than 2.1.x before it starts dropping, and allocates ~10x less memory per sent packet. - With reuse_port, 100 players speaking at the same spot (~500k outgoing packets/s) are handled without loss on 4 cores. - Fixed Opus mode and mtu_size from the config being ignored by the native encoder (it always used VOIP).

- Update checker will no longer suggest an update when none of the newer versions have a changelog. - Fixed update checker never suggesting 2.1.x versions.

- Update checker will no longer suggest an update when none of the newer versions have a changelog. - Fixed update checker never suggesting 2.1.x versions.

- Fixed an issue when server can't send a packet to client on second join, causing "Plasmo Voice is not installed" for this client until server restart. To make this issue easier to debug in the future, new logs were added with debug enabled. - Update checker will no longer suggest an update when none of the newer versions have a changelog.

- Fixed some ways a modified client could overload the voice server with bad packets and log spam.

- Fixed some ways a modified client could overload the voice server with bad packets and log spam.

- Fixed log spam and voice chat not working on Spigot and versions below 1.20.1. [#532](https://github.com/plasmoapp/plasmo-voice/issues/532) - Fixed a server crash when player joins with an unsupported mod version. - Fixed voice chat and mute expirations breaking when the update check could not reach Modrinth. - Fixed some ways a modified client could overload the voice server with bad packets and log spam.

- AES key is now derived from forwarding key via HKDF, so it's no longer necessary to specify PLASMO_VOICE_AES_KEY for multi-proxy setups. - Added BaseServerDirectSource#getListeners to API to resolve current source's listeners.

- AES key is now derived from forwarding key via HKDF, so it's no longer necessary to specify PLASMO_VOICE_AES_KEY for multi-proxy setups. - Added BaseServerDirectSource#getListeners to API to resolve current source's listeners.

- Added BaseServerDirectSource#getListeners and ServerProximitySource#getListeners to API to resolve current source's listeners. - Added config option to make vmute/vunmute commands and mute expirations silent. [#522](https://github.com/plasmoapp/plasmo-voice/pull/522)

- Fixed conflicts with other plugins caused by brigadier being bundled into the jar. [#520](https://github.com/plasmoapp/plasmo-voice/issues/520)

- Fixed conflicts with other plugins caused by brigadier being bundled into the jar. [#520](https://github.com/plasmoapp/plasmo-voice/issues/520)

- Fixed conflicts with other plugins caused by brigadier being bundled into the jar. [#520](https://github.com/plasmoapp/plasmo-voice/issues/520)

- Fixed API dependency resolution by preferring instead of hard-requiring specific guava/gson/fastutil versions. - Connection logs are now always logged instead of being gated by debug logging.

- Fixed API dependency resolution by preferring instead of hard-requiring specific guava/gson/fastutil versions. - Connection logs are now always logged instead of being gated by debug logging.

- Fixed API dependency resolution by preferring instead of hard-requiring specific guava/gson/fastutil versions. - Connection logs are now always logged instead of being gated by debug logging.

- Fixed proxy reload command (/greload or /velocity reload) not stopping existing UDP server, causing voice proxy to break. - Fixed addon translations being shown as translation keys when default_language/forced_language is set to a language an addon doesn't fully translate (missing keys now fall back to en_us).

- Fixed proxy reload command (/greload or /velocity reload) not stopping existing UDP server, causing voice proxy to break. - Fixed addon translations being shown as translation keys when default_language/forced_language is set to a language an addon doesn't fully translate (missing keys now fall back to en_us).

- Fixed addon translations being shown as translation keys when default_language/forced_language is set to a language an addon doesn't fully translate (missing keys now fall back to en_us).

- Fixed "Incorrect behavior on resuming AudioSender". ([#501](https://github.com/plasmoapp/plasmo-voice/issues/501)) - Added sanity bounds checks for collections decoding. ([#505](https://github.com/plasmoapp/plasmo-voice/issues/505))

- Fixed "Incorrect behavior on resuming AudioSender". ([#501](https://github.com/plasmoapp/plasmo-voice/issues/501)) - Added sanity bounds checks for collections decoding. ([#505](https://github.com/plasmoapp/plasmo-voice/issues/505))

- Fixed "Incorrect behavior on resuming AudioSender". ([#501](https://github.com/plasmoapp/plasmo-voice/issues/501)) - Added sanity bounds checks for collections decoding. ([#505](https://github.com/plasmoapp/plasmo-voice/issues/505)) - Embedded player info request retry logic to improve connection reliability. ([#466](https://github.com/plasmoapp/plasmo-voice/issues/466))

Changes in 2.1.7

- Fixed /vreload not reloading language changes. - Improved performance using epoll when available. - Fixed java.util.ConcurrentModificationException in ProxyChannelHandler.

Changes in 2.1.7

- Fixed /vreload not reloading language changes. - Improved performance using epoll when available. - Fixed java.util.ConcurrentModificationException in ProxyChannelHandler.

Changes in 2.1.7

- Fixed /vreload not reloading language changes. - Fixed Player is not connected to UDP server exception on PlayerShowEntityEvent. - Added more descriptive comments in the config. - Added configurable player icon visibility and offset. Check [voice.player_icon] config block for more info. - Reworked keep alive to handle more players. - Improved performance using epoll when available. - Fixed leaving in vanish breaks Plasmo Voice sometimes. ([#493](https://github.com/plasmoapp/plasmo-voice/issues/493))

Changes in 2.1.6

- Removed "Default language '...' doesn't exist" check when using non "en_us" language. - Fixed UdpClientDisconnectedEvent event wasn't invoked when player is kicked from backend server.

Changes in 2.1.6

- Removed "Default language '...' doesn't exist" check when using non "en_us" language. - Fixed UdpClientDisconnectedEvent event wasn't invoked when player is kicked from backend server.

Changes in 2.1.6

- Plugin now requires minimum version of Java 17 to run. - Fixed "Plasmo Voice is not installed on this server" on Paper 1.21.7. - Removed debug print when chat message is sent to the player. - Removed "Default language '...' doesn't exist" check when using non "en_us" language. - Fixed "Failed to encrypt data: VoiceServerPlayerEntity(...) has empty public key". - Fixed hover / click text components events on Spigot 1.20.4. - Fixed entity sources on Folia [pv-addon-spectator#4](https://github.com/plasmoapp/pv-addon-spectator/issues/4). - Fixed Cannot send game event asynchronously on Folia with pv-addon-sculk [#486](https://github.com/plasmoapp/plasmo-voice/issues/468). - Improved vanish support by PlayerHideEntityEvent and PlayerShowEntityEvent when direct integration is not available.

Changes in 2.1.6

- Fixed "Plasmo Voice is not installed on this server" on Paper 1.21.7. - Removed debug print when chat message is sent to the player. - Removed "Default language '...' doesn't exist" check when using non "en_us" language. - Fixed "Failed to encrypt data: VoiceServerPlayerEntity(...) has empty public key".

Changes in 2.1.5

- Fixed an issue where the audio end packet wasn't sent after reconnecting to the UDP server. - Fixed a deadlock caused by language loading, which could eventually break languages and other addons that use coroutines (e.g. discs addon).

Changes in 2.1.5

- Fixed an issue where the audio end packet wasn't sent after reconnecting to the UDP server. - Fixed a deadlock caused by language loading, which could eventually break languages and other addons that use coroutines (e.g. discs addon).

Changes in 2.1.5

- Fixed an issue where the audio end packet wasn't sent after reconnecting to the UDP server. - Fixed a deadlock caused by language loading, which could eventually break languages and other addons that use coroutines (e.g. discs addon).

Changes in 2.1.4

- Support 1.21.5 component changes. - Fixed crowdin download task blocking language resolution, causing languages not to load.

Changes in 2.1.4

- Support 1.21.5 component changes. - Fixed crowdin download task blocking language resolution, causing languages not to load.

Changes in 2.1.4

- Support 1.21.5 component changes. - Fixed SuperVanish /hide causes hidden client to disconnect. - Fixed game events reflections causing high CPU usage on Spigot-based servers. - Fixed crowdin download task blocking language resolution, causing languages not to load.

Changes in 2.1.3

- Fixed an issue where proxy identified a backend connection as a player connection, causing a ClassCastException. - Added option to set AES key manually using plasmovoice/aes-key (path can be changed by PLASMO_VOICE_AES_KEY_FILE env) file or PLASMO_VOICE_AES_KEY env.

Changes in 2.1.3

- Fixed an issue where proxy identified a backend connection as a player connection, causing a ClassCastException. - Added option to set AES key manually using plasmovoice/aes-key (path can be changed by PLASMO_VOICE_AES_KEY_FILE env) file or PLASMO_VOICE_AES_KEY env.

Changes in 2.1.3

- Fixed an issue where Plasmo Voice failing to load would break all commands tab-completion.

Alpha Notice

This version still requires testing, especially for backports. If you encounter any issues, please report them on Discord: https://discord.gg/uueEqzwCJJ. Versions 2.0.x and 2.1.x are protocol-compatible, so there’s no need to worry if the server hasn't been updated to 2.1.x.

Changes in 2.1.2

- Fixed buffer overflow when using AudioSender with delayed first frame. - Fixed client EncoderException on server switch caused by UDP packets sent to a client when client's server is null. - Fixed ArrayIndexOutOfBoundsException exception when using / command on Velocity. - Fixed pv.activation.* permission is not being updated on the client without reconnect. - Fixed permission check on BungeeCord.

Alpha Notice

This version still requires testing, especially for backports. If you encounter any issues, please report them on Discord: https://discord.gg/uueEqzwCJJ. Versions 2.0.x and 2.1.x are protocol-compatible, so there’s no need to worry if the server hasn't been updated to 2.1.x.

Changes in 2.1.2

- Fixed buffer overflow when using AudioSender with delayed first frame. - Fixed client EncoderException on server switch caused by UDP packets sent to a client when client's server is null. - Fixed ArrayIndexOutOfBoundsException exception when using / command on Velocity. - Fixed pv.activation.* permission is not being updated on the client without reconnect. - Fixed permission check on BungeeCord.

Alpha Notice

This version still requires testing, especially for backports. If you encounter any issues, please report them on Discord: https://discord.gg/uueEqzwCJJ. Versions 2.0.x and 2.1.x are protocol-compatible, so there’s no need to worry if the server hasn't been updated to 2.1.x.

Changes in 2.1.2

- Fixed buffer overflow when using AudioSender with delayed first frame. - Fixed pv.activation.* permission is not being updated on the client without reconnect. - Fixed server translations missing in kick messages. [#428](https://github.com/plasmoapp/plasmo-voice/issues/428) - /vmute without arguments now sends command usage instead of "no permissions" error.

Alpha Notice

This version still requires testing, especially for backports. If you encounter any issues, please report them on Discord: https://discord.gg/uueEqzwCJJ. Versions 2.0.x and 2.1.x are protocol-compatible, so there’s no need to worry if the server hasn't been updated to 2.1.x.

Changes in 2.1.1

Alpha Notice

This version still requires testing, especially for backports. If you encounter any issues, please report them on Discord: https://discord.gg/uueEqzwCJJ. Versions 2.0.x and 2.1.x are protocol-compatible, so there’s no need to worry if the server hasn't been updated to 2.1.x.

Changes in 2.1.1

Alpha Notice

This version still requires testing, especially for backports. If you encounter any issues, please report them on Discord: https://discord.gg/uueEqzwCJJ. Versions 2.0.x and 2.1.x are protocol-compatible, so there’s no need to worry if the server hasn't been updated to 2.1.x.

Changes in 2.1.1

- Attempt to fix "Cannot measure distance between worlds" exception, see [#422](https://github.com/plasmoapp/plasmo-voice/issues/422).

Alpha Notice

This version still requires testing, especially for backports. If you encounter any issues, please report them on Discord: https://discord.gg/uueEqzwCJJ. Versions 2.0.x and 2.1.x are protocol-compatible, so there’s no need to worry if the server hasn't been updated to 2.1.x.

Main Changes

- Backports to 1.18.2, 1.17.1, and 1.16.5. - New open source [Opus](https://github.com/plasmoapp/opus-jni-rust) and [RNNoise](https://github.com/plasmoapp/rnnoise-jni-rust) binaries, related to [#319](https://github.com/plasmoapp/plasmo-voice/issues/319) [#375](https://github.com/plasmoapp/plasmo-voice/issues/375) [#382](https://github.com/plasmoapp/plasmo-voice/issues/382). - Languages now support [MiniMessage format](https://docs.advntr.dev/minimessage/index.html). - Fixed [#376](https://github.com/plasmoapp/plasmo-voice/issues/376) "IP address not updates after recreate minecraft's server docker container" - ...and many more internal changes and fixes.

Breaking API Changes

There have been breaking changes to the API, meaning you'll need to update your addons: - [pv-addon-groups](https://modrinth.com/plugin/pv-addon-groups/version/1.1.0) - [pv-addon-broadcast](https://modrinth.com/plugin/pv-addon-broadcast/version/1.… The API documentation is now available: https://plasmovoice.com/docs/api. It's still a work in progress, so feedback is appreciated. You can provide feedback on our Discord: https://discord.gg/uueEqzwCJJ.

Alpha Notice

This version still requires testing, especially for backports. If you encounter any issues, please report them on Discord: https://discord.gg/uueEqzwCJJ. Versions 2.0.x and 2.1.x are protocol-compatible, so there’s no need to worry if the server hasn't been updated to 2.1.x.

Main Changes

- Backports to 1.18.2, 1.17.1, and 1.16.5. - New open source [Opus](https://github.com/plasmoapp/opus-jni-rust) and [RNNoise](https://github.com/plasmoapp/rnnoise-jni-rust) binaries, related to [#319](https://github.com/plasmoapp/plasmo-voice/issues/319) [#375](https://github.com/plasmoapp/plasmo-voice/issues/375) [#382](https://github.com/plasmoapp/plasmo-voice/issues/382). - Languages now support [MiniMessage format](https://docs.advntr.dev/minimessage/index.html). - Fixed [#376](https://github.com/plasmoapp/plasmo-voice/issues/376) "IP address not updates after recreate minecraft's server docker container" - ...and many more internal changes and fixes.

Breaking API Changes

There have been breaking changes to the API, meaning you'll need to update your addons: - [pv-addon-groups](https://modrinth.com/plugin/pv-addon-groups/version/1.1.0) - [pv-addon-broadcast](https://modrinth.com/plugin/pv-addon-broadcast/version/1.… The API documentation is now available: https://plasmovoice.com/docs/api. It's still a work in progress, so feedback is appreciated. You can provide feedback on our Discord: https://discord.gg/uueEqzwCJJ.

Alpha Notice

This version still requires testing, especially for backports. If you encounter any issues, please report them on Discord: https://discord.gg/uueEqzwCJJ. Versions 2.0.x and 2.1.x are protocol-compatible, so there’s no need to worry if the server hasn't been updated to 2.1.x.

Main Changes

- Backports to 1.18.2, 1.17.1, and 1.16.5. - New open source [Opus](https://github.com/plasmoapp/opus-jni-rust) and [RNNoise](https://github.com/plasmoapp/rnnoise-jni-rust) binaries, related to [#319](https://github.com/plasmoapp/plasmo-voice/issues/319) [#375](https://github.com/plasmoapp/plasmo-voice/issues/375) [#382](https://github.com/plasmoapp/plasmo-voice/issues/382). - Server now sends a request info packet to any player joining the server. This was introduced due to differences in how various mod loaders handle the mod channel list, and I just can't figure out how to make it work on Forge/NeoForge 1.20.2+. - Server now checks if a player has voice disabled or microphone muted before sending or receiving the audio. - Languages now support [MiniMessage format](https://docs.advntr.dev/minimessage/index.html). - ...and many more internal changes and fixes.

Breaking API Changes

There have been breaking changes to the API, meaning you'll need to update your addons: - [pv-addon-groups](https://modrinth.com/plugin/pv-addon-groups/version/1.1.0) - [pv-addon-sculk](https://modrinth.com/plugin/pv-addon-sculk/version/1.1.0) - [pv-addon-broadcast](https://modrinth.com/plugin/pv-addon-broadcast/version/1.… - [pv-addon-spectator](https://modrinth.com/plugin/pv-addon-spectator/version/1.… - [pv-addon-whisper](https://modrinth.com/plugin/pv-addon-whisper/version/1.1.0) - [pv-addon-priority](https://modrinth.com/plugin/pv-addon-priority/version/1.1.0) - [pv-addon-lavaplayer-lib](https://modrinth.com/plugin/pv-addon-lavaplayer-lib/versi… - [pv-addon-discs](https://modrinth.com/plugin/pv-addon-discs/version/1.1.0) The API documentation is now available: https://plasmovoice.com/docs/api. It's still a work in progress, so feedback is appreciated. You can provide feedback on our Discord: https://discord.gg/uueEqzwCJJ.

- Fixed stacktrace spam on bad packets [#397](https://github.com/plasmoapp/plasmo-voice/issues/397)

- Fixed stacktrace spam on bad packets [#397](https://github.com/plasmoapp/plasmo-voice/issues/397)

- Fixed stacktrace spam on bad packets [#397](https://github.com/plasmoapp/plasmo-voice/issues/397)

- Fixed a bug where an AES key was not reset properly after a backend restart

- Fixed a bug where an AES key was not reset properly after a backend restart

- [Paper] SuperVanish/PremiumVanish integration with show and hide events

- Fixed error when player was disconnected from the voice server if someone with the same name is trying to join the server - Fixed error when player was not cleared properly on disconnect and on the next join voice will not work for that player

- Fixed error when player was disconnected from the voice server if someone with the same name is trying to join the server - Fixed error when player was not cleared properly on disconnect and on the next join voice will not work for that player

- Fix vanish support [#358](https://github.com/plasmoapp/plasmo-voice/issues/358) - Fix memory leak when unloading worlds

- minor bug fixes

- minor bug fixes

- minor bug fixes - relocate ustats to fix crash on fabric

- now slf4j is used for logging to fix crash on BungeeCord - resolve backend servers hostnames if unresolved - option to disable crowdin translations in config - option to disable check for updates in config - kotlin was relocated to avoid conflicts with another plugins. Because some addons use kotlin from Plasmo Voice, they will be broken and you should update them: - [pv-addons-groups](https://modrinth.com/plugin/pv-addon-groups/version/1.0.3)

- now slf4j is used for logging to fix crash on BungeeCord - resolve backend servers hostnames if unresolved - option to disable crowdin translations in config - option to disable check for updates in config - kotlin was relocated to avoid conflicts with another plugins. Because some addons use kotlin from Plasmo Voice, they will be broken and you should update them: - [pv-addons-groups](https://modrinth.com/plugin/pv-addon-groups/version/1.0.3)

- option to disable crowdin translations in config - option to disable check for updates in config - kotlin was relocated to avoid conflicts with another plugins. Because some addons use kotlin from Plasmo Voice, they will be broken and you should update them: - [pv-addons-lavaplayer-lib](https://modrinth.com/plugin/pv-addon-lavaplayer-lib/versi… - [pv-addons-discs](https://modrinth.com/plugin/pv-addon-discs/version/1.0.1) - [pv-addons-groups](https://modrinth.com/plugin/pv-addon-groups/version/1.0.3)

- fixed an exception on server language loading (java.lang.Exception: Can't load language resource)

- fixed an exception on server language loading (java.lang.Exception: Can't load language resource)

- fixed an exception on server language loading (java.lang.Exception: Can't load language resource)

- fixed bug when missing translations keys are not falling back to default language

- fixed bug when missing translations keys are not falling back to default language

- fixed bug when Plasmo Voice worked after first join, but didn't after reconnect - fixed bug when missing translations keys are not falling back to default language