Documentation: Click Here
Discord: Click Here
Required Dependencies:
Features
Channels
PlaceholderAPI Support
Supports mini-message and legacy color codes
Advanced Chat Filter
Chat Mentions
DISCORD ALERTS
MOTD
Discord: Click Here
Required Dependencies:
- Skript v2.11+
- SkBee v3.12.2+ (v3.19.0+ is preferred)
- skript-yaml v1.6+
- skript-reflect v2.6+
- PlaceholderAPI (required for custom placeholders)
- Vault and/or LuckPerms (for prefix/suffix placeholders)
Features
Channels
- Staff Channels
- Custom-defined channels
- /chat <channel>
- Slowmode
- Cross-server chats
- Messaging to/from discord
- Cross-server Direct messaging
- /clearchat
- Join/leave messages
Sample configuration for a channel.
YAML:
default-channel: "global"
channels:
global:
enabled: true
require-permissions:
# if enabled, users are required to have "astrachat.channels.global.read" to read messages
read: false
# if enabled, users are required to have "astrachat.channels.global.write" to send messages
write: false
format: "%prefix%%player%%suffix%<white>: %message%"
# duration between each message in ticks
# players with the "astrachat.channels.global.manage" permission can change this with /slowmode <channel> <time>
# slowmode can be bypassed with the "astrachat.channels.global.manage" or "astrachat.admin" permissions
default-slowmode: 20
# use this in front of a message to type in this chat without switching channels.
# leave blank to disable.
shortcut-prefix: ""
# if this chat should be sent to other servers.
# this must be enabled on all servers with this channel
# must have redis enabled and setup
cross-server: false
# you can use these commands to talk in this chat
# using /global <message> would send a message in global chat
commands:
# - global
# allow sending messages to and from discord
# must have discord setup and enabled
discord:
enabled: false
# the format of discord messages that are displayed in game
# available placeholders:
# - %nickname% their name as shown in the guild
# - %display-name% their discord display name
# - %username% their discord username
# - %member-id% their discord id
# - %guild-name% the guild/server name
# - %channel-name% the channel name
format: "<light_purple>[DISCORD]</light_purple> <white>%nickname%: %message%"
# to find, enable developer mode in User Settings > Advanced > Developer Mode
# then right click the channel and select Copy Channel ID
channel: "channelId"
# Supports embeds. See documentation for detailed usage.
# See: https://astradev.gitbook.io/astrachat/configuration/discord#discord-message-format
discord-format:
# whether to enable/disable mentions
# setting this to false prevents people from using @everyone in-game
allow-mentions: false
content: "**%player%**: %message%"
PlaceholderAPI Support
Supports mini-message and legacy color codes
Advanced Chat Filter
- Define custom filter rules
- Censor bad words
- Punish players
- Block messages
- Regex
Chat Mentions
YAML:
# if you type a user's name in chat, it will mention them.
chat-mentions:
enabled: true
# cooldown in ticks
# can be bypassed with the "astrachat.channels.<channel>.manage" or "astrachat.admin" permissions
cooldown: 0
# maximum amount of mentions per message.
# set to 0 for none
# can be bypassed with the "astrachat.channels.<channel>.manage" or "astrachat.admin" permissions
limit-per-message: 0
format: "<aqua>@%target%</aqua>"
actions:
# leave blank to disable
# available placeholders:
# - %sender% the person who mentioned them
# - %target% the person being mentioned
message: "<aqua>%sender%</aqua> mentioned you in chat!"
# leave blank to disable
sound: "minecraft:block.note_block.pling"
DISCORD ALERTS
- Joins/quit messages
- Death messages
- Server start/stop
YAML:
[/SIZE]
discord:
enabled: false
guild: ""
token: "YOUR_TOKEN_HERE"
# All message support embeds. See documentation for detailed usage.
# See: https://astradev.gitbook.io/astrachat/configuration/discord#discord-message-format
logging:
pvp-death:
enabled: true
channel: "channelId"
# available placeholders:
# - %victim%
# - %attacker%
# - %death-message%
message:
embed:
color: "#990000"
author:
name: "%victim% was slain by %attacker%"
icon-url: "https://mc-heads.net/avatar/%uuid%/64"
non-pvp-death:
enabled: true
channel: "channelId"
# available placeholders:
# - %victim%
# - %death-message%
message:
content: "%death-message%"
death:
enabled: true
channel: "channelId"
# available placeholders:
# - %victim%
# - %death-message%
message:
content: "%death-message%"
join:
enabled: true
channel: "channelId"
message:
embed:
color: "#00ff00"
author:
name: "%player% joined the game"
icon-url: "https://mc-heads.net/avatar/%uuid%/64"
quit:
enabled: true
channel: "channelId"
message:
embed:
color: "#ff0000"
author:
name: "%player% quit the game"
icon-url: "https://mc-heads.net/avatar/%uuid%/64"
server-start:
enabled: true
channel: "channelId"
message:
content: "Server started"
server-stop:
enabled: true
channel: "channelId"
message:
content: "Server stopped"
[SIZE=4]
MOTD
- Fancy head MOTDs
YAML:
motd:
enabled: true
# available modes:
# - "skull"
# - "default"
mode: "skull"
# the following options apply when mode is set to "skull"
skull:
# uuid of the skull you want to display. supports placeholders.
# this is used before player joins the world, not all placeholders will be supported.
uuid: "%uuid%"
# how big the skull should be. Use multiples of 8 to avoid image distortion (8, 16, 24)
size: 8
# if both skin layers of the skull should be shown
overlay: true
header:
- "<gray><strikethrough> "
# up to the same amount of lines as the skull size
body:
- ""
- "<white>Hello <aqua>%player%</aqua>! Welcome to <aqua>AstraChat"
- "<white>You can edit the config in"
- "<aqua>plugins/AstraChat/config.yml"
- ""
- "<white>Use <aqua>/astrachat reload</aqua> to reload"
footer:
- "<gray><strikethrough> "
default:
text:
- "<gray><strikethrough> "
- "<white>Hello <aqua>%player%</aqua>! Welcome to <aqua>AstraChat"
- "<white>You can edit the config in <aqua>plugins/AstraChat/config.yml"
- ""
- "<white>Use <aqua>/astrachat reload</aqua> to reload"
- "<gray><strikethrough> "
