Dépannage : lire les erreurs et les corriger

Ce chapitre part du symptôme, pas de la cause. Trouve ta ligne dans le sommaire ci-dessous et va directement à la section.

1. Le réflexe qui résout la moitié des cas : lire la console #

Avant toute chose, ouvre la page Console et redémarre le serveur en regardant défiler.

Les erreurs les plus utiles sont dans les vingt premières lignes, pas à la fin. Une fois que le serveur a renoncé, il crache des messages qui ne sont que les conséquences du premier problème.

Pour l'historique complet, File Manager → AMP_Logs/. Les fichiers sont horodatés : prends celui qui correspond au moment du problème.

Quand tu demandes de l'aide, copie les vingt premières lignes d'erreur, pas une capture d'écran de la dernière. C'est ce qui permet de te répondre en une fois.

✅ À retenir

• Les vingt premières lignes rouges, pas les dernières.
• AMP_Logs/ garde l'historique que la console perd.

2. Le serveur ne démarre pas #

Dans l'ordre de probabilité :

01 - Profil serveur contient un espace, un accent ou un caractère spécial. C'est la première cause. Le nom doit être simple : lettres et chiffres.

Un fichier JSON est invalide. Tu as modifié Config/ ou un config.json de plugin et laissé une virgule en trop. Remets ta sauvegarde, redémarre, recommence en validant la syntaxe (chapitre 03, section 2).

Un plugin bloque le démarrage. Retire la dernière DLL posée et redémarre. Si tu ne sais plus laquelle : télécharge Plugins/ en entier, vide le dossier, démarre, repose une par une.

La base est corrompue. Si la console parle de life.db ou de SQLite : arrête, renomme life.db en life.db.casse, mets une sauvegarde à la place (chapitre 04, section 6).

Le disque est plein. Regarde l'espace restant. Les fichiers de log et les sauvegardes s'accumulent.

✅ À retenir

• Profil serveur, JSON invalide, plugin, base : dans cet ordre.

3. Le serveur démarre mais personne ne le voit #

13 - Serveur public est décoché. La cause dans la grande majorité des cas.

Tu viens de démarrer. La liste publique n'est pas instantanée : attends deux ou trois minutes.

14 - Whitelist activée est cochée. Le serveur est visible mais refuse les non-autorisés. Tes joueurs le voient et ne peuvent pas entrer — le symptôme ressemble mais la cause est différente.

Les ports. Si tu y as touché à la main, remets-les. Ils sont gérés par TeamKit et se réécrivent seuls (chapitre 02, section 9).

✅ À retenir

• Serveur public décoché, ou whitelist activée : deux symptômes proches, deux causes différentes.

4. Tout a disparu : personnages, argent, véhicules #

Ne redémarre pas. Ne recrée rien. Ne laisse personne jouer. Chaque minute de jeu sur une base vide rend la récupération plus compliquée.

La cause est presque toujours la même : 01 - Profil serveur a changé. Une faute de frappe, une majuscule différente, un espace ajouté. Le serveur n'a rien effacé — il est simplement allé chercher un autre dossier, ne l'a pas trouvé, et en a créé un neuf.

La récupération :

1. Arrête le serveur.
2. Par SFTP, ouvre novalife/1665030/Servers/. Tu devrais y voir deux dossiers : l'ancien, plein, et le nouveau, quasi vide.
3. Note le nom exact de l'ancien, à la casse près.
4. Dans AMP, remets 01 - Profil serveur à cette valeur exacte.
5. Enregistre, redémarre, vérifie en jeu.

Si tu ne vois qu'un seul dossier, ne touche à rien et contacte le staff TeamKit : les sauvegardes AMP de l'instance peuvent encore contenir ce qu'il faut.

✅ À retenir

• Deux dossiers dans Servers/ = tu as changé de profil. Rien n'est perdu.
• Ne laisse personne jouer sur la base vide en attendant.

5. Le serveur plante tout seul #

Regarde d'abord quand : toujours à la même heure, ou au hasard ?

Toujours à la même heure : c'est une tâche planifiée. Page Schedule, cherche une sauvegarde sans « Backup While Running » ou une mise à jour automatique (chapitre 07).

Au hasard, après plusieurs heures : c'est en général la mémoire. Ton instance a un plafond ; quand le serveur le dépasse, le système le tue net. Dans la console, le plantage est brutal et sans message d'erreur clair — c'est justement la signature.

Ce que tu peux faire :

• Réduire le nombre de plugins. Chacun consomme.
• Baisser 21 - Framerate serveur.
• Mettre en place un redémarrage planifié quotidien aux heures creuses. Ce n'est pas élégant, mais c'est efficace : le serveur repart avec une mémoire propre avant d'atteindre le plafond.
• Baisser 18 - Sauvegarde auto à 900 pour limiter la casse quand ça arrive.

Au hasard, dès le démarrage : c'est un plugin. Section 7.

✅ À retenir

• Toujours à la même heure = tâche planifiée. Après des heures = mémoire.
• Un redémarrage quotidien planifié règle la plupart des plantages mémoire.

6. Le serveur rame ou saccade #

Vérifie le CPU sur la page Status. S'il est constamment au plafond, c'est là qu'est le problème.

Les causes, par ordre de fréquence :

21 - Framerate serveur trop haut. Sur un CPU plafonné, viser 60 quand la machine ne suit pas produit exactement l'inverse : le serveur n'arrive plus à tenir sa cadence. Redescends à 30 et compare.

Trop de plugins. Retire ce qui ne sert pas vraiment.

Trop de joueurs pour le profil. Baisse 12 - Slots.

La sauvegarde automatique trop fréquente. À 300 secondes sur un serveur chargé, l'écriture de la base se sent. Remonte à 900.

Rappelle-toi que la physique du jeu tourne à 50 Hz quoi qu'il arrive : monter le framerate au-delà n'améliore rien.

✅ À retenir

• Framerate trop haut sur CPU plafonné = saccades. Redescends à 30.

7. Un plugin ne fait rien #

Regarde la console au démarrage. Un plugin chargé s'annonce. S'il ne dit rien, il n'est pas chargé, et tout le reste est inutile à vérifier.

Les trois causes :

La DLL n'est pas à la racine de Plugins/. Elle est dans un sous-dossier. Remonte-la.

Tu n'as pas redémarré. Un plugin ne se charge qu'au démarrage.

Il a été remplacé par une vieille version lors d'une mise à jour du jeu (chapitre 05, section 3). Regarde sa date de modification.

Si le plugin s'annonce mais ne fait rien : son config.json est probablement invalide, ou il est désactivé dedans. Vérifie la syntaxe et cherche un champ enabled.

✅ À retenir

• Pas d'annonce dans la console = pas chargé. Commence toujours par là.

8. Les joueurs perdent leur progression #

C'est l'intervalle de sauvegarde. Entre deux écritures de life.db, tout vit en mémoire.

• Un redémarrage propre depuis AMP n'a aucune raison de perdre quoi que ce soit, si 19 - Déconnecter les joueurs avant arrêt est activé.
• Un plantage perd jusqu'à 18 - Sauvegarde auto secondes, soit 30 minutes par défaut.

Si tes joueurs se plaignent régulièrement, tu as deux problèmes à traiter en même temps : baisse l'intervalle à 900, et cherche pourquoi le serveur plante (section 5).

✅ À retenir

• Redémarrage propre = rien de perdu. Plantage = jusqu'à 30 minutes.

9. Je n'ai plus accès au panel web #

Le serveur est-il démarré ? Le panel est un plugin : il ne répond que si le serveur tourne.

Le port. Le panel écoute sur port de jeu + 4. Vérifie que tu ne tapes pas le port du jeu par erreur — un navigateur pointé sur le port du jeu envoie une requête que le serveur rejette, et selon ta configuration cette adresse peut se retrouver bloquée par la protection anti-flood pendant une heure.

Un ancien panel a été réinstallé. Après une mise à jour du jeu, TKWebPanel.dll peut être revenu et se disputer le port avec ton panel actuel. Regarde dans Plugins/ : si tu vois deux panels, retire celui que tu n'utilises pas et redémarre.

Le plugin ne se charge plus. Section 7.

✅ À retenir

• Panel = port de jeu + 4. Taper le port du jeu dans un navigateur peut te faire bloquer temporairement.

10. Demander de l'aide efficacement #

Quand tu ouvres un ticket au staff TeamKit, donne d'emblée :

• Le nom de ton serveur.
• Ce que tu as fait juste avant que ça casse.
• Les vingt premières lignes d'erreur de la console, en texte, pas en capture.
• Ce que tu as déjà essayé.

Un message avec ces quatre éléments obtient une réponse utile du premier coup. Un message qui dit « mon serveur marche plus » demandera trois allers-retours avant même de commencer.

✅ À retenir

• Quatre éléments : serveur, ce que tu as fait, les vingt lignes, ce que tu as essayé.

Checklist du chapitre #

• Je sais où trouver AMP_Logs/
• Je lis les vingt premières lignes d'erreur, pas les dernières
• J'ai vérifié qu'il n'y a qu'un seul dossier dans Servers/
• Mes plugins s'annoncent tous dans la console au démarrage
• Je connais le port de mon panel web
• Quand je demande de l'aide, je donne les quatre éléments