Guild Ranks

CocoGuild has a built-in rank system with three tiers: Owner, Moderator, and Player.

Rank Hierarchy

Rank	Display	Description
👑 Owner	&8[&cOwner&8]	Guild creator/leader with full permissions
⚔️ Moderator	&8[&6Officer&8]	Trusted members with management permissions
👤 Player	&8[&fMember&8]	Regular guild members

Rank Display Customization

plugins/CocoGuild/config.yml

settings:
  rank-display:
    owner: "&8[&cOwner&8]"
    moderator: "&8[&6Officer&8]"
    player: "&8[&fMember&8]"

Rank Permissions

Each rank has different default permissions for guild actions:

Owner Permissions

Action	Allowed
Create Guild	✅ Yes
Delete Guild	✅ Yes
Rename Guild	✅ Yes
Invite Players	✅ Yes
Kick Members	✅ Yes
Transfer Leadership	✅ Yes
Promote Members	✅ Yes
Demote Members	✅ Yes
Manage Alliances	✅ Yes
Toggle PvP	✅ Yes
Leave Guild	❌ No (must transfer first)

Moderator Permissions

Action	Allowed
Create Guild	❌ No
Delete Guild	❌ No
Rename Guild	❌ No
Invite Players	✅ Yes
Kick Members	✅ Yes
Transfer Leadership	❌ No
Promote Members	✅ Yes
Demote Members	✅ Yes
Manage Alliances	✅ Yes
Toggle PvP	✅ Yes
Leave Guild	✅ Yes

Player Permissions

Action	Allowed
Create Guild	❌ No
Delete Guild	❌ No
Rename Guild	❌ No
Invite Players	✅ Yes
Kick Members	❌ No
Transfer Leadership	❌ No
Promote Members	❌ No
Demote Members	❌ No
Manage Alliances	❌ No
Toggle PvP	✅ Yes
Leave Guild	✅ Yes

Customizing Rank Permissions

You can fully customize what each rank can do:

plugins/CocoGuild/config.yml

settings:
  ranks:
    player:
      create: false
      delete: false
      rename: false
      invite: true
      accept: true
      deny: true
      kick: false
      leave: true
      leader: false
      promote: false
      demote: false
      pvp: true
      ally: false
      revoke: false
      allypvp: true
      chat: true
      info: true
      reload: false

    moderator:
      create: false
      delete: false
      rename: false
      invite: true
      accept: true
      deny: true
      kick: true
      leave: true
      leader: false
      promote: true
      demote: true
      pvp: true
      ally: true
      revoke: true
      allypvp: true
      chat: true
      info: true
      reload: false

    owner:
      create: true
      delete: true
      rename: true
      invite: true
      accept: true
      deny: true
      kick: true
      leave: false  # Cannot leave, must transfer leadership
      leader: true
      promote: true
      demote: true
      pvp: true
      ally: true
      revoke: true
      allypvp: true
      chat: true
      info: true
      reload: false

PlaceholderAPI

Placeholder	Description
%cocoguild_guild_rank%	Returns rank name (owner/moderator/player)
%cocoguild_guild_rank_display%	Returns formatted rank display

Promotion/Demotion Commands

/guild promote <player>  - Promote a member (Player → Moderator)
/guild demote <player>   - Demote a member (Moderator → Player)
/guild leader <player>   - Transfer ownership to a member