Zum Hauptinhalt springen

ResourcePackManager – Einrichtung

Diese Seite behandelt die Einrichtung auf einem einzelnen Server (eigenständig). Wenn du ein BungeeCord-/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. Dieselbe ResourcePackManager.jar läuft auf Bukkit-/Paper-Backends und Velocity-/BungeeCord-Proxys; sie erkennt die Plattform anhand des Loaders. Es gibt keine separaten resourcepackmanager-velocity-*.jar-/resourcepackmanager-bungee-*.jar-Dateien mehr zum Extrahieren. Erkennt RSPM ein Proxy-Backend ohne gespeicherten oder anfangs abgeleiteten Netzwerkschlüssel, legt es eine Kopie seiner Jar unter plugins/ResourcePackManager/proxy-extension/ResourcePackManager.jar zum Kopieren auf den Proxy ab: dieselbe Datei an einem praktischen Ort.

Der Backend-Plugin-Deskriptor deklariert Bukkit-API 1.21.4, der Bukkit-/Paper-Server muss also Minecraft 1.21.4 oder neuer sein. Die mitgelieferte Geyser-Erweiterung für benutzerdefinierte Entities zielt auf Geyser 2.11+.

  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.

Mit den Standardeinstellungen versucht RSPM zuerst verifiziertes Selbst-Hosting und fällt auf Remote-Hosting über magmaguy.com zurück, wenn die Verifikation fehlschlägt oder nicht verfügbar ist. Scheitern beide automatischen Pfade, kann es keine neue Auslieferungs-URL ankündigen. Prüfe den endgültigen Status und einen Client-Download, bevor du die Einrichtung als abgeschlossen ansiehst.

Nach erfolgreicher Einrichtung des Hostings erscheint beispielsweise diese Konsolenzeile:

[ResourcePackManager] Resource pack is live via self-hosting — http://play.example.com:25566/rspm.zip

RSPM hält die Konsole absichtlich still — es meldet das Ergebnis, nicht jeden Schritt, und es warnt nicht vor Zuständen, von denen es sich selbst erholt (ein fehlgeschlagener Selbst-Hosting-Test gefolgt von einem erfolgreichen Fallback ist ein Erfolg, kein Fehler). Wenn etwas untersucht werden muss, führe /rspm verbose on aus (oder setze verboseLogging: true in der config.yml) und lade neu. Siehe Fehlerbehebung.

Ordner, die RSPM erzeugt​

Unter plugins/ResourcePackManager/:

OrdnerWofür er da ist
mixer/Lege hier fertige .zip-Pakete ab, um sie einzumischen. Verweise in priorityOrder mit ihrem exakten Dateinamen inklusive .zip auf sie.
resource_pack/Lege hier ein entpacktes Paket ab (ein Ordnerbaum mit assets/, pack.mcmeta, ...). RSPM zippt es und führt es unter dem Prioritätseintrag ResourcePackManager zusammen, der ganz oben in der Standard-priorityOrder steht.
blueprint/Enthält die Standard-pack.png und -pack.mcmeta, die RSPM zum Merge beisteuert. Bearbeite diese, um das Symbol des zusammengeführten Pakets oder seine pack.mcmeta-Beschreibung zu ändern; der Ordner wird bei jedem Start neu zu blueprint.zip gezippt.
output/Die fertigen Artefakte: ResourcePackManager_RSP.zip, dazu ResourcePackManager_Bedrock.zip und rspm_geyser_mappings.json, wenn die Bedrock-Konvertierung sie erzeugt hat.
compatible_plugins/Eine YAML-Datei pro unterstützter Plugin-Integration.
data_compliance/Wohin /rspm data_compliance_request seinen Download schreibt.
proxy-extension/Wird erstellt, wenn ein Proxy-Backend keinen gespeicherten oder anfangs abgeleiteten Netzwerkschlüssel hat. Enthält eine Kopie der laufenden ResourcePackManager.jar für den Proxy. Ein verbliebener Ordner belegt nicht, dass das Backend weiterhin unverbunden ist.
geyser-extension/Wird exportiert, wenn die automatische Erweiterungsinstallation aktiviert ist, Floodgate lokal vorhanden ist und Geyser-Spigot fehlt. Folge beim Kopieren in extensions/ des externen Geyser dem genauen Konsolenpfad; er kann in update/ liegen. Der Export konfiguriert keine externe Paketauslieferung.

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 recommendedplugins — zeigt das gemeinsame Nightbreak-Menü der empfohlenen Plugins
  • /rspm downloadpluginupdate — lädt ein verfügbares ResourcePackManager-Update für den nächsten Neustart herunter
  • /rspm downloadall — lädt jedes von diesem Plugin bereitgestellte verfügbare Update herunter (derzeit das ResourcePackManager-Update)
  • /rspm applypluginupdate — wird vom gemeinsamen Nightbreak-Befehlssatz registriert, aber RSPM verweigert ihn immer: ResourcePackManager updates need a server restart: its Geyser extension only loads when Geyser starts. Starte den Server neu, um ein heruntergeladenes Update anzuwenden.
  • /rspm reload — startet die Plugin-Initialisierung erneut und plant die Paketvorbereitung; ein unverändertes Paket kann seine bestehende Hosting-Registrierung weiterverwenden
  • /rspm status — gibt einen vollständigen Diagnose-Dump aus: Paket-Status, Hosting-Modus, Fingerabdruck des Netzwerkschlüssels, Integrationen
  • /rspm verbose [on|off] — schaltet die detaillierte Diagnose-Protokollierung ein oder aus, ohne die config.yml zu öffnen. Ohne Argument wird umgeschaltet. Die Wahl wird nach verboseLogging in die config.yml zurückgeschrieben und übersteht damit Neustarts. Alias: /rspm verboselogging.
  • /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. Die obigen Update- und Empfohlene-Plugins-Befehle sind gemeinsame MagmaCore-/Nightbreak-Befehle, die von RSPM registriert werden.

Berechtigungen:

  • /rspm setup und /rspm recommendedplugins erfordern resourcepackmanager.setup. /rspm setup ist nur für Spieler nutzbar, weil es eine Inventar-GUI öffnet.
  • /rspm downloadpluginupdate, /rspm downloadall, /rspm applypluginupdate, /rspm reload, /rspm status, /rspm verbose, /rspm itemsadder <configure|dismiss> und /rspm data_compliance_request erfordern resourcepackmanager.*.

ItemsAdder​

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

Verwende:

/rspm itemsadder configure

Dieser Helfer aktualisiert die relevanten ItemsAdder-Einstellungen, fordert die Paketerstellung an und wartet, bis RSPM den neuen Export zusammengeführt hat. 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)
  • führt nach 20 Server-Ticks /iareload aus, weitere 100 Ticks später /iazip
  • wartet, bis RSPMs Watchdog den neu erzeugten ItemsAdder-Export erkannt und den Merge abgeschlossen hat, und meldet dann RSPM merged the regenerated ItemsAdder export. Use /rspm status to check hosting. Schlägt dieser Merge fehl, meldet er, dass der Export nicht zusammengeführt werden konnte, und RSPM versucht es erneut.

Der Helfer lädt ResourcePackManager nicht neu. Er startet nicht, solange eine frühere Konfiguration noch aussteht, und er bricht ohne Speichern ab, wenn sich die config.yml von ItemsAdder während der Bearbeitung ändert. Verweigert ItemsAdder /iareload oder /iazip, führe diesen Befehl von Hand aus. Die Merge-Meldung bestätigt den Merge, nicht das Hosting: Prüfe anschließend /rspm status und einen echten Client-Download.

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 kann unterstützte Assets des zusammengeführten Java-Pakets in ein Bedrock-Paket für GeyserMC umwandeln. Es liest Item-Definitionen ab 1.21.4 von beliebigen Plugins, einschließlich unterstützter 3D-Items in der Hand und Ausrüstung. Das garantiert keine Konvertierung jedes Modellknotens, Prädikats oder Rüstungsdesigns. Die Grenzen stehen im unten verlinkten Konvertierungsleitfaden.

bedrockConversionEnabled ist standardmäßig auf true gesetzt. Die Konvertierung benötigt außerdem ein erkanntes Bedrock-Ziel und unterstützte Quelldateien; für die Registrierung beim Start kann der unten beschriebene Geyser-Neustart erforderlich sein.

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).

Wenn Geyser-Spigot lokal installiert und geyserExtensionAutoInstall: true gesetzt ist, installiert RSPM seine universelle Jar unter plugins/Geyser-Spigot/extensions/ oder stellt sie dort für den nächsten Start bereit. Starte den Server neu, um eine neu installierte oder bereitgestellte Erweiterung zu laden. Benutzerdefinierte Bedrock-Entities benötigen außerdem einen kompatiblen Erzeuger, der die Java-Entity über die Bridge markiert, registrierte Definitionen und das richtige Client-Paket. geyserExtensionAutoInstall: false verhindert künftige Installationen und Bereitstellungen; es entfernt keine installierte Jar und verwirft kein bereits bereitgestelltes Update. Siehe Geyser-Erweiterung & benutzerdefinierte Entities.

Siehe Bedrock-/Geyser-Konvertierung für die vollständige Pipeline, die Ausgabepfade und die Posen gehaltener Items.

Einrichtung überprüfen​

Für eine öffentliche HTTPS-Downloadadresse lässt du das automatische Hosting aktiviert und setzt selfHostExternalUrl auf die vollständige Paket-URL deines Reverse Proxys. Unter HTTPS und Reverse Proxys findest du die Einstellungen für den Listener und die Weiterleitung.

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). Auf einem Netzwerk-Backend gibt es zusätzlich einen kurzen, nicht geheimen Fingerabdruck des Netzwerkschlüssels aus sowie die Herkunft dieses Schlüssels (vom Proxy bereitgestellt / auf diesem Server gespeichert / aus Floodgates Schlüssel übernommen / noch nicht gesetzt).
  • Java-Paket — gemischt ja/nein, Größe, SHA1-Präfix
  • Bedrock-Paket — konvertiert ja/nein, Mappings vorhanden, mit Diagnose-Hinweisen, falls die Konvertierung übersprungen wurde
  • Hosting — aktiver Auslieferungspfad (selbst gehostet / remote / noch nicht bereit), Client-URL, aufgelöster externer Host, automatisch erkannte öffentliche IP und das Ergebnis der letzten Selbst-Hosting-Prüfung samt Grund, falls sie fehlgeschlagen ist
  • Proxy-Bereitstellung — erinnert daran, 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

Sobald der Status eine Auslieferungs-URL anzeigt, verbinde dich mit einem echten Client, akzeptiere das Paket und prüfe ein bekanntes benutzerdefiniertes Item oder Modell. Verbinde einen Bedrock-Client nach einer Paketerstellung erneut und starte Geyser neu, wenn neue Mappings oder Entity-Definitionen registriert werden müssen. Status und Hosting-Protokolle beschreiben die Veröffentlichung, nicht die Darstellung im Client.

Wenn etwas nicht passt, siehe Fehlerbehebung.

Wie es weitergeht​