Skip to main content

Chat System

CocoGuild includes a built-in chat system for guild and ally communication.

Chat Commandsโ€‹

CommandDescription
/guild chat guild <message>Send a message to all guild members
/guild chat ally <message>Send a message to all allied guild members

Configurationโ€‹

plugins/CocoGuild/config.yml
settings:
chat:
method: "single" # Chat method: single or redis
redis:
host: "localhost"
port: 6379
password: "password"
channel: "cocoguild:chat"
format:
guild: '&8[&#FF3737Guild&8] &#0BFB08{player} &8ยป &f{message}'
ally: '&8[&#FF3737Ally&8] &8[&#FF3737{sender_guild}&8] &#0BFB08{player} &8ยป &f{message}'

Chat Methodsโ€‹

Single Server Modeโ€‹

Default mode for single-server setups:

settings:
chat:
method: "single"

Messages are only visible to players on the same server.

Redis Mode (Cross-Server)โ€‹

For BungeeCord/Velocity networks:

settings:
chat:
method: "redis"
redis:
host: "localhost"
port: 6379
password: "your_password"
channel: "cocoguild:chat"

Messages are broadcast across all connected servers.


Chat Format Variablesโ€‹

VariableDescription
{player}The player who sent the message
{message}The chat message content
{sender_guild}The sender's guild name (ally chat only)

Social Spyโ€‹

Admins can monitor all guild and ally chat using Social Spy:

/guild admin socialspy

Permission: cocoguild.admin.socialspy

When enabled, admins will see all guild/ally messages from all guilds.


Chat Examplesโ€‹

Guild Chatโ€‹

Player types: /guild chat guild Hello team!
Guild members see: [Guild] PlayerName ยป Hello team!

Ally Chatโ€‹

Player types: /guild chat ally Need backup at spawn!
Allied guild members see: [Ally] [SenderGuild] PlayerName ยป Need backup at spawn!

Required Permissionโ€‹

settings:
permissions:
chat:
permission: cocoguild.chat
default: player

The cocoguild.chat permission is required to use guild chat (default: enabled for all players).