> 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'
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.pixel-dev.net/sdchat/configuration.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.