Zum Hauptinhalt springen

ResourcePackManager – Einrichtung

Diese Seite behandelt die Einrichtung auf einem einzelnen Server (eigenständig). Wenn du ein BungeeCord-/Waterfall-/Velocity-Netzwerk betreibst, folge stattdessen Proxy-Netzwerke — du installierst dieselbe ResourcePackManager.jar auf dem Proxy, aber sie erzeugt ihre eigene Konfiguration und übernimmt eine proxy-seitige Rolle.

ResourcePackManager 2.x wird als einzelne universelle Jar ausgeliefert. Exakt dieselbe ResourcePackManager.jar läuft auf Bukkit-/Paper-Backends und auf Velocity-/BungeeCord-/Waterfall-Proxys — sie erkennt die Plattform automatisch anhand des Loaders, unter dem sie läuft. Es gibt keine separaten resourcepackmanager-velocity-*.jar-/resourcepackmanager-bungee-*.jar-Dateien und keine gebündelte „Proxy-Erweiterung", die zu extrahieren und irgendwohin zu kopieren wäre.

Empfohlene Einrichtung (Eigenständig)​

  1. Lege ResourcePackManager.jar in den plugins/-Ordner deines Servers. (Das ist dieselbe Jar, die du auch auf einem Velocity-/BungeeCord-Proxy verwenden würdest — es gibt keine separaten Proxy-Jars.)
  2. Starte den Server einmal, damit die Konfiguration sowie die Ordner Mixer, Blueprint und Output erzeugt werden.
  3. Entscheide, ob du möchtest:
    • Selbst-Hosting (Standard, aktiv)
    • MagmaGuys kostenlosen Auto-Host als Fallback (Standard, aktiv)
    • erzwungene Client-Annahme
    • manuelle eigene Pakete im Mixer-Ordner
  4. Führe /rspm reload aus, nachdem du die Konfiguration geändert oder eigene Pakete manuell hinzugefügt hast.

Das war's für den Standardfall. Mit den Standardeinstellungen versucht RSPM zuerst Selbst-Hosting und fällt automatisch auf MagmaGuys CDN zurück, falls etwas nicht passt.

Kernbefehle​

  • /rspm setup — öffnet ein In-Game-GUI-Einrichtungsmenü (Plugin-Update-Status, empfohlene Plugins, ein Umschalter für automatische Updates und eine Info-Schaltfläche mit anklickbaren Links zum Wiki, zu Discord und zum Token deines Nightbreak-Kontos)
  • /rspm reload — baut das zusammengeführte Paket neu auf und stellt es erneut bereit
  • /rspm status — gibt einen vollständigen Diagnose-Dump aus: Paket-Status, Hosting-Modus, Netzwerkschlüssel, Integrationen
  • /rspm itemsadder configure — konfiguriert ItemsAdder automatisch für das RSPM-Hosting (siehe unten)
  • /rspm itemsadder dismiss — verwirft die ItemsAdder-Warnung für deine Spieler-UUID dauerhaft
  • /rspm data_compliance_request — lädt alle remote gespeicherten Daten für diesen Server herunter

Der Hauptbefehl ist /resourcepackmanager, mit /rspm als Alias. RSPM erbt außerdem einige gemeinsam genutzte MagmaCore-/Nightbreak-Unterbefehle (z. B. /rspm recommendedplugins, /rspm downloadall), auf die das Einrichtungsmenü verweist.

Berechtigungen:

  • /rspm setup erfordert resourcepackmanager.setup und ist nur für Spieler nutzbar (es öffnet eine Inventar-GUI, kann also nicht aus der Konsole ausgeführt werden).
  • /rspm reload, /rspm status, /rspm itemsadder <configure|dismiss> und /rspm data_compliance_request erfordern alle resourcepackmanager.*.

ItemsAdder​

Der derzeit bevorzugte ItemsAdder-Weg ist nicht mehr ausschließlich manuell.

Verwende:

/rspm itemsadder configure

Dieser Helfer aktualisiert die relevanten ItemsAdder-Einstellungen, regeneriert das Paket von ItemsAdder und lädt anschließend ResourcePackManager neu. Konkret:

  • setzt resource-pack.hosting.no-host.enabled: true
  • deaktiviert protection_1, protection_2 und protection_3 in resource-pack.zip.protect-file-from-unzip
  • setzt resource-pack.zip.compress-json-files: false (RSPM benötigt unkomprimiertes, parsebares Modell-JSON für den Mixer und den Bedrock-Konverter)
  • versendet /iareload, dann /iazip
  • lädt ResourcePackManager etwa 15 Sekunden später neu, nachdem ItemsAdder Zeit zum Neuladen und Regenerieren hatte

Wenn ItemsAdder bereits so konfiguriert ist, dass es sein eigenes Paket hostet (self-host, external-host oder lobfile), bricht der Helfer ab und weist dich an, das ItemsAdder-Hosting zuerst manuell zu deaktivieren.

Bedrock-/GeyserMC-Unterstützung​

RSPM wandelt das zusammengeführte Java-Paket automatisch in ein Bedrock-Paket für GeyserMC um. Die Konvertierung verarbeitet Pakete jedes Plugins im Items-Definitionsformat 1.21.4+ — nicht nur FreeMinecraftModels — einschließlich 3D-gehaltener Items, benutzerdefinierter Rüstung und modellierter Ausrüstung.

bedrockConversionEnabled ist standardmäßig auf true gesetzt, sodass eine frische Installation auf einem Server mit GeyserMC sofort funktioniert.

Für einen eigenständigen Server wird die Konvertierung ausgelöst, wenn eines davon zutrifft: Geyser-Spigot ist auf diesem Server installiert, Floodgate ist auf diesem Server installiert, oder RSPM hat den Proxy-Modus erkannt (siehe Proxy-Netzwerke).

Siehe Bedrock-/Geyser-Konvertierung für die vollständige Pipeline, die Ausgabepfade und die Feinjustierung der Anzeige-Offsets.

Einrichtung verifizieren​

Führe /rspm status in der Konsole oder als Op aus. Die Ausgabe ist in Abschnitte unterteilt:

  • Plugin-Meta — Version + Deploy-Modus (eigenständig vs. network-backend)
  • Java Pack — gemischt ja/nein, Größe, SHA1-Präfix
  • Bedrock Pack — konvertiert ja/nein, Mappings vorhanden, mit Diagnose-Hinweisen, falls die Konvertierung übersprungen wurde
  • Hosting — welcher Auslieferungspfad aktiv ist (self-hosted / remote / noch nicht bereit), die URL, die Clients sehen, der aufgelöste externe Host, die automatisch erkannte öffentliche IP
  • Proxy deployment — ein Hinweis, dass die Netzwerk-Proxy-Jar dieselbe ResourcePackManager.jar ist; kopiere sie in einem Netzwerk in den plugins/-Ordner des Proxys
  • Integrationen — Floodgate-/Geyser-Spigot-Erkennung, Anzahl Online-Spieler

Wenn etwas nicht passt, siehe Fehlerbehebung.

Wie es weitergeht​