GroupeZ Docs
Configuration

Discord Webhook

Send KOTH events to Discord

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

zKoth can send event notifications to Discord via webhooks.

Basic Setup

  1. Create a webhook in your Discord channel settings
  2. Copy the webhook URL
  3. Configure it in your KOTH file
webhook:
  enable: true
  url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_TOKEN"
  events:
    START:
      event: START
      title: 'KOTH Started'
      description: "KOTH %name% has started!"
      color:
        r: 40
        g: 240
        b: 40

Available Events

EventDescription
SPAWNKOTH spawned (enters cooldown)
STARTKOTH started (capture begins)
STOPKOTH stopped
START_CAPPlayer started capturing
WINPlayer/team won
LOOSEPlayer lost capture progress

Event Configuration

Each event can have its own embed configuration:

webhook:
  enable: true
  url: "https://discord.com/api/webhooks/..."

  events:
    START:
      event: START
      title: 'KOTH Started'
      description: "KOTH **%name%** has started!"
      url: "https://your-server.com/koth"  # Optional link
      color:
        r: 0
        g: 255
        b: 0
      footer:
        text: "zKoth Events"
        iconUrl: "https://example.com/icon.png"
      thumbnail: "https://example.com/thumbnail.png"
      image: "https://example.com/image.png"
      author:
        name: "KOTH System"
        url: "https://your-server.com"
        iconUrl: "https://example.com/author.png"
      fields:
        - name: "Location"
          value: "%centerX%, %centerY%, %centerZ%"
          inline: true
        - name: "World"
          value: "%world%"
          inline: true

Embed Properties

Basic Properties

PropertyDescription
titleEmbed title
descriptionMain text content
urlLink when clicking title
colorRGB color values
footer:
  text: "Footer text"
  iconUrl: "https://example.com/icon.png"

Author

author:
  name: "Author Name"
  url: "https://example.com"
  iconUrl: "https://example.com/author.png"

Images

thumbnail: "https://example.com/thumbnail.png"  # Small image
image: "https://example.com/image.png"          # Large image

Fields

fields:
  - name: "Field Title"
    value: "Field content"
    inline: false  # Full width

  - name: "Inline Field"
    value: "Content"
    inline: true   # Side by side

Placeholders

All KOTH placeholders work in webhook messages:

PlaceholderDescription
%name%KOTH name
%world%World name
%centerX%, %centerY%, %centerZ%Center coordinates
%playerName%Capturing/winning player
%teamName%Player's team
%captureFormat%Formatted capture time

Complete Example

webhook:
  enable: true
  url: "https://discord.com/api/webhooks/123456789/abcdefg"

  events:
    SPAWN:
      event: SPAWN
      title: '⚔️ KOTH Spawning!'
      description: |
        **%name%** will start soon!

        Get ready to capture!
      color:
        r: 255
        g: 200
        b: 0
      footer:
        text: "Server KOTH Events"
        iconUrl: "https://groupez.dev/storage/images/9.png"
      fields:
        - name: "📍 Location"
          value: "`%centerX%, %centerY%, %centerZ%`"
          inline: true
        - name: "🌍 World"
          value: "`%world%`"
          inline: true

    START:
      event: START
      title: '🏰 KOTH Active!'
      description: "**%name%** is now capturable!"
      color:
        r: 0
        g: 255
        b: 100
      footer:
        text: "zKoth"
        iconUrl: "https://groupez.dev/storage/images/9.png"

    WIN:
      event: WIN
      title: '🏆 KOTH Captured!'
      description: |
        **%playerName%** has captured **%name%**!

        Congratulations!
      color:
        r: 255
        g: 215
        b: 0
      footer:
        text: "Winner!"
        iconUrl: "https://groupez.dev/storage/images/9.png"
      fields:
        - name: "👤 Player"
          value: "%playerName%"
          inline: true
        - name: "👥 Team"
          value: "%teamName%"
          inline: true
        - name: "⏱️ Time"
          value: "%captureFormat%"
          inline: true

    STOP:
      event: STOP
      title: '🛑 KOTH Ended'
      description: "**%name%** has been stopped."
      color:
        r: 255
        g: 50
        b: 50
      footer:
        text: "Event ended"

Multiple KOTHs

Each KOTH can have different webhook configurations or share the same URL:

# koth1.yml
webhook:
  enable: true
  url: "https://discord.com/api/webhooks/channel1/..."
  events:
    # ...

# koth2.yml
webhook:
  enable: true
  url: "https://discord.com/api/webhooks/channel2/..."  # Different channel
  events:
    # ...

Tips

  1. Test your webhook - Use a test channel first
  2. Don't spam - Disable less important events
  3. Use colors - Make events visually distinct
  4. Keep descriptions short - Discord has character limits
  5. Use inline fields - For compact information display

Loot Configuration

Configure KOTH rewards and loot

Placeholders

Available placeholders in zKoth

Sur cette page

Basic SetupAvailable EventsEvent ConfigurationEmbed PropertiesBasic PropertiesFooterAuthorImagesFieldsPlaceholdersComplete ExampleMultiple KOTHsTips
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.