GroupeZ Docs
Configuration

Main Configuration

Configure zKoth settings in config.yml

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

The config.yml file contains global settings for the zKoth plugin.

Debug Settings

# Displays more information in the console
enableDebug: false

# Enables time debugs for performance measurement
enableDebugTime: false

Performance Settings

# Milliseconds between PlayerMoveEvent checks
# Higher values reduce server load but decrease responsiveness
playerMoveEventCooldown: 50

# Milliseconds between scheduler ticks
schedulerMillisecond: 1000

Message Display Timing

Cooldown Messages

Seconds before KOTH start when messages are displayed:

displayMessageCooldown:
  - 300  # 5 minutes
  - 120  # 2 minutes
  - 60   # 1 minute
  - 30
  - 10
  - 5
  - 4
  - 3
  - 2
  - 1

Capture Messages

Seconds remaining during capture when messages are displayed:

displayMessageKothCap:
  - 300
  - 120
  - 60
  - 30
  - 10
  - 5
  - 4
  - 3
  - 2
  - 1

Default Values

Placeholder values when no data is available:

# Displayed when no player is capturing
noPlayer: 'X'

# Displayed when player has no faction/team
noFaction: 'X'

# Displayed when no KOTH is active
noKoth: 'X'

Scoreboard Settings

# Radius (in blocks) for scoreboard display
# Players within this distance see the KOTH scoreboard
scoreboardRadius: 50

Capture Permission

Optionally require permission to capture KOTHs:

# Require permission to capture a KOTH
enableCapturePermission: false

# Permission required (only if above is true)
capturePermission: "zkoth.capture"

Spectators are always blocked from capturing, regardless of this setting.

Team Capture Transfer

teamCaptureTransfer:
  # A teammate already inside the zone takes over the capture
  # when the capturer leaves, dies or disconnects
  enable: true
  # Team IDs that never count as a real team
  # (Wilderness, SafeZone and WarZone for Factions plugins)
  ignoredTeamIds:
    - "0"
    - "-1"
    - "-2"

The timer is not reset during a transfer: the teammate continues the capture where it stopped. Without a team plugin, every player is their own team, so no transfer happens.

Chest Settings

# Seconds before loot chests are removed
removeChestSec: 120

Default Player Result

Values for score placeholders when position doesn't exist:

defaultPlayerResult:
  playerName: "X"
  points: 0
  teamName: "X"
  teamId: "X"
  teamLeader: "X"

Complete Example

# Debug settings
enableDebug: false
enableDebugTime: false

# Performance
playerMoveEventCooldown: 50
schedulerMillisecond: 1000

# Cooldown message timings
displayMessageCooldown:
  - 300
  - 120
  - 60
  - 30
  - 10
  - 5
  - 4
  - 3
  - 2
  - 1

# Capture message timings
displayMessageKothCap:
  - 60
  - 30
  - 10
  - 5
  - 4
  - 3
  - 2
  - 1

# Default placeholders
noPlayer: 'None'
noFaction: 'No Team'
noKoth: 'No KOTH'

# Scoreboard
scoreboardRadius: 100

# Capture permission
enableCapturePermission: false
capturePermission: "zkoth.capture"

# Loot chest removal time
removeChestSec: 180

# Default score display
defaultPlayerResult:
  playerName: "---"
  points: 0
  teamName: "---"
  teamId: "---"
  teamLeader: "---"

KOTH Configuration

Configure individual KOTH events

Scoreboard

Configure KOTH scoreboards

Sur cette page

Debug SettingsPerformance SettingsMessage Display TimingCooldown MessagesCapture MessagesDefault ValuesScoreboard SettingsCapture PermissionTeam Capture TransferChest SettingsDefault Player ResultComplete 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.