Installation

Ce guide couvre l'installation et la configuration initiale de zCookieClicker.

PrérequisCopier le lien vers ce titre

Avant l'installation, assurez-vous que votre serveur répond à ces exigences :

Plateformes SupportéesCopier le lien vers ce titre

Étapes d'InstallationCopier le lien vers ce titre

1. Télécharger le PluginCopier le lien vers ce titre

Téléchargez zCookieClicker depuis :

• groupez.dev

2. Installer les DépendancesCopier le lien vers ce titre

Installez la dépendance requise :

1. zMenu - Téléchargez depuis Modrinth et placez le .jar dans votre dossier plugins/. zCookieClicker utilise zMenu pour toutes les interfaces GUI.

3. Installer le PluginCopier le lien vers ce titre

1. Arrêtez votre serveur
2. Placez zCookieClicker.jar dans votre dossier plugins/
3. Démarrez votre serveur
4. Le plugin génèrera tous les fichiers de configuration par défaut

4. Vérifier l'InstallationCopier le lien vers ce titre

Exécutez /cookie en jeu. Si le plugin est correctement chargé, il ouvrira l'interface Cookie Clicker.

Structure des FichiersCopier le lien vers ce titre

Après le premier démarrage, zCookieClicker crée la structure suivante :

plugins/zCookieClicker/
├── config.yml                    # Configuration principale
├── messages.yml                  # Messages du plugin
├── inventories/
│   ├── cookies.yml               # Interface principale
│   └── cookies-upgrade.yml       # Interface des améliorations
└── patterns/
    └── cookie-upgrade.yml        # Pattern des boutons d'amélioration

Configuration de la Base de DonnéesCopier le lien vers ce titre

zCookieClicker supporte trois backends de stockage.

SQLite (Par Défaut)Copier le lien vers ce titre

SQLite est la méthode de stockage par défaut :

sql:
  type: SQLITE

MySQLCopier le lien vers ce titre

Pour les grands serveurs :

sql:
  type: MYSQL
  user: homestead
  password: secret
  port: 3306
  host: 192.168.10.10
  database: zcookieclicker
  prefix: "zcookieclicker_"
  retry: 5
  debug: false

MariaDBCopier le lien vers ce titre

sql:
  type: MARIADB
  user: homestead
  password: secret
  port: 3306
  host: 192.168.10.10
  database: zcookieclicker
  prefix: "zcookieclicker_"
  retry: 5
  debug: false

Première ConfigurationCopier le lien vers ce titre

Après l'installation, voici les premières étapes recommandées :

1. Stockage - Choisissez votre backend de stockage dans config.yml
2. Améliorations - Personnalisez les coûts et valeurs CPS des améliorations
3. Format des Nombres - Configurez l'affichage des grands nombres
4. Messages - Personnalisez les messages du plugin dans messages.yml
5. GUIs - Personnalisez les interfaces cookie et améliorations

Voir la section Configuration pour les options détaillées.

DépannageCopier le lien vers ce titre

Le plugin ne démarre pasCopier le lien vers ce titre

• Vérifiez que Java 17+ est installé : java -version
• Vérifiez que zMenu est installé et se charge sans erreurs
• Vérifiez la console du serveur pour les messages d'erreur

L'interface ne s'ouvre pasCopier le lien vers ce titre

• Vérifiez que zMenu est installé et fonctionne correctement
• Vérifiez que les fichiers d'inventaire existent dans plugins/zCookieClicker/inventories/
• Regardez les erreurs dans la console

Échec de connexion à la base de donnéesCopier le lien vers ce titre

• Vérifiez vos identifiants de base de données dans config.yml
• Assurez-vous que le serveur MySQL/MariaDB est en cours d'exécution
• Vérifiez les paramètres du pare-feu si vous utilisez une base de données distante
• Confirmez que la base de données existe

Les cookies ne se sauvegardent pasCopier le lien vers ce titre

• Vérifiez que la connexion à la base de données fonctionne
• Activez debug: true dans la configuration SQL
• Vérifiez que les tables de base de données ont été créées

Prochaines ÉtapesCopier le lien vers ce titre

• Commandes & Permissions
• Placeholders
• Configuration
• Améliorations