Team Integration

CocoKOTH supports team-based gameplay through integration with team plugins. This allows Score mode to track scores per team instead of per player.

Supported Integrations

Mode	Description
cocoguild	Direct integration with CocoGuild plugin
placeholder	Use any PlaceholderAPI placeholder as team identifier

Configuration

plugins/CocoKoth/config.yml

team:
  enabled: true
  
  # Team mode: "cocoguild" or "placeholder"
  mode: "cocoguild"
  
  # For placeholder mode: the placeholder that returns team name
  placeholder: "%cocoguild_guild_name%"
  
  # Text shown when player has no team (placeholder mode only)
  no_team_placeholder: "-"
  
  # Should solo player wins count in leaderboards?
  count-player-wins-in-top: false

CocoGuild Mode

When using cocoguild mode:

1. Install CocoGuild plugin
2. Set mode: "cocoguild" in config
3. Enable team-mode: true in your Score KOTH config

The plugin automatically detects player guilds and tracks scores per guild.

Placeholder Mode

Placeholder mode allows integration with any plugin that provides a team/faction/clan placeholder:

team:
  enabled: true
  mode: "placeholder"
  placeholder: "%factions_faction_name%"  # Example: Factions
  no_team_placeholder: "-"

Compatible Plugins

Any plugin with PlaceholderAPI support that provides a team/group name:

• Factions: %factions_faction_name%
• Towny: %towny_town%
• SimpleClans: %simpleclans_clan_name%
• Kingdoms: %kingdoms_kingdom_name%
• mcMMO Parties: %mcmmo_party_name%

Team Mode in KOTHs

Enable team mode in individual KOTH configurations:

plugins/CocoKoth/koths/team-koth.yml

mode: SCORE

settings:
  team-mode: true  # Enable team scoring
  capture-time-seconds: -1
  max-time-seconds: 1200

How Team Mode Works

1. Scores are tracked per team, not per player
2. All team members contribute to the team's score
3. The scoreboard shows top teams
4. The last capturer from the winning team receives rewards

Team Display Format

Customize how teams are displayed in messages:

plugins/CocoKoth/locale/messages_en.yml

teams:
  # Format for team name display
  team-format: "&8[&#FF8000%team%&8]&r"
  
  # Player with team in messages
  team-player: "&#FF8000%player% &7• &#FF8000%team%&f"
  
  # Player without team
  player: "&#FF8000%player%&f"