GroupeZ Docs

KOTH Configuration

Configure individual KOTH events

Cette page est affichée en anglais car sa traduction française n’est pas encore disponible.

Each KOTH is configured in its own YAML file in the plugins/zKoth/koths/ folder.

Basic Settings

# Display name for the KOTH event
name: castle

# Type of KOTH: CAPTURE or SCORE
type: CAPTURE

# For CAPTURE: seconds needed to capture
# For SCORE: points needed to win
capture: 30

# Cooldown in seconds before KOTH can be spawned again
cooldownStart: 300

# Auto-stop KOTH after this many seconds
stopAfterSeconds: 3600

KOTH Types

CAPTURE Type

Players must hold the zone for a continuous duration to win:

type: CAPTURE
capture: 60  # 60 seconds to capture
  • Timer resets if the capturing player leaves
  • First to complete the capture timer wins

SCORE Type

Players earn points while in the zone:

type: SCORE
capture: 100  # 100 points to win
  • Points accumulate while in the zone
  • Leaving doesn't reset points
  • First to reach the score target wins

Location Configuration

Zone corners are set when creating the KOTH:

minLocation:
  world: world
  x: 100
  y: 64
  z: 200

maxLocation:
  world: world
  x: 110
  y: 70
  z: 210

Use /zkoth move <name> to change the location instead of editing manually.

Message Settings

Control which messages are displayed:

# Message when a player starts capturing
enableStartCapMessage: true

# Message when a player loses capture progress
enableLooseCapMessage: true

# Periodic messages during capture
enableEverySecondsCapMessage: false

# Periodic messages during cooldown
enableEverySecondsCooldownMessage: false

Commands

Start Commands

Executed when the KOTH starts (enters COOLDOWN or START):

startCommands:
  - "bc &6&l[KOTH] &e%name% has spawned!"
  - "bc &7Location: &f%centerX%, %centerY%, %centerZ%"

End Commands

Executed when a player wins:

endCommands:
  - "bc &6&l[KOTH] &a%playerName% &ehas captured %name%!"
  - "eco give %playerName% 5000"
  - "give %playerName% diamond 10"

Random End Commands

Execute random commands with configurable probability:

randomEndCommands:
  # Number of commands to randomly select
  commandAmount: 2

  commands:
    - percent: 50  # 50% chance
      commands:
        - "give %playerName% diamond 5"

    - percent: 30  # 30% chance
      commands:
        - "give %playerName% emerald 10"

    - percent: 20  # 20% chance
      commands:
        - "give %playerName% netherite_ingot 1"
        - "bc &6%playerName% got a rare reward!"

Command Placeholders

PlaceholderDescription
%playerName%Winner's name
%teamName%Winner's team name
%teamId%Winner's team ID
%teamLeader%Team leader name
%name%KOTH name
%world%KOTH world
%centerX%Center X coordinate
%centerY%Center Y coordinate
%centerZ%Center Z coordinate
%minX%, %minY%, %minZ%Min corner
%maxX%, %maxY%, %maxZ%Max corner
%captureSeconds%Capture time
%captureFormat%Formatted capture time
%spawnSeconds%Spawn countdown
%spawnFormat%Formatted spawn time
%online-player%All online team members

Team Blacklist

Prevent certain team IDs from participating:

blacklistTeamId:
  - "0"      # No team
  - "-1"     # System teams
  - "spawn"  # Specific team

Progress Bar

Configure the capture progress bar for placeholders:

progressBar:
  length: 20
  symbol: "|"
  completedColor: "#2fedc7"
  notCompletedColor: "#8f8f8f"

Complete Example

# Basic settings
name: Castle KOTH
type: CAPTURE
capture: 60
cooldownStart: 300
stopAfterSeconds: 3600

# Messages
enableStartCapMessage: true
enableLooseCapMessage: true
enableEverySecondsCapMessage: false
enableEverySecondsCooldownMessage: false

# Locations
minLocation:
  world: world
  x: 100
  y: 64
  z: 200
maxLocation:
  world: world
  x: 120
  y: 80
  z: 220

# Commands
startCommands:
  - "bc &6&l[KOTH] &eCastle KOTH has spawned!"
  - "bc &7Capture it at &f%centerX%, %centerY%, %centerZ%"

endCommands:
  - "bc &6&l[KOTH] &a%playerName% &ehas captured Castle!"
  - "eco give %playerName% 10000"
  - "give %playerName% diamond_block 5"

randomEndCommands:
  commandAmount: 1
  commands:
    - percent: 70
      commands:
        - "give %playerName% golden_apple 3"
    - percent: 25
      commands:
        - "give %playerName% enchanted_golden_apple 1"
    - percent: 5
      commands:
        - "give %playerName% netherite_ingot 1"
        - "bc &d&l%playerName% got a legendary reward!"

# Team blacklist
blacklistTeamId:
  - "0"
  - "-1"

# Progress bar
progressBar:
  length: 20
  symbol: "█"
  completedColor: "#00ff00"
  notCompletedColor: "#555555"

# Scoreboard (see scoreboard configuration)
scoreboard:
  cooldown:
    enable: true
    # ...
  start:
    enable: true
    # ...

# Hologram (see hologram configuration)
hologram:
  enable: false
  # ...

# Discord webhook (see webhook configuration)
webhook:
  enable: false
  # ...

# Loot (see loot configuration)
loot:
  random: 3
  type: INVENTORY
  items: []

Commands & Permissions

Complete list of zKoth commands and permissions

Main Configuration

Configure zKoth settings in config.yml

Sur cette page

Basic SettingsKOTH TypesCAPTURE TypeSCORE TypeLocation ConfigurationMessage SettingsCommandsStart CommandsEnd CommandsRandom End CommandsCommand PlaceholdersTeam BlacklistProgress BarComplete Example
GroupeZ MCP

La documentation dans ton IA

Le MCP permet à ton IA de chercher dans la documentation GroupeZ et de lire les exemples à jour pour t’aider à configurer tes plugins.

Lecture seule · Sans clé API côté documentation

1. Copie l’adresse du serveur

Transport : HTTP (Streamable HTTP). Authentification : aucune. Ton outil utilise son propre modèle et ses propres limites d’abonnement.

  1. Ouvre Plugins dans ChatGPT sur le web, puis + → Ajouter un serveur MCP personnalisé.
  2. Nomme-le « GroupeZ Documentation », colle l’URL ci-dessus et choisis « Aucune authentification ». Crée puis installe le plugin.
  3. Dans une conversation, tape @ et sélectionne ce plugin avant d’envoyer ta question. Si nécessaire, active search, get_page et list_pages dans ses paramètres.
Guide officiel de cet outil

3. Pose une question

Utilise le MCP GroupeZ pour m’aider à créer un inventaire zMenu. Recherche les pages pertinentes, lis les exemples et cite tes sources.
Autres clients et dépannage

Pour les clients utilisant mcpServers, adapte cet exemple à leur format :

{
  "mcpServers": {
    "groupez-docs": {
      "url": ""
    }
  }
}

Les outils disponibles sont search, get_page et list_pages. Après une mise à jour, actualise les outils du connecteur. Si ton IA n’y accède pas, vérifie que le connecteur est activé dans la conversation et que ton compte autorise les MCP personnalisés. Ouvrir l’URL dans un navigateur n’est pas un test MCP.