Mettre à jour tlr_core

Une nouvelle version se télécharge sur https://portal.cfx.re, menu Assets, comme la première fois. Votre clé TLR et vos réglages faits en jeu ne changent pas.

Ce qui est conservé

Tout ce qui est en base : personnages, inventaires, argent, réglages du panel, permissions, boutiques, portes, zones, comptes de la console web. Une mise à jour ne vide jamais la base.
Vos fichiers de config/, si vous les remettez (étape 3).
Les fichiers créés par la ressource dans son dossier : licence.cache, backups/, captures et fichiers de la console. Copiez les aussi si vous remplacez le dossier entier.

Pas à pas

Sauvegardez la base. Console web, écran Serveur, Sauvegarde (fichier SQL dans tlr_core/backups/, fondateur), ou votre outil habituel (HeidiSQL, mysqldump, sauvegarde de l'hébergeur). Téléchargez le fichier hors du serveur.
Mettez de côté votre dossier tlr_core/config/, tlr_core/locales/ si vous l'avez modifié, vos images ajoutées dans tlr_core/web/ et le dossier tlr_core/backups/.
Arrêtez le serveur, supprimez l'ancien dossier tlr_core, décompressez la nouvelle version au même endroit (même nom : tlr_core), puis remettez vos fichiers de config/ et vos images.
Comparez vos fichiers de config/ avec ceux de la nouvelle version : les notes de version disent si un fichier a reçu de nouveaux réglages. Un réglage absent de votre fichier garde sa valeur par défaut : rien ne casse, mais vous ne profitez pas de la nouveauté tant que vous ne l'ajoutez pas.
Démarrez le serveur. Les nouvelles migrations de la base s'appliquent toutes seules, dans l'ordre, une seule fois chacune. Les anciennes ne sont jamais rejouées.
Vérifiez avec tlr_diag dans la fenêtre du serveur : chaque service doit être vert.

Les migrations automatiques

Chaque changement de la base est une migration numérotée. La table tlr_migrations garde la liste de celles déjà appliquées.
Au démarrage, tlr_core applique celles qui manquent. Si l'une échoue, le cœur reste « non prêt », refuse les joueurs et affiche la migration et l'erreur SQL dans la fenêtre du serveur. Rien n'est appliqué à moitié sans être signalé.
En cas d'échec : ne relancez pas en boucle. Gardez le message, restaurez la sauvegarde si besoin, et contactez le support avec ce message.

Revenir à la version précédente

Une migration ne se défait pas. Pour revenir en arrière : arrêtez le serveur, restaurez la sauvegarde de la base faite avant la mise à jour, remettez l'ancien dossier tlr_core, redémarrez. Sans sauvegarde, l'ancienne version peut refuser une base plus récente : faites toujours l'étape 1.

Changement de machine ou d'IP

La clé TLR est liée à l'adresse IP du serveur. Après un déménagement : /changerip sur le Discord du vendeur, puis redémarrez. La clé Cfx.re (sv_licenseKey) doit rester celle du compte qui a acheté tlr_core.

Source : tlr_core/docs/MISE_A_JOUR.md