GroupeZ Docs
Configuration

Configuration Principale

Options de configuration principales pour zSpawner

Cette page couvre les options de configuration principales disponibles dans config.yml.

Paramètres Généraux

# Affiche plus d'informations dans la console
# Activez ceci lors du signalement de problèmes au support
enableDebug: false

# Active les debugs de temps pour la mesure des performances
enableDebugTime: false

# Intervalle de mise à jour des données en millisecondes (défaut : 2 minutes)
updateInterval: 120000

Configuration du Stockage

zSpawner supporte les backends de stockage SQLite et MySQL/MariaDB.

SQLite

Option de stockage par défaut, ne nécessite aucune configuration supplémentaire :

storage: SQLITE

MySQL / MariaDB

Pour les environnements de production :

storage: MYSQL

database-configuration:
  table-prefix: "zspawner_"
  user: homestead
  password: secret
  port: 3306
  host: 192.168.10.10
  debug: false
  database: zspawner
OptionDescription
table-prefixPréfixe pour toutes les tables de base de données
userNom d'utilisateur de la base de données
passwordMot de passe de la base de données
portPort de la base de données
hostAdresse hôte de la base de données
debugActiver la journalisation de debug de la base de données
databaseNom de la base de données

Items de Spawner

Configurez les items que les joueurs reçoivent lorsqu'on leur donne des spawners :

items:
  CLASSIC:
    material: SPAWNER
    name: "&6&lSpawner &r&8- &f%type%"
    lore:
      - "&8Placez le spawner sur le sol"
    flags:
      - HIDE_POTION_EFFECTS

  GUI:
    material: SPAWNER
    name: "&6&lSpawner &r&8- &f%type%"
    lore:
      - "&8Placez le spawner et trouvez-le"
      - "&8dans &7/spawners"
    flags:
      - HIDE_POTION_EFFECTS

  VIRTUAL:
    material: SPAWNER
    name: "&6&lSpawner &r&8- &f%type%"
    lore:
      - "&8Spawner virtuel, placez-le pour l'utiliser"
    flags:
      - HIDE_POTION_EFFECTS
PlaceholderDescription
%type%Nom du type d'entité (ex: "ZOMBIE", "SKELETON")

Protection contre les Explosions

Configurez le comportement des spawners lors d'explosions :

# Désactiver la destruction des spawners par explosions
disableSpawnerExplosion:
  GUI: true
  CLASSIC: true
  VIRTUAL: true  # Toujours true, ne peut pas être changé

# Dropper les spawners lors de la destruction par explosion
dropSpawnerOnExplose:
  GUI: false
  CLASSIC: false
  VIRTUAL: false  # Toujours false

# Protéger les spawners naturels (vanilla) des explosions
disableNaturalSpawnerExplosion: false

# Dropper les spawners naturels lors de la destruction par explosion
dropNaturalSpawnerOnExplose: false

Limite par Chunk

Limiter le nombre de spawners pouvant être placés par chunk :

chunkLimit:
  # Activer la limitation des spawners par chunk
  enable: false

  # Limite globale par chunk
  global: 5

  # Limites par entité
  limits:
    - SKELETON: 10

Liste Noire de Blocs

Empêcher les spawners d'être placés sur certains blocs :

blacklistBlocks:
  - CHEST
  - DROPPER
  - TRAPPED_CHEST
  - CAULDRON
  - FURNACE
  - ENDER_CHEST
  - BEDROCK
  - BREWING_STAND
  - DISPENSER
  - OBSIDIAN
  - SPAWNER
  - DIAMOND_BLOCK
  - GOLD_BLOCK
  - IRON_BLOCK
  - NETHERITE_BLOCK

Permission de Casse par le Propriétaire

Permettre aux propriétaires de spawners de casser leurs spawners GUI :

# Le propriétaire peut casser pour remettre le spawner dans /spawners
ownerCanBreakSpawner: true

Matériaux d'Entités

Configurez le matériau d'affichage (œuf de spawn) pour chaque type d'entité dans les GUIs :

entitiesMaterial:
  - ZOMBIE: ZOMBIE_SPAWN_EGG
  - SKELETON: SKELETON_SPAWN_EGG
  - CREEPER: CREEPER_SPAWN_EGG
  - SPIDER: SPIDER_SPAWN_EGG
  - BLAZE: BLAZE_SPAWN_EGG
  # ... plus d'entités

Vous pouvez utiliser les matériaux zMenu incluant les têtes personnalisées :

entitiesMaterial:
  - ZOMBIE: "hdb:12345"  # HeadDatabase
  - SKELETON: "base64:..."  # Texture Base64

Liste Noire de Matériaux

Empêcher certains items d'être stockés dans les spawners virtuels :

blacklist-materials:
  - BOW
  - GOLDEN_SWORD

Casse de Spawner Virtuel

Permettre de casser les blocs/entités où les spawners virtuels génèreraient :

breakUpVirtualSpawner: true

Paramètres d'Expérience

Donner l'expérience directement aux joueurs depuis les spawners virtuels :

give-player-experience: false

Raison de Dépôt

Format du message pour les transactions économiques :

deposit-reason: "Vente de x%amount% %item% pour %price% (Spawner)"

Exemple de Configuration Complète

enableDebug: false
enableDebugTime: false
storage: SQLITE
updateInterval: 120000

database-configuration:
  table-prefix: "zspawner_"
  user: homestead
  password: secret
  port: 3306
  host: 192.168.10.10
  debug: false
  database: zspawner

items:
  CLASSIC:
    material: SPAWNER
    name: "&6&lSpawner &r&8- &f%type%"
    lore:
      - "&8Placez le spawner sur le sol"
  GUI:
    material: SPAWNER
    name: "&6&lSpawner &r&8- &f%type%"
    lore:
      - "&8Placez et accédez via &7/spawners"
  VIRTUAL:
    material: SPAWNER
    name: "&6&lSpawner &r&8- &f%type%"
    lore:
      - "&8Spawner virtuel"

chunkLimit:
  enable: true
  global: 10
  limits:
    - SKELETON: 20
    - BLAZE: 5

disableSpawnerExplosion:
  GUI: true
  CLASSIC: true
  VIRTUAL: true

dropSpawnerOnExplose:
  GUI: false
  CLASSIC: false
  VIRTUAL: false

ownerCanBreakSpawner: true
breakUpVirtualSpawner: true
give-player-experience: false

Placeholders

Placeholders PlaceholderAPI disponibles dans zSpawner

Spawners Virtuels

Configuration et utilisation des Spawners Virtuels dans zSpawner

Sur cette page

Paramètres GénérauxConfiguration du StockageSQLiteMySQL / MariaDBItems de SpawnerProtection contre les ExplosionsLimite par ChunkListe Noire de BlocsPermission de Casse par le PropriétaireMatériaux d'EntitésListe Noire de MatériauxCasse de Spawner VirtuelParamètres d'ExpérienceRaison de DépôtExemple de Configuration Complète
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.