VERITY MOD HUB

Dépannage de Verity Mod - Résoudre les problèmes courants

Guide complet de dépannage pour Verity Mod - corrigez les erreurs d'installation, les problèmes de connexion IA, les problèmes de performance et les conflits de compatibilité. Solutions étape par étape.

Corrections rapides pour les problèmes courants

Problème : Le mod n’apparaît pas dans Minecraft

Solution :

  1. Vérifiez que vous avez installé la bonne version (Java Edition uniquement)
  2. Assurez-vous que la version de Forge correspond aux exigences du mod
  3. Vérifiez que le fichier .jar est dans le dossier mods correct
  4. Redémarrez complètement Minecraft

Problème : Les fonctionnalités IA ne fonctionnent pas

Solution :

  1. Vérifiez la connexion internet (requise pour l’IA)
  2. Vérifiez que l’API Ollama est opérationnelle (status.ollama.com)
  3. Mettez à jour vers la dernière version du mod
  4. Vérifiez le fichier de configuration du mod

Problème : Problèmes de performance / lag

Solution :

  1. Réduisez la fréquence de réponse de l’IA dans la configuration
  2. Diminuez la distance de rendu
  3. Fermez les applications en arrière-plan
  4. Allouez plus de RAM à Minecraft (4 Go minimum)

Dépannage détaillé par type de problème

Problèmes d’installation

Erreur : “Mod not found” dans Minecraft

Cause : Emplacement d’installation incorrect ou version incompatible

Correction :

1. Ouvrez le dossier Minecraft : %appdata%\.minecraft (Windows) ou ~/Library/Application Support/minecraft (Mac)
2. Vérifiez que le fichier se trouve dans : .minecraft/mods/verity-1.0.0.jar
3. Vérifiez la version de Forge : elle doit correspondre aux exigences du mod
4. Redémarrez Minecraft (pas simplement recharger)

Erreur : “Missing dependency” ou “Forge version mismatch”

Cause : Mauvaise version de Forge installée

Correction :

  1. Consultez la page du mod pour la version de Forge requise
  2. Ouvrez le Minecraft Launcher
  3. Allez dans l’onglet “Installations”
  4. Modifiez votre profil Forge
  5. Mettez à jour Forge vers la version requise
  6. Enregistrez et redémarrez

Erreur : Le jeu plante au démarrage

Cause : Conflit de mods ou version Java incompatible

Correction :

  1. Retirez temporairement tous les autres mods
  2. Testez avec uniquement Verity installé
  3. Si ça fonctionne, rajoutez les mods un par un
  4. Vérifiez la version Java : Java 17 ou supérieur requis
  5. Mettez à jour les pilotes graphiques

Problèmes de connexion IA

Erreur : “Failed to connect to AI service”

Cause : Problème de connexion internet ou d’API

Correction :

  1. Testez la connexion internet (essayez de charger un site web)
  2. Vérifiez le statut de l’API Ollama : https://status.ollama.com
  3. Vérifiez que le pare-feu ne bloque pas Minecraft
  4. Si vous utilisez un VPN, essayez de le désactiver
  5. Redémarrez votre routeur/modem

Erreur : “AI responses too slow”

Cause : Latence réseau ou surcharge de l’API

Correction :

  1. Fermez les applications gourmandes en bande passante
  2. Passez en connexion filaire si vous êtes en WiFi
  3. Attendez et réessayez (l’API peut être surchargée)
  4. Vérifiez le délai d’attente de réponse dans les paramètres du mod
  5. Envisagez d’utiliser le mode hors ligne (si disponible)

Erreur : “AI not responding to commands”

Cause : Syntaxe de commande incorrecte ou temps de recharge

Correction :

  1. Vérifiez le format de la commande (consultez la documentation du mod)
  2. Vérifiez si l’IA est en temps de recharge (attendez 10-30 secondes)
  3. Assurez-vous d’être suffisamment proche de l’entité
  4. Essayez différentes variations de la commande
  5. Consultez les logs du chat pour les erreurs

Problèmes de performance

Problème : FPS bas après l’installation de Verity

Cause : Surcharge du rendu des entités

Correction :

  1. Ouvrez la configuration du mod : .minecraft/config/verity.toml
  2. Réduisez “entity_render_distance” à 32 ou moins
  3. Réduisez “ai_update_frequency” à 20 (ticks)
  4. Désactivez les effets de particules si activés
  5. Allouez plus de RAM : -Xmx4G dans les paramètres du launcher

Problème : Utilisation élevée de la RAM

Cause : Traitement de l’IA et chargement des données du monde

Correction :

  1. Augmentez la RAM allouée à Minecraft :
    • Ouvrez le Launcher → Installations → Modifier
    • Arguments JVM : -Xmx4G (ou -Xmx6G pour les systèmes avec 8 Go+)
  2. Fermez les applications en arrière-plan
  3. Réduisez la distance de rendu dans les paramètres vidéo
  4. Diminuez la complexité de l’IA dans la configuration du mod

Problème : Corruption du monde ou erreurs de sauvegarde

Cause : Conflit de mods ou arrêt incorrect

Correction :

  1. SAUVEGARDEZ VOTRE MONDE IMMÉDIATEMENT
  2. Retirez le mod Verity temporairement
  3. Chargez le monde dans Minecraft vanilla
  4. Si le monde se charge correctement, le problème vient du mod
  5. Réinstallez Verity et restaurez depuis la sauvegarde
  6. Signalez le problème sur GitHub avec les logs de crash

Problèmes de compatibilité

Problème : Ne fonctionne pas avec [mod spécifique]

Cause : Conflit de mods

Correction :

  1. Consultez la page de Verity pour les incompatibilités connues
  2. Mettez à jour les deux mods vers la dernière version
  3. Essayez de charger Verity après les autres mods
  4. Signalez le conflit sur GitHub avec les détails
  5. Utilisez un mod alternatif si c’est indispensable

Problème : Ne fonctionne pas sur les serveurs

Cause : Restrictions du serveur

Correction :

  1. Vérifiez que le serveur autorise les mods côté client
  2. Vérifiez si le serveur a une liste noire de mods
  3. Contactez l’administrateur du serveur pour obtenir l’autorisation
  4. Certains serveurs bloquent les fonctions de chat IA
  5. Testez en solo pour vérifier que le mod fonctionne

Problème : Conflits avec les packs de textures/ressources

Cause : Le pack de ressources écrase les textures du mod

Correction :

  1. Désactivez temporairement les packs de ressources
  2. Testez avec les textures par défaut
  3. Si ça fonctionne, le problème vient du pack de ressources
  4. Contactez le créateur du pack de ressources
  5. Utilisez un pack de ressources spécifique à Verity si disponible

Problèmes spécifiques par plateforme

Windows

Problème : L’antivirus bloque le mod

Correction :

  1. Ajoutez le dossier Minecraft aux exceptions de l’antivirus
  2. Mettez le répertoire .minecraft/mods en liste blanche
  3. Utilisez les exclusions Windows Defender : 
    Paramètres → Mise à jour et sécurité → Sécurité Windows
→ Protection contre les virus et menaces → Gérer les paramètres
→ Exclusions → Ajouter une exclusion → Dossier
→ Sélectionnez le dossier .minecraft

Problème : Chemin de fichier trop long

Correction :

  1. Déplacez l’installation de Minecraft vers un chemin plus court
  2. Utilisez : C:\Games\Minecraft au lieu de dossiers trop profonds
  3. Activez les chemins longs dans Windows (si nécessaire)

Mac

Problème : Erreurs de permission refusée

Correction :

  1. Vérifiez les permissions des fichiers : 
    chmod 755 ~/Library/Application\ Support/minecraft/mods/
  2. Lancez Minecraft en tant qu’administrateur si nécessaire
  3. Désactivez Gatekeeper temporairement (non recommandé)

Problème : Java introuvable

Correction :

  1. Installez Java 17 depuis Adoptium
  2. Définissez la variable d’environnement JAVA_HOME
  3. Mettez à jour le chemin Java dans le Minecraft Launcher

Linux

Problème : Le mod ne se charge pas

Correction :

  1. Vérifiez les permissions des fichiers : 
    ls -la ~/.minecraft/mods/
chmod 644 ~/.minecraft/mods/verity-*.jar
  2. Vérifiez la version de Java : 
    java -version
  3. Consultez les logs du launcher pour les erreurs

Guide de configuration

Emplacement : .minecraft/config/verity.toml

# AI Settings
ai_enabled = true
ai_response_delay = 100  # milliseconds
ai_max_response_length = 200

# Entity Settings
entity_render_distance = 64
entity_follow_distance = 3
entity_despawn_time = -1  # -1 = never despawn

# Performance
update_frequency = 10  # ticks (20 = 1 second)
particle_effects = true
sound_effects = true

# Advanced
debug_mode = false
log_ai_conversations = false

Paramètres recommandés pour les PC modestes

ai_response_delay = 500
entity_render_distance = 32
update_frequency = 20
particle_effects = false
sound_effects = false

Obtenir de l’aide

Avant de demander de l’aide

  1. yes Consultez ce guide de dépannage
  2. yes Recherchez dans les issues GitHub
  3. yes Mettez à jour vers la dernière version du mod
  4. yes Testez avec uniquement Verity installé
  5. yes Récupérez les logs de crash

Comment signaler un problème

  1. Allez sur : https://github.com/varmint/Verity/issues
  2. Cliquez sur “New Issue”
  3. Incluez :
    • Version de Minecraft
    • Version de Forge
    • Version du mod
    • Système d’exploitation
    • Log de crash (si applicable)
    • Étapes pour reproduire le problème
    • Comportement attendu vs. réel

Où trouver les logs

  • Logs de crash : .minecraft/crash-reports/
  • Dernier log : .minecraft/logs/latest.log
  • Configuration du mod : .minecraft/config/verity.toml

Messages d’erreur courants

Message d’erreurCauseSolution
”Missing dependency: forge”Mauvaise version de ForgeInstallez la version de Forge requise
”Failed to initialize AI”Pas d’internet / problème d’APIVérifiez la connexion, attendez, réessayez
”Entity rendering failed”Problème graphiqueMettez à jour les pilotes, réduisez les paramètres
”Config file corrupted”Arrêt incorrectSupprimez la config, redémarrez Minecraft
”Version mismatch”Mauvaise version du modTéléchargez la bonne version pour votre MC

Conseils de prévention

  1. Sauvegardez vos mondes avant l’installation

    Copiez .minecraft/saves/[nom-du-monde] vers un emplacement de sauvegarde

  2. Testez les mods dans une instance séparée

    • Créez une nouvelle installation Minecraft
    • Testez le mod avant de l’ajouter à votre monde principal

  3. Gardez les mods à jour

    • Vérifiez les mises à jour chaque semaine
    • Lisez le journal des modifications avant de mettre à jour

  4. Lisez la documentation du mod

    • Vérifiez les configurations requises
    • Notez les problèmes connus
    • Suivez exactement les instructions d’installation

Encore besoin d’aide ?

Dernière mise à jour : 2026-07-26 | Couvre Verity Mod v1.0.0 pour Minecraft 1.20.1+