> For the complete documentation index, see [llms.txt](https://docs.pixel-dev.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pixel-dev.net/sdchat/configuration.md). # Configuration 
# ==================================================
# Plugin: SDChat
# Author: ShaneDev
# Version: 1.0
# Support Discord: https://discord.gg/EVSpujnuwC
# ==================================================


#Prefix of the plugin in chat. (Currently not used)
Prefix: "&a&lCHAT &8&l» "

#Chat Format (Supports ALL PlaceholderAPI Placeholders)
#NOTE: To change name color per rank, simply put the color at the end of the ranks prefix.
Chat-Format: '%luckperms_prefix% %player% &8» &f%message%'

#Whether the plugin should log chat messages & private messages (true/false)
Use-Logging: true

#Private Messaging
#Change this value to enable/disable private messaging (true/false)
Use-Messaging: true
#Placeholders: %recipient% - Players name receiving the message.
#Placeholders: %sender% - Players name that sent the message.
Message-SenderFormat: '&6[!] &7me -> &b%recipient% &8>> &r%message%'
Message-RecipientFormat: '&6[!] &b%sender% &7-> me &8>> &r%message%'
#SocialSpy
MessageSpy-Format: '&4[Spy] &b%sender% &7-> %recipient% &8>> &r%message%'
MessageSpy-Enabled: '&7You have &aenabled&7 MessageSpy!'
MessageSpy-Disabled: '&7You have &cdisabled&7 MessageSpy!'

#Content to go inside the box that appears when hovering over a players message
#NOTE: You can use ANY PlaceholderAPI placeholders here!
Hover-Box:
  - "Chat Hover Box"
  - "You can use placeholders!"
  - "Like this!"
  - "%luckperms_prefix% %player_name% %luckperms_suffix%"

#Command that will be placed in the players chat when they click a chat message.
#NOTE: Set this to '' to disable clicking messages.
Click-Command: '/msg %player% '

#Change this value to enable/disable staff chat (true/false)
Use-Staff-Chat: true
Staff-Chat-Format: '&4[StaffChat] &c%player% &7> &e%message%'


##REPORTING##
#Option to enable/disable the player reporting feature
Use-Reporting: true
#How many reports should appear on each page?
ReportsPerPage: 5
#How many seconds should players wait in between reporting?
ReportCooldown: 60
#Message sent when player is on report cooldown.
ReportCooldownMessage: '&c&lREPORTS &8» &cYou must wait %timeleft% seconds before reporting again.'
#Message sent to player when they use the command improperly.
ReportError: '&a&lCHAT &8» §cUsage: /report <player> <message>'
InvalidPage: '&c&lREPORTS &8» &cInvalid page number.'
#Message sent to player when they send a report.
Report-Message: '&c&lREPORTS &8» &aYour report has been sent!'
#Message sent to staff when a report is received.
Report-StaffMessage: '&8[&4REPORT&8] &a%reporter% &7has reported &a%reported% &7for &f%message%'
#ViewReports command format:
ViewReports-Page: '&6&lReports Page (%page%/%total%) [%totalreports%]'
ViewReports-Format: '%newline%&7[%timestamp%] %newline% &a%reporter% reported %reported%: &f%message%'

##HELP-OP##
Use-HelpOP: true
HelpOPCooldown: 60
HelpOPCooldownMessage: '&a&lHELPOP &8» &cYou must wait %timeleft% seconds before using this again.'
HelpOPError: '&a&lCHAT &8» §cUsage: /helpop <message>'
HelpOP-Message: '&a&lHELPOP &8» &aYour request has been sent!'
HelpOP-StaffMessage: '&8[&aHELPOP&8] &a%player% &7is requesting help: &f%message%'


###############################
############LANGUAGE###########
###############################
# Set the message to '' if you want to disable it completely

#Message sent to players when they run a command that they don't have permissions for.
PermissionDeniedMessage: '&fNo Access'

#The message that gets broadcasted in chat when chat is cleared.
#Placeholders: %player% - Players name that cleared chat
ClearChatMessage: '&c&lChat has been cleared by %player%'

#The message that gets broadcasted when chat is muted/unmuted.
#Placeholders: %player% - Players name that muted/unmuted chat
MuteChatMessage: '&a&lCHAT &8» &c&lChat has been muted by %player%'
UnMuteChatMessage: '&a&lCHAT &8» &c&lChat has been unmuted by %player%'

#The message that gets sent to online staff when chat is muted/unmuted.
#Placeholders: %player% - Players name that muted/unmuted chat
MuteChatStaffMessage: '&4[STAFF] &cChat has been muted by %player%'
UnMuteChatStaffMessage: '&4[STAFF] &cChat has been unmuted by %player%'

#Message sent to player when they try to talk while chat is muted
ChatMutedMessage: '&cChat is currently muted!'

#The message that gets broadcasted in chat when chat gets slowed.
#Placeholders: %player% - Players name that slowed chat
#Placeholders: %time_slowed% - Amount of time chat has been slowed to.
SlowChatMessage: '&6Chat has been slowed by %player%. You can now chat every %time_slowed% seconds.'
SlowChatStaffMessage: '&4[STAFF] &cChat has been slowed by %player%. Players can now chat every %time_slowed% seconds.'

#Message sent to player when they try to talk while chat is slowed.
#Placeholders: %time_slowed% - Amount of time chat has been slowed to.
#Placeholders: %time_slowed_left% - Amount of time till the player can chat again.
SlowChatCooldownMessage: '&cChat is currently Slowed! You can chat again in %time_slowed_left% seconds!'

#Message sent to staff when they toggle staff chat on/off
EnabledStaffChat: '&7You have &aenabled&7 Staff Chat!'
DisabledStaffChat: '&7You have &cdisabled&7 Staff Chat!'

#Messages sent to sender when recipient has messaging disabled.
Toggled-Message: '&6[!] &c%recipient% has messaging disabled.'
#Messages sent to sender when they toggle messaging.
ToggleMessage: '&6[!] &7You have &cdisabled &7receiving messages.'
UnToggleMessage: '&6[!] &7You have &aenabled &7receiving messages.'

#Message sent to player when they use a command improperly.
SlowChatError: '&a&lCHAT &8» §cInvalid Usage. Usage: §f/slowchat <time in seconds>'
BlockError: '&a&lCHAT &8» §cInvalid Usage. Usage: §f/block <player>'
MessageError: '&a&lCHAT &8» §cInvalid Usage. Usage: §f/msg <player> <message>'
ReplyError: '&a&lCHAT &8» §cInvalid Usage. Usage: §f/r <message>'
NoOneToReply: '&a&lCHAT &8» §cYou have not messaged anyone recently!'

#Message sent to player when they block/unblock a player.
BlockPlayer: '&a&lCHAT &8» §cYou have blocked %player%.'
UnblockPlayer: '&a&lCHAT &8» §aYou have unblocked %player%.'
#Message sent to player when the recipient has them blocked.
MessageWhileBlocked: '&a&lCHAT &8» §cThat player has you blocked!.'
#Message sent to player when they try to block an admin. (sdchat.block.bypass)
BlockBypass: '&a&lCHAT &8» §cYou cannot block that player!'

#Broadcast message using /broadcast
BroadcastFormat: "&c[BROADCAST] &b[%sender%] &f%message%"

#Time & Weather Language
#Placeholders:
#For Time: %time%
#For Weather: %weather%
Time-Set: '&7[&aTIME&7] &fYou have set the time to &a&n%time%&r'
Time-Error: '&7[&aTIME&7] &cPlease specify a valid time in ticks or (DAY / NIGHT)'
Weather-Set: '&7[&6WEATHER&7] &fYou have set the weather to &6&n%weather%&r'
Weather-Error: '&7[&6WEATHER&7] &cPlease specify a weather type (CLEAR or DOWNFALL).'

###############################
##########CHAT FILTER##########
###############################

#List below all of the words you would like to block.
#NOTE: This system uses REGEX to replace letters with known, common workarounds such as @, or !.
#NOTE: If you find a letter that is not properly blocked, please let me know and I'll add it ASAP!
BlockedWordsMessage: '&cThis word is blocked!'
Blocked-Words:
  - "BADWORD1"
  - "BADWORD2"

#List below all of the commands you would like to block.
#NOTE: This will block even if the command contains part of the blocked command.
#NOTE: such as "/pl" and "/plugins"; "/plugin" would be blocked because it contains the blocked command.
BlockedCommandsMessage: '&cThis command is blocked!'
Blocked-Commands:
  - "/blockedcommand1"
  - "/blockedcommand2"


##ANTI CAPS##
#NOTE: This is the % of the message that must be capital letters for it to be formatted to all lowercase.
#NOTE: 0.5 = 50% of the message (50% of the message must be caps to be formatted to all lowercase.)
AntiCaps: true
AntiCaps-Threshold: 0.5

##Anti-Spam##
#Force movement before being able to send a message in chat.
Force-Movement: true
#Message sent to players when they attempt to chat without first moving in-game.
MoveMessage: '&cYou must move before chatting!'
#
Block-Duplicate-Messages: true
DuplicateMessageWarning: "&a&lCHAT &8» §cPlease do not send duplicate messages!"
#
Block-Advertising: true
AdvertBlockedWarning: "&a&lCHAT &8» §cPlease do not send IP/Web Addresses in chat!"

###############################
############NICKNAME###########
###############################

#Message sent to player once they set their nickname with /nick
#Placeholders: %nickname%
NicknameSetMessage: '&6[NICKNAME] &7Your nickname has been set to %nickname%.'
NicknameResetMessage: '&6[NICKNAME] &7Your nickname has been reset!'
NicknameInvalidMessage: '&6[NICKNAME] &cThat nickname is invalid!'


###############################
##########Join Message#########
###############################
#Setting this to false will enable default join/leave messaging.
#Placeholders: %player%
Use-Custom-Message: true
JoinMessage: "&8[&a+&8] &a%player%"
QuitMessage: "&8[&c-&8] &c%player%"

#Setting this to false will disable the Join MOTD.
#Placeholders: %player%
Use-MOTD: true
MOTD:
  - "&aHello!"
  - "&eThis is the join MOTD"
  - ""
  - "&b&lWelcome to the server %player%!"


###############################
########AutoBroadcaster########
###############################
Use-Auto-Broadcaster: true
Broadcast-Interval: 360 #6 minutes
broadcasts:
  test:
    messages:
      - ""
      - "                       &b&l<< &3&l! &b&l>> SDChat"
      - "           &fThank you for downloading my plugin!"
      - "         This is a test auto-broadcast message"
      - "   &bVisit the support discord for any help with the plugin!"
      - ""
    click: "/sdchat"
    hover:
      - "    &b&l<< &3&l! &b&l>> ToolTip"
      - "&3&l* &fMultiple lines!"
      - "&3&l* &fUseful informations!"
      - "&3&l* &fClickable!"
    sound: ENTITY_EXPERIENCE_ORB_PICKUP
  test2:
    messages:
      - ""
      - "                       &7&l<< &a&l! &7&l>> SDChat"
      - "           &aThank you for downloading my plugin!"
      - "         This is a test auto-broadcast message"
      - "   &3Visit the support discord for any help with the plugin!"
      - ""
    click: "https://shanedev.co"
    hover:
      - "    &b&l<< &3&l! &b&l>> ToolTip"
      - "&3&l* &fMultiple lines!"
      - "&3&l* &fUseful informations!"
      - "&3&l* &fClickable!"
    sound: ENTITY_EXPERIENCE_ORB_PICKUP

###############################
#########Death Messages########
###############################
#Setting this to true will completely remove death messages.
Disable-Death-Messages: false
#Setting this to false will disable the customization of death messages.
Use-Death-Messages: true
#CUSTOMIZE ALL DEATH MESSAGES
Attack: '&8[&c!&8] &7%player% was slain by %killer%'
Projectile: '&8[&c!&8] &7%player% was shot by %killer%'
Suffocation: '&8[&c!&8] &7%player% suffocated in a wall'
Fall: '&8[&c!&8] &7%player% hit the ground too hard'
Fire: '&8[&c!&8] &7%player% went up in flames'
FireTick: '&8[&c!&8] &7%player% burned to death'
Melting: '&8[&c!&8] &7%player% melted'
Lava: '&8[&c!&8] &7%player% tried to swim in lava'
Drowning: '&8[&c!&8] &7%player% drowned'
Explosion: '&8[&c!&8] &7%player% was blown up'
Void: '&8[&c!&8] &7%player% fell out of the world'
Lightning: '&8[&c!&8] &7%player% was stuck by lightning'
Suicide: '&8[&c!&8] &7%player% died'
Starvation: '&8[&c!&8] &7%player% starved to death'
Poison: '&8[&c!&8] &7%player% was poisoned'
Magic: '&8[&c!&8] &7%player% was killed by magic'
Wither: '&8[&c!&8] &7%player% withered away'
FallingBlock: '&8[&c!&8] &7%player% was squashed by a falling block'
Thorns: '&8[&c!&8] &7%player% was killed while trying to hurt %killer%'
DragonBreath: '&8[&c!&8] &7%player% was roasted in dragon breath'
Kinetic: '&8[&c!&8] &7%player% experienced kinetic energy'
HotFloor: '&8[&c!&8] &7%player% discovered the floor was lava'
Cramming: '&8[&c!&8] &7%player% was squished to death'
Dryout: '&8[&c!&8] &7%player% dried out'
Freeze: '&8[&c!&8] &7%player% froze to death'
Default: '&8[&c!&8] &7%player% died'