This (PaperMC-only) plugin adds an easy way to message other players in your current Simple Voice Chat group!

• /mg <message> - This command forwards a message to the other users in your group, allowing for users who wish to not use a microphone but still use Simple Voice Chat's groups feature.

• /mgtoggle [<on|off>] - This command toggles a mode where if you are in a group, all chat messages will be sent as /mg messages instead.

• Adds messages for when players join or leave a group which can be configured and disabled in the config.yml.

• Has support for prefixes and suffixes set by plugins such as Luckperms. Note: this requires the Vault plugin (can be found here or here) to be installed to work.

Note that this plugin must be installed alongside Simple Voice Chat and does not automatically install it.

Feel free to offer ideas, bug reports and feedback on the Discord channel!

# Thanks for using Voicechat Utils by Its_Padar!
# /plugins/voicechat-utils

# Do not edit this unless you absolutely know what you are doing
CONFIG_VERSION: 3



# Whether /mg and /messagegroup should be enabled.
# true/false
enable_messagegroup: true

# Whether messages sent with /mg should be forwarded to everyone with the voicechatutils.chat.spy permission.
# true/false
enable_messagegroup_spying: false

# Customise the message sent to players from /mg.
# Use https://webui.advntr.dev/ to test what it looks like and help customise it with colours.
# <group> is replaced by the name of the group, <name> is replaced by the name of the player, and <message> is replaced by the message that is sent
messagegroup_text: <gray>[<group>]</gray> <prefix><<name>><suffix><reset> <message>

How messages should be sent to players if they join/leave a group

chat - Send message in chat

actionbar - Send message to the player's actionbar in the middle of the screen

disable - Disable join/leave messages

join_leave_group_messages_mode: chat

Customise the join/leave messages sent if join_leave_group_messages_mode is not set to disable

Use https://webui.advntr.dev/ to test what it looks like and help customise it with colours.

is replaced by the name of the group, and is replaced by the name of the player

join_group_message_text: [] + leave_group_message_text: [] -

Enable and being replaced by the prefix/suffix of the player.

This requires the Vault API and a permissions plugin such as Luckperms to be installed to work!

Vault can be found at https://www.spigotmc.org/resources/vault.34315/ or https://dev.bukkit.org/projects/vault

enable_prefix_suffix_support: true

Set the parse mode for prefixes and suffixes.

Its recommended to set this away from automatic if possible

minimessage - <#FF0000> - The MiniMessage format, this is recommended

legacy - &#FF0000 - The legacy formatting code format

automatic - If there is a & in the prefix/suffix parse as legacy, otherwise assume minimessage

prefix_suffix_colour_mode: automatic

  
</details>

<details>
  <summary>Planned Potential Features</summary>
  
  - config reload command

  - support for language configuration files

  - toggle vc join leave messages?
  
  - create/manage group commands
    
  - broadcasting voice to all online players with simple voice chat
    
  - more moderation, eg a mute command /vc mute?

  - chat filtering (regexes, replacement and blocking)?
</details>