Zum Hauptinhalt springen

EternalTD-Einrichtung

Der aktuelle EternalTD-Einrichtungsablauf basiert auf von Nightbreak verwalteten Inhalten, optionaler Modellunterstützung durch FreeMinecraftModels und einem Hilfsbefehl für Ressourcenpakete.

Voraussetzungen​

  • EternalTD 1.7.1
  • Java 21
  • Ein Paper/Spigot-kompatibler Server auf der aktuellen 1.21.4-API-Linie

Optionale Integrationen:

  • FreeMinecraftModels für die benutzerdefinierten Modelle von EternalTD
  • ResourcePackManager, wenn EternalTD sein offizielles Ressourcenpaket dort registrieren soll, anstatt in server.properties zu schreiben
  • Floodgate und LibsDisguises sind Soft-Dependencies, keine Einrichtungsvoraussetzungen für den aktuellen Einrichtungsablauf

plugin.yml deklariert genau vier Soft-Dependencies: FreeMinecraftModels, LibsDisguises, Floodgate und ResourcePackManager. ModelEngine wird im Plugin nirgendwo mehr referenziert.

Was EternalTD erstellt​

Beim Start initialisiert oder verwendet EternalTD diese Pfade:

plugins/EternalTD/config.yml
plugins/EternalTD/content_packages/
plugins/EternalTD/imports/
plugins/EternalTD/levels/
plugins/EternalTD/waves/
plugins/EternalTD/npcs/
plugins/EternalTD/worlds/

Hinweis zu Legacy-Versionen:

  • Das Plugin behandelt jetzt levels/ und npcs/ als kanonische Ordnernamen.
  • Beim Start und Neuladen migriert es automatisch die älteren Ordner Levels/ und NPCs/ in die Pfade mit Kleinbuchstaben.

Empfohlener Ersteinrichtungsablauf​

  1. Installieren Sie EternalTD und starten Sie den Server einmal.
  2. Verknüpfen Sie Ihr Nightbreak-Konto mit /nightbreaklogin <token>.
  3. Führen Sie /etd downloadall aus, um alle zugänglichen EternalTD-Pakete nach plugins/EternalTD/imports herunterzuladen.
  4. Führen Sie /etd install aus, um die offizielle EternalTD-Ressourcenpaket-Einrichtung anzuwenden.
  5. Führen Sie /etd setup jederzeit aus, wenn Sie einzelne Pakete durchsuchen, aktivieren, deaktivieren oder aktualisieren möchten.

/nightbreaklogin <token> ist Teil des gemeinsamen Nightbreak/MagmaCore-Kontoablaufs, kein in EternalTDs plugin.yml deklarierter Befehl.

Das /etd setup-Menü​

/etd setup öffnet das gemeinsame MagmaCore-Einrichtungsmenü. Neben den EternalTD-Inhaltspaketen (gefiltert nach Free Content, Premium Packs und Resources) bietet das Menü auch diese Standard-MagmaCore-Steuerungen:

  • einen Eintrag Plugin Update, der die installierte gegenüber der neuesten EternalTD-Version anzeigt und ein Plugin-Update herunterlädt, wenn eines verfügbar ist,
  • einen Eintrag Recommended Plugins, der die Ansicht mit Empfehlungen für Begleit-Plugins öffnet (auch über /etd recommendedplugins erreichbar),
  • eine Umschaltschaltfläche Automatic Updates, die den Konfigurationswert nightbreak.autoDownloadPluginUpdates ein- oder ausschaltet,
  • einen Eintrag Download All, der /etd downloadall ausführt (Plugin-Update plus alle verfügbaren Inhalte).

Spawn- und Hub-Verhalten​

config.yml enthält derzeit:

  • setupDone — Flag, das verfolgt, ob die Ersteinrichtungs-Anleitung abgeschlossen wurde (Standard false).
  • spawnLocations — Standard ist etd_spawn,0,65,0,0,0 und wird immer in die Konfiguration geschrieben. EternalTD löst den Wert nur auf und verwendet ihn, wenn die Welt etd_spawn existiert.
  • manageSpawn — Standard ist true. Teleportiert beitretende Spieler in die EternalTD-Hub-Welt, wenn sie verfügbar ist.
  • playerGuide — der Text des spielinternen Anleitungsbuchs.
  • nightbreak.autoDownloadPluginUpdates — Standard ist false. Gemeinsame MagmaCore-Einstellung; bei true lädt das Plugin verfügbare Plugin- und Inhalts-Updates beim Start automatisch herunter (wird nach dem nächsten Neustart verwendet). Dies ist auch im Spiel über die Schaltfläche "Automatic Updates" im /etd setup-Menü umschaltbar.

Wenn manageSpawn: true und die Welt etd_spawn existiert, werden beitretende Spieler zum konfigurierten EternalTD-Spawnpunkt teleportiert.

Das offizielle Hub-Paket wird separat von Gameplay-Karten verfolgt und als etd_spawn-Welt im Weltcontainer des Servers installiert.

Unter Paper 26.1 und neuer werden Welten aus dem Wurzelverzeichnis des Weltcontainers nach <level-name>/dimensions/minecraft/<world> migriert. EternalTD sucht etd_spawn sowohl im alten Wurzelverzeichnis als auch am migrierten Ort, sodass ein migrierter Hub weiterhin als installiert erkannt und geladen wird. Halb migrierte Überbleibsel werden vor dem Erstellen der Welt in Quarantäne verschoben, weil Papers Migration sich weigert, eine Legacy-Kopie neben einer migrierten zusammenzuführen.

Neuladen nach Importen​

Verwenden Sie /etd reload nach manuellen Importen oder manueller Dateibereinigung.

/etd reload ist ein vollständiger In-Place-Neustart des Plugins — er durchläuft den Deaktivieren-, Laden- und Aktivieren-Pfad von EternalTD —, sodass alles, was der Start tut, erneut passiert:

  • alte Ordner Levels/ und NPCs/ werden auf Kleinschreibung migriert
  • der Importer läuft erneut
  • Inhaltspakete, Wellen, Level, Weltvorlagen und NPCs werden neu geladen
  • der Paketaktualisierungs-/Zugriffsstatus wird aktualisiert
  • der Ressourcenpaket-Helfer initialisiert sich neu

Zwei wissenswerte Konsequenzen:

  • Jede laufende Level-Sitzung wird abgebaut, weil das Neuladen über das normale Herunterfahren des Plugins läuft.
  • FreeMinecraftModels wird von /etd reload nicht neu geladen. Laden Sie die Inhalte von FMM mit dessen eigenem Befehl neu, wenn Sie Modell-Assets von Hand importiert haben.

Bereits verbundene Spieler​

manageSpawn teleportiert Spieler normalerweise beim Beitritt zum Hub, aber Spieler, die sich verbinden, während EternalTD noch initialisiert, verpassen das (die Hub-Welt und der Join-Listener existieren erst nach Abschluss der Initialisierung). Sobald die Initialisierung abgeschlossen ist, geht EternalTD alle bereits online befindlichen Spieler durch und teleportiert jeden, der noch nicht in der Hub-Welt ist, zum konfigurierten Spawn.