Aller au contenu principal

Modèles et pack de ressources EternalTD

EternalTD utilise FreeMinecraftModels pour ses modèles et /etd install pour configurer la distribution de son pack de ressources.

FreeMinecraftModels​

FreeMinecraftModels est une dépendance optionnelle.

  • EternalTD se charge toujours sans lui.
  • Lorsqu'il est présent, EternalTD peut remplacer le corps vanilla des tours par des modèles statiques FMM. Un modèle manquant produit un avertissement et laisse le corps vanilla en place.
  • Lorsqu'il est absent, EternalTD utilise les corps vanilla sans bloquer le démarrage. L'indicateur d'intégration vérifie la présence du plugin : une installation FMM désactivée ou incompatible n'équivaut donc pas à son absence.

Le paquet de modèles partagé actuel est :

  • EternalTD Custom Models

Ce paquet est téléchargé via le flux de contenu d'EternalTD et est décrit dans le code comme du contenu qui s'importe dans FreeMinecraftModels lorsque FMM est disponible.

Le suivi des paquets d'EternalTD accepte également chacun de ces dossiers FMM non vides comme contenu installé :

plugins/FreeMinecraftModels/models/EternalTD default towers/
plugins/FreeMinecraftModels/Models/EternalTD default towers/

La variante avec majuscule est l'ancien nom du dossier. La détection de l'un de ces dossiers non vides fait compter le contenu comme installé et tente d'écrire plugins/EternalTD/content_markers/eternaltd_custom_models.marker ; un échec d'écriture est journalisé. Un marqueur existant compte aussi, même si les modèles ont ensuite été supprimés. Aucun de ces contrôles ne valide les modèles ni ne prouve leur chargement.

Effet de /etd reload sur les modèles​

/etd reload redémarre EternalTD sur place et traite les importations en attente. Lorsque l'importateur partagé installe des modèles ou d'autres fichiers dans les dossiers de FMM (comme scripts) et que FMM est activé, sa notification d'installation appelle le rechargement du contenu importé de FMM. Cet appel est conditionnel : il ne se produit pas à chaque /etd reload. La méthode de transmission distincte d'EternalTD n'a aucun appelant.

Si vous modifiez ou copiez des fichiers directement dans les dossiers FMM, utilisez sa propre commande de rechargement. Vérifiez les journaux et un modèle en jeu ; le marqueur du paquet ne suffit pas.

/etd install​

/etd install ne télécharge pas de paquet de modèles. Il applique les paramètres officiels de distribution du pack de ressources d'EternalTD.

L'URL officielle actuelle du pack de ressources est :

https://www.magmaguy.com/downloads/eternaltd_resource_pack.zip

Si ResourcePackManager est installé​

Si ResourcePackManager est activé, EternalTD enregistre le pack officiel et lui demande de recharger son état de packs.

Dans ce mode :

  • EternalTD n'écrit pas l'URL du pack dans server.properties
  • ResourcePackManager gère la distribution aux joueurs
  • EternalTD enregistre /etd reload comme commande de rechargement de suivi

Le message d'enregistrement confirme les appels à l'API, pas la livraison à un client. Au démarrage, EternalTD considère simplement ResourcePackManager activé comme une configuration active ; il n'effectue pas cet enregistrement. Exécutez /etd install pour le demander, puis vérifiez le pack avec un joueur connecté.

Si ResourcePackManager est indisponible ou si l'enregistrement échoue​

EternalTD modifie directement server.properties si ResourcePackManager est désactivé, absent ou si son enregistrement via l'API provoque une erreur.

Il écrit :

  • resource-pack
  • resource-pack-sha1

Avant de modifier l'une ou l'autre de ces propriétés, EternalTD télécharge le pack et calcule son SHA1 au fil de la réception des octets, sans enregistrer le pack sur le disque. Le téléchargement utilise un délai de connexion de 10 secondes et un délai de lecture de 30 secondes. Si le téléchargement ou le calcul du hash échoue, server.properties reste inchangé. En cas de succès, les deux valeurs sont écrites ensemble via un fichier temporaire et un remplacement atomique lorsque le système d'exploitation le permet. Si les deux valeurs correspondent déjà, le fichier n'est pas réécrit.

Dans ce mode de secours, la commande vous indique de redémarrer le serveur pour que les nouveaux paramètres du pack prennent effet.

Vérification de mise à jour SHA1​

Si EternalTD utilise le chemin server.properties au lieu de ResourcePackManager, le démarrage (ainsi que /etd reload) vérifie également si le SHA1 du pack de ressources officiel a changé.

Ce contrôle ne s'exécute que si resource-pack correspond exactement à l'URL officielle d'EternalTD ci-dessus ; un pack provenant de toute autre URL n'est pas touché. Si le hash a changé, EternalTD écrit le nouveau resource-pack-sha1 après avoir confirmé que resource-pack contient toujours l'URL officielle. Il n'annonce pas ce changement ; le serveur envoie le nouveau hash aux joueurs après son prochain redémarrage. Si l'écriture est ignorée ou échoue, la console indique que la somme de contrôle n'a pas été mise à jour. Lorsque ResourcePackManager est activé, cette branche de démarrage est évitée.

Avertissement aux opérateurs​

Lorsque toutes ces conditions sont vraies :

  • FreeMinecraftModels est installé
  • le joueur qui se connecte est opérateur
  • EternalTD ne détecte pas de configuration active du pack de ressources

EternalTD programme un avertissement cinq secondes plus tard, si le joueur est encore valide. Il indique les commandes suivantes :

  • /etd install
  • /etd initialize — Ouvre le menu de première configuration. Nécessite eternaltd.*.
  • /etd setup

La détection signifie uniquement que ResourcePackManager est activé ou que server.properties contient une valeur resource-pack non vide. Elle ne vérifie ni l'acceptation du client ni la présence des ressources EternalTD dans le pack. L'avertissement décrit le chemin server.properties, mais /etd install essaie toujours ResourcePackManager en premier.

Notes de nettoyage​

Le paquet de modèles personnalisés est traité comme du contenu de ressources partagé, pas comme un pack activable normal.

Si vous souhaitez le supprimer :

  1. Supprimez les modèles importés souhaités en vérifiant les dossiers FMM actuels et anciens.
  2. Supprimez plugins/EternalTD/content_markers/eternaltd_custom_models.marker pour que le paquet cesse de compter comme installé. Un dossier de détection encore non vide rétablira cet état au prochain contrôle.
  3. Rechargez FMM pour appliquer les suppressions directes, puis exécutez /etd reload. Consultez /fmm setup si nécessaire. Ces étapes ne suppriment ni l'enregistrement du pack de ressources ni ses paramètres dans server.properties.