Zum Hauptinhalt springen

Benutzerdefinierte Inhalts-Paketierung fuer EternalTD

EternalTD unterstuetzt weiterhin dateisystembasierte benutzerdefinierte Inhalte, aber der aktuelle Code erwartet eine bestimmte Ordnerstruktur und ein bestimmtes Paket-Tracking-Modell.

Import-Stammordner​

Manuelle Importe laufen weiterhin ueber:

plugins/EternalTD/imports/

Nach einem manuellen Import fuehre aus:

/etd reload

Kanonische Inhaltsordner​

Das aktuelle Plugin scannt diese kleingeschriebenen Ordner:

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

Hinweis zu Legacy-Namen:

  • Levels/ und NPCs/ sind alte Ordnernamen.
  • EternalTD migriert sie beim Start und beim Reload jetzt nach levels/ und npcs/.

Regeln fuer die Welt-Paketierung​

EternalTD behandelt die Welten unter:

plugins/EternalTD/worlds/

als Welt-Templates.

Wenn ein Spieler ein Level startet, klont EternalTD die passende Template-Welt in den World-Container des Servers und fuehrt die Sitzung in dieser geklonten Kopie aus.

Praktische Auswirkung:

  • lege Template-Welten unter plugins/EternalTD/worlds/ ab
  • behandle die zur Laufzeit geklonten Welten nicht als Source of Truth fuer paketierte Inhalte

Die offizielle Hub-Welt ist ein Sonderfall und wird direkt im World-Container des Servers verfolgt als:

etd_spawn

Was ein Paket umschaltbar macht​

Das Umschalten von Paketen in /etd setup funktioniert nur fuer Pakete, die verfolgte Konfigurationsdateien bereitstellen.

Die aktuell verfolgten Asset-Felder sind:

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

In der Praxis:

  • Level-, Wave- und NPC-Pakete koennen ueber isEnabled in diesen YAML-Dateien aktiviert oder deaktiviert werden
  • gemeinsam genutzte World-Container-Inhalte und markerbasierte Ressourcenpakete sind nicht auf dieselbe Weise umschaltbar

Paket-Metadatenfelder​

Das aktuelle Feldmodell fuer Paketkonfigurationen unterstuetzt:

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

Wenn sich benutzerdefinierte Inhalte im Setup-UI wie ein verfolgtes Paket verhalten sollen, brauchst du Paket-Metadaten, die zu diesen Feldern passen.

Hinweise zur Modell-Paketierung​

Das aktuelle Paket EternalTD Custom Models wird ueber eine Marker-Datei verfolgt und nicht ueber normale EternalTD-Konfigurationsdateien.

Das bedeutet:

  • EternalTD kann verfolgen, ob das gemeinsam genutzte Modellpaket heruntergeladen wurde
  • die eigentlichen Modell-Assets liegen auf der FreeMinecraftModels-Seite des Setups, wenn FMM installiert ist
  • Bereinigung erfolgt manuell und anschliessend mit /etd reload

Was diese Seite nicht behauptet​

Diese Seite dokumentiert die aktuell verifizierten Ziele auf dem Datentraeger und das Tracking-Modell im Repo.

Sie definiert kein First-Party-ZIP-Schema fuer Nightbreak-Paketarchive, weil dieses Paketformat in diesem Repo nicht als eigenstaendige oeffentliche Authoring-Spezifikation beschrieben ist.