MegaBlock Survivors Einrichtung

Der MegaBlock Survivors-Einrichtungsablauf basiert auf Nightbreak-verwalteten Inhaltspaketen, mit optionaler Modellunterstützung durch FreeMinecraftModels.

Voraussetzungen

• Java 21
• Ein Paper/Spigot-kompatibler Server auf der 1.21 API-Linie

Optionale Integrationen:

• FreeMinecraftModels für benutzerdefinierte Mob- und Waffenmodelle (Soft-Dependency)

Was MegaBlock Survivors erstellt

Beim Start initialisiert oder verwendet MegaBlock Survivors diese Pfade:

plugins/MegaBlockSurvivors/config.yml
plugins/MegaBlockSurvivors/content_packages/
plugins/MegaBlockSurvivors/imports/
plugins/MegaBlockSurvivors/worlds/
plugins/MegaBlockSurvivors/leaderboard.yml
plugins/MegaBlockSurvivors/version.txt

Konfiguration

config.yml enthält:

Schlüssel	Typ	Standard	Beschreibung
setupDone	boolean	false	Verfolgt, ob die Ersteinrichtungsanleitung abgeschlossen wurde

Ersteinrichtungswarnung

Wenn setupDone false ist, zeigt das Plugin eine Ersteinrichtungswarnung für Spieler mit der Berechtigung megablocksurvivors.* beim Beitritt an. Dies leitet sie durch den ersten Inhalts-Download.

Empfohlener Ersteinrichtungsablauf

1. Installiere MegaBlock Survivors und starte den Server einmal.
2. Verknüpfe dein Nightbreak-Konto mit /nightbreaklogin <token>.
3. Führe /mbs downloadall aus, um alle zugänglichen MegaBlock Survivors-Inhaltspakete nach plugins/MegaBlockSurvivors/imports herunterzuladen.
4. Führe /mbs setup jederzeit aus, um einzelne Pakete zu durchsuchen, zu aktivieren, zu deaktivieren oder zu aktualisieren.
5. Führe /mbs reload nach dem Herunterladen von Inhalten aus, um die neuen Karten und Ressourcen zu laden.

/nightbreaklogin <token> ist Teil des gemeinsamen Nightbreak/MagmaCore-Kontoablaufs und kein Befehl, der in der plugin.yml von MegaBlock Survivors deklariert ist.

Inhaltspakete

Inhaltspakete werden über YAML-Dateien im Ordner content_packages/ konfiguriert. Jedes Paket kann definieren:

Feld	Typ	Beschreibung
isEnabled	boolean	Ob das Paket aktiv ist
name	string	Anzeigename des Pakets
description	string list	Beschreibungszeilen
downloadLink	string	Manuelle Download-URL
version	integer	Paketversionsnummer
nightbreakSlug	string	Nightbreak-Inhalts-Slug für automatische Downloads
schematicFiles	string list	Im Paket enthaltene Schematic-Dateien
worldFolders	string list	Enthaltene Weltordner
worldContainerFolders	string list	Enthaltene Welt-Container-Ordner
modelFolders	string list	Modellordner für FreeMinecraftModels
markerFileName	string	Markierungsdatei zur Erkennung, ob das Paket installiert ist
category	enum	FREE, PREMIUM oder RESOURCES
toggleable	boolean	Ob das Paket ein-/ausgeschaltet werden kann

Versionsaktualisierungsbenachrichtigungen

Wenn das Plugin eine Versionsaktualisierung erkennt (durch Vergleich mit version.txt), benachrichtigt es die Konsole und alle online befindlichen OPs über die Versionsänderung.