GroupeZ Docs
Configuration

Loot Configuration

Configure KOTH rewards and loot

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

Configure rewards that winners receive when capturing a KOTH.

Basic Structure

loot:
  # Number of random items to give (-1 for all)
  random: 3

  # Distribution type: DROP, CHEST, INVENTORY, NONE
  type: INVENTORY

  # Item list (configure with /zkoth loot <name>)
  items: []

Loot Types

NONE

No item rewards, only commands are executed:

loot:
  type: NONE
  items: []

Use with endCommands for command-only rewards.

INVENTORY

Items go directly to the winner's inventory:

loot:
  random: 3
  type: INVENTORY
  items: []

If inventory is full, remaining items drop on the ground.

DROP

Items drop on the ground at the KOTH center:

loot:
  random: 5
  type: DROP
  items: []

CHEST

A chest spawns at the KOTH center with the loot:

loot:
  random: -1  # All items
  type: CHEST
  items: []

The chest is removed after removeChestSec seconds (configured in config.yml).

Random Selection

loot:
  # Number of items to randomly select
  random: 3    # Give 3 random items
  random: -1   # Give all items
  random: 1    # Give 1 random item

Configuring Items

Using the GUI

The easiest way to configure loot:

  1. Run /zkoth loot <name>
  2. Place items in the inventory
  3. Close to save

Manual Configuration

Items are stored in Base64 format in the YAML:

loot:
  random: 3
  type: INVENTORY
  items:
    - "H4sIAAAAAA..."  # Encoded item
    - "H4sIAAAAAA..."
    - "H4sIAAAAAA..."

Always use the GUI command to configure items. The Base64 encoding is handled automatically.

Combining with Commands

Loot works alongside command rewards:

# Regular command rewards (always given)
endCommands:
  - "eco give %playerName% 5000"
  - "bc &a%playerName% won the KOTH!"

# Random command rewards
randomEndCommands:
  commandAmount: 1
  commands:
    - percent: 80
      commands:
        - "give %playerName% golden_apple 3"
    - percent: 20
      commands:
        - "give %playerName% enchanted_golden_apple 1"

# Item loot (additional to commands)
loot:
  random: 2
  type: INVENTORY
  items: []  # Configure with /zkoth loot

Examples

Command-Only Rewards

# No item loot
loot:
  type: NONE
  items: []

# All rewards via commands
endCommands:
  - "eco give %playerName% 10000"
  - "crate give %playerName% koth 1"
  - "give %playerName% diamond 10"

Guaranteed + Random Items

# Give 3 random items from the loot pool
loot:
  random: 3
  type: INVENTORY
  items: []  # Add items with /zkoth loot

# Also give guaranteed rewards
endCommands:
  - "give %playerName% diamond 5"  # Always get 5 diamonds

Chest Loot Box

# Spawn a loot chest with all items
loot:
  random: -1
  type: CHEST
  items: []

# Remove chest after 2 minutes (config.yml)
# removeChestSec: 120

Drop Party Style

# Drop all items on the ground
loot:
  random: -1
  type: DROP
  items: []

# Announce the drop
endCommands:
  - "bc &6&lLOOT DROP! &eItems are falling at the KOTH!"

Best Practices

  1. Balance rewards - Make rewards worth the effort
  2. Use random selection - Keeps rewards exciting
  3. Combine methods - Use both loot and commands
  4. Test thoroughly - Verify items appear correctly
  5. Consider inventory space - Use DROP or CHEST for many items

Troubleshooting

Items Not Appearing

  1. Check loot type isn't NONE
  2. Verify items were saved (re-open /zkoth loot)
  3. Check console for errors
  4. Ensure inventory has space (for INVENTORY type)

Chest Not Spawning

  1. Verify type is CHEST
  2. Check the spawn location is valid
  3. Ensure no blocks are in the way
  4. Check removeChestSec isn't too low

Scoreboard

Configure KOTH scoreboards

Discord Webhook

Send KOTH events to Discord

Sur cette page

Basic StructureLoot TypesNONEINVENTORYDROPCHESTRandom SelectionConfiguring ItemsUsing the GUIManual ConfigurationCombining with CommandsExamplesCommand-Only RewardsGuaranteed + Random ItemsChest Loot BoxDrop Party StyleBest PracticesTroubleshootingItems Not AppearingChest Not Spawning
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.