Aller au contenu principal

Packaging de Contenu Personnalise EternalTD

EternalTD prend toujours en charge le contenu personnalise base sur le systeme de fichiers, mais le code actuel attend une organisation de dossiers precise et un modele de suivi de paquets specifique.

Racine d'Import​

Les imports manuels passent toujours par :

plugins/EternalTD/imports/

Apres un import manuel, execute :

/etd reload

Dossiers de Contenu Canoniques​

Le plugin actuel analyse ces dossiers en minuscules :

plugins/EternalTD/levels/
plugins/EternalTD/waves/
plugins/EternalTD/npcs/
plugins/EternalTD/worlds/

Note heritage :

  • Levels/ et NPCs/ sont des anciens noms de dossier.
  • EternalTD les migre maintenant vers levels/ et npcs/ au demarrage et au rechargement.

Regles de Packaging des Mondes​

EternalTD traite les mondes sous :

plugins/EternalTD/worlds/

comme des modeles de monde.

Lorsqu'un joueur lance un niveau, EternalTD clone le modele de monde correspondant dans le conteneur de mondes du serveur et execute la session dans cette copie clonee.

Implication pratique :

  • place les mondes modeles dans plugins/EternalTD/worlds/
  • ne traite pas les mondes clones a l'execution comme la source de verite du contenu package

Le monde hub officiel est un cas special et il est suivi directement dans le conteneur de mondes du serveur sous :

etd_spawn

Ce qui Rend un Paquet Activable​

L'activation ou la desactivation des paquets dans /etd setup ne fonctionne que pour les paquets qui exposent des fichiers de configuration suivis.

Les champs d'assets actuellement suivis sont :

  • levelFiles
  • waveFiles
  • npcFiles
  • worldFolders
  • worldContainerFolders
  • markerFileName

En pratique :

  • les paquets de niveaux, vagues et NPC peuvent etre actives ou desactives en ecrivant isEnabled dans ces fichiers YAML
  • le contenu partage du conteneur de mondes et les paquets de ressources bases uniquement sur un marqueur ne sont pas activables de la meme maniere

Champs de Metadonnees du Paquet​

Le modele actuel de champs de configuration des paquets prend en charge :

  • isEnabled
  • name
  • description
  • downloadLink
  • version
  • nightbreakSlug
  • levelFiles
  • waveFiles
  • npcFiles
  • worldFolders
  • worldContainerFolders
  • markerFileName
  • category
  • toggleable

Si tu veux qu'un contenu personnalise se comporte comme un paquet suivi dans l'interface de configuration, il te faut des metadonnees de paquet qui correspondent a ces champs.

Notes sur le Packaging des Modeles​

Le paquet actuel EternalTD Custom Models est suivi via un fichier marqueur plutot que via des fichiers de configuration EternalTD classiques.

Cela signifie :

  • EternalTD peut suivre si le paquet de modeles partage a ete telecharge
  • les assets de modele eux-memes vivent du cote FreeMinecraftModels de la configuration quand FMM est installe
  • le nettoyage est manuel puis suivi de /etd reload

Ce que Cette Page ne Pretend Pas​

Cette page documente les destinations actuelles sur disque et le modele de suivi verifies dans le depot.

Elle ne definit pas de schema ZIP first-party pour les archives de paquets Nightbreak, car ce format de packaging n'est pas decrit dans ce depot comme une specification publique autonome de creation de contenu.