keyboardInformation

Welcome to the official documentation for SDChat, a Minecraft plugin designed to enhance in-game chat experiences.

Introduction

SDChat is a powerful Minecraft chat plugin that offers advanced chat customization, including interactive messages, chat games, and item hovers. It’s perfect for servers that want to provide a unique and engaging chat experience for their players.

Features

  • You are in control! - Enable or Disable any feature of this plugin.

  • 🔧 Interactive Chat Messages: Add clickable and hoverable text in chat.

  • 🔗 Item/Inventory Linking: Show off your inventory, enderchest, or items in chat!

  • 🎮 Chat Games: Keep your players entertained with various chat mini-games.

  • 🚨 Advanced Moderation Tools: Mute, clear, slow, and filter chat with ease.

  • 🌈 Custom Chat Formatting: Personalize the look and feel of your server chat.

  • 📊 Message Logging: Keep records of all chat messages for review.

  • 💀 Custom Death Messages: Edit and change all death messages to your liking.

  • ‼️ Timed Announcements: Create infinite announcement messages on a timer.

  • 🛠️ Staff Chat: Take advantage of our fully customizable in-game staff chat!

  • Player Mentioning alerts: Get notified if a player mentions your name!

  • 🔐 Command & Word Blocker: Block specific commands and words!

  • 🤖 Anti-Spam & Anti-Bot: Protect your chat with our anti-bot features!

📥 Installation

Prerequisites

  • Minecraft server running Spigot version 1.21 or higher.

  • LuckPerms must be installed

  • PlaceholderAPI must be installed

Steps

  1. Download the SDChat Plugin jar from BuiltByBitarrow-up-right.

  2. Place the jar file into your server's 'plugins' directory.

  3. Restart your server to load the plugin.

👨‍💻 Configuration

After installation, you can customize SDChat through the config.yml file located in the plugins/SDChat directory.

Key Configuration Options

  • 'Chat-Format' : Customize the format of chat messages.

  • 'Use-Logging' : 'true' or 'false' - Whether the plugin will log chat messages and DM's to a file.

For a full list of configuration options, visit the Configuration section.

🔧 Commands & Permissions

Commands

Command
Description
Usage

/sdchat

General Command

/sdchat

/mutechat

Mute or Unmute public chat

/mutechat

/clearchat

Clears the in-game chat

/clearchat

/slowchat

Limits how often players can talk in chat

(in seconds)

/slowchat <seconds>

/message /msg

Private message other players

/message <player> <text>

/reply /r

Easily respond to a private message

/reply <text>

/nickname /nick

Change your name in chat (Nickname)

/nick <nickname> /nick reset

/block

Block a player from showing up in chat & messaging you (run again to unblock)

/block <player>

/staffchat

Chat privately amongst all online staff

/staffchat <message> /staffchat - toggle

/messagespy /spy

Spy on all private messages

/messagespy

/helpop

Send a message to all online staff members

/helpop <message>

/report

Send a report to all online staff members

/report <message>

/viewreports

View all past reports

/viewreports

/trash

Open a virtual trash bin to dispose of items

/trash

/playertime /ptime

Change your individual time

/ptime <ticks>

/time

Change server-wide time

/time <ticks>

/playerweather /pweather

Change your individual weather

/pweather <clear/downfall>

/weather

Change server-wide weather

/weather <clear/downfall>

/chatgames /chatgames start

Shows if there is an active game or not Starts a chatgame

/chatgames /chatgames start

/broadcast

Sends an alert to all online players

/broadcast <message>

Permissions

Permission
Description

"sdchat.mutechat"

Allows muting / unmuting of public chat

"sdchat.mutechat.bypass"

Allows a player to bypass muted chat.

"sdchat.mutechat.notify"

Sends an alert when chat is muted / unmuted.

"sdchat.clearchat"

Allows a player to clear the chat for all players.

"sdchat.slowchat"

Allows a player to slow down chat by setting a delay between messages.

"sdchat.slowchat.bypass"

Allows a player to bypass the chat slow mode.

"sdchat.slowchat.notify"

Sends an alert when chat is slowed.

"sdchat.filter.bypass"

Allows a player to bypass chat filters, including duplicate messages, advertising, and anti-caps.

"sdchat.blocker.bypass"

Allows a player to bypass command blockers.

"sdchat.staffchat"

Allows staff to talk privately

"sdchat.message"

Allows a player to use private messaging commands such as /msg and /r.

"sdchat.message.toggle"

Allows a player to toggle receiving private messages. /r bypasses this toggle.

"sdchat.chat.color"

Allows a player to use color codes in chat.

"sdchat.nickname"

Allows a player to set or change their nickname.

"sdchat.nickname.color"

Allows a player to use color codes in their nickname.

"sdchat.block"

Allows a player to block messages from a specific player.

"sdchat.block.bypass"

Allows a player to bypass being blocked by others.

"sdchat.message.spy"

Allows a player to spy on private messages.

"sdchat.helpop"

Allows a player to send help messages to staff using /helpop.

"sdchat.helpop.receive"

Allows staff to receive helpop messages.

"sdchat.report"

Allows a player to send report messages to staff using /report.

"sdchat.report.receive"

Allows staff to receive report messages.

"sdchat.viewreports"

Allows staff to view all submitted reports

"sdchat.trash"

Allows a player to use the trash command to discard items.

"sdchat.ptime"

Allows a player to set their personal time using the /ptime command.

"sdchat.time"

Allows a player to change server-wide time using the /time command.

"sdchat.pweather"

Allows a player to set their personal weather using the /pweather command.

"sdchat.weather"

Allows a player to change server-wide weather using the /weather command.

"sdchat.chatgames.admin"

Allows access to chat game administration commands, such as starting games with /chatgames start.

"sdchat.broadcast"

Allows a player to use the broadcast command to send server-wide messages.

Last updated