# SVC-Mute
Addon for Simple Voice Chat, that allows you to mute players' voice.
Requires [Simple Voice Chat](https://modrinth.com/plugin/simple-voice-chat) installed.
# Features
- Mute player's voice _(/vmute)_
- Mute voice chat on the entire server _(/vmuteall)_
- Highly customizable config with MiniMessage support
# Commands
|Command|Definition|Permission
|-|-|-
|/vmute <player> <time> <reason>|Mute player's voice chat. Permanent, if time was not specified|svcmute.mute.command
|/vunmute <player>|Unmute muted player|svcmute.unmute.command
|/vmuteall <on/off>|Enable/disable "muteall" mode, when nobody can use voice chat|svcmute.muteall.command
|/svcmute <reload>|Reload plugin's config|svcmute.admin.command
# Permissions
### Mute
|Permission|Definition|Default
|-|-|-
|svcmute.mute.command|/vmute|OP
|svcmute.mute.msg.see|Allows to see mute global notifications|true|
### Unmute
|Permission|Definition|Default
|-|-|-
|svcmute.unmute.command|/vunmute|OP
|svcmute.unmute.msg.see|Allows to see unmute global notifications|true
### Muteall
|Permission|Definition|Default
|-|-|-
|svcmute.muteall.command|/vmuteall| OP
|svcmute.muteall.allow.voice|Access to voice chat while "muteall" is enabled|OP
|svcmute.muteall.msg.see|Allows to see muteall global notifications|true
### Other
|Permission|Definition|Default
|-|-|-
|svcmute.admin.command|/svcmute reload|OP
|svcmute.enable.voice|Enables player to use voice chat|true
# Config
```
# You can leave any field blank if you don't want that message to appear
# Formatting support:
# - Legacy (&)
# - MiniMessage; Docs: https://docs.papermc.io/adventure/minimessage/; Online Viewer: https://webui.advntr.dev
# ==============================================================================
# ========================== MUTE PLUGIN CONFIGURATION =========================
# ==============================================================================
# General prefix added to the beginning of most plugin messages.
# You can use placeholder anywhere
prefix: "&8[&6SVC-Mute&8]&r "
# Message displayed in the player's actionbar when they try to chat while muted.
# Placeholders:
actionbar_mute_msg: "&cYou are currently muted and cannot speak."
# Message displayed in the player's actionbar when they try to chat while "muteall" is enabled.
actionbar_muteall_msg: "&cYou are currently muted and cannot speak."
# Message displayed in the player's actionbar when they try to chat without permission "svcmute.enable.voice".
actionbar_not_allowed_msg: "&cYou are not allowed to speak."
# ==============================================================================
# ================================ TIME FORMATS ================================
# ==============================================================================
# Text used when a mute has no expiration date.
time_permanent: "&4Permanent"
# Base words for time units.
time_year: "y"
time_month: "mon"
time_week: "w"
time_day: "d"
time_hour: "h"
time_minute: "m"
time_second: "s"
# ==============================================================================
# ================================ REASONS & MISC ==============================
# ==============================================================================
# Message shown when a reason is blank.
reason_empty: "&cViolation of server rules."
# Message shown when the plugin configuration is reloaded.
config_reload_msg: "&aConfiguration successfully reloaded."
# ==============================================================================
# ============================= MUTE MESSAGES ==============================
# ==============================================================================
# Broadcasted to the server when a player is muted.
# Placeholders: , , ,
mute_msg: "&c &7has been muted for &e&7. Reason: &f"
# Broadcasted to the server when a player is permanently muted.
# Placeholders: , ,
mute_msg_permanent: "&c &7has been &4permanently muted&7. Reason: &f"
# Message sent directly to the player in chat when they get muted.
# Placeholders: , , ,
mute_player_msg: "&cYou have been muted for &e&c. Reason: &f"
# Error message when trying to mute a player who is already muted.
# Placeholders:
mute_command_already_muted: "&c is already muted."
# ==============================================================================
# =============================== UNMUTE MESSAGES ==============================
# ==============================================================================
# Broadcasted to the server when a player is unmuted.
# Placeholders: ,
unmute_global_msg: "&a &7has been unmuted by &e&7."
# Message sent to the player when they are unmuted.
# Placeholders: ,
unmute_player_msg: "&aYou have been unmuted by &e&a."
# Error message when trying to unmute a player who is not currently muted.
# Placeholders:
unmute_command_already_unmuted: "&c is not currently muted."
# ==============================================================================
# ================================ MUTE ALL ====================================
# ==============================================================================
# Broadcasted when the global voice chat is muted (muteall on).
# Placeholders:
muteall_command_global_msg_on: "&4[!] &cGlobal chat has been muted by &e&c."
# Broadcasted when the global voice chat is unmuted (muteall off).
# Placeholders:
muteall_command_global_msg_off: "&a[!] &aGlobal chat has been unmuted by &e&a."
```
</details>
