Channels

The chat/channels.yml file allows you to create and manage multiple chat channels for your server.

Global Settings

  • default-channel: The name of the channel that players will join by default when they first connect.

Channel Configuration

For each channel, you can configure:

  • name: The display name of the channel.
  • prefix: A custom prefix that will be added to chat messages sent within this channel. Supports MiniMessage and RGB hex colors.
  • permission: The permission required for a player to join or use this channel (e.g., solaritychat.channel.staff). If left empty, anyone can join.
  • radius: Controls the range of the channel.
    • Set to -1 for global chat (everyone on the server can hear it).
    • Set to a positive number (e.g., 100) for local chat (only players within that many blocks can hear it).
  • auto-join: Set to true if players should automatically join this channel when they connect.

Example Channels

The default configuration includes several useful channels:

  • Global: Global chat for everyone on the server.
  • Local: Range-based chat for players near each other (100 block radius).
  • Staff: Private chat channel for staff members.
  • Admin: Private chat channel for server administrators.

Switching Channels

Players can switch between channels using the /channel <name> command. Example: /channel staff