config.yml Reference

plugins/AstralChat/config.yml controls which servers are in scope, the global broadcast and private-message formats, the social-spy display, and the channel registry.

Default file

enabled-groups:
  - "spawn"
  - "build"
  - "resource"

formats:
  broadcast: "<newline><#cc2626><bold>[Annonce] <#ff3030>%message%<newline>"
  private-messages: "<hover:show_text:'<#a2d2ff>Clique pour répondre à <#26d971>%sender_name%'><click:suggest_command:'/m %sender_name%'><#93cc89>%sender_name% <gray>›<reset> <#93cc89>%target_name%<gray>:<reset> <#b8ffab><chat>"

social-spy:
  format: "<gray>[[<#cccc88><bold>Spy</bold></#cccc88>]</gray> <#cccc88>%sender% <gray>›<reset> <#cccc88>%recipient%<gray>:<reset> <#ffffaa>%message%"
  permission: "chat.socialspy"
  bypass-permission: "chat.socialspy.bypass"

channels:
  global:
    name: "global"
    default: true
    format: "%chat_prefix%%chat_equippedTag_component% <#bababa>%displayName%<gray>:<reset> <#e9e9e9>%message%"
    filtered: true
    cooldown: "0s"
    auto-subscribe: true

Top-level fields

Field	Type	Description
`enabled-groups`	`List<String>`	Server group names where AstralChat is active. Servers in other groups load the plugin but do not handle chat. The check uses the `group` value from AstralCore's `ServerInformation`.
`formats`	Object	Global MiniMessage formats — see below.
`social-spy`	Object	Social-spy configuration — see below.
`channels`	`Map<String, ChatChannel>`	Channel registry. The map key is internal; the channel's runtime identifier is the `name` field. Exactly one channel must have `default: true`.

`formats`

Field	Type	Description
`broadcast`	MiniMessage	Output of `/broadcast`. Use `%message%` for the broadcast body.
`private-messages`	MiniMessage	Output of `/msg` and `/reply`. Variables: `%sender_name%`, `%target_name%`, `<chat>`.

The private-message format is rendered for both sender and recipient — the same component is sent to each side. Use MiniMessage <hover> and <click> to expose actions (the shipped format suggests /m <sender> on click).

`social-spy`

Field	Type	Description
`format`	MiniMessage	Output for spy receivers. Variables: `%sender%`, `%recipient%`, `%message%`.
`permission`	String	Permission node required to toggle `/socialspy` and receive spy output.
`bypass-permission`	String	Players with this node are never spied on, regardless of their conversations.

`channels`

See Channels for the full schema and per-field behaviour.

Reloading

/channel reload and /chat reload both re-read every YAML in the data folder. Running channels are recreated; pause state survives because it is held in ModerationService, not in the YAML.

Last modified: 25 July 2026