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 mehr zum Extrahieren. (Wenn RSPM erkennt, dass dieses Backend hinter einem Proxy sitzt, der ihm nie einen Schlüssel gegeben hat, legt es eine Kopie seiner eigenen Jar unter plugins/ResourcePackManager/proxy-extension/ResourcePackManager.jar ab, damit du sie auf den Proxy kopieren kannst — dieselbe Datei, nur 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+.

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.

Ob es funktioniert hat, erkennst du an einer einzigen 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/Erscheint nur auf einem Backend, das hinter einem Proxy sitzt, der ihm nie einen Schlüssel gegeben hat. Enthält eine Kopie der laufenden ResourcePackManager.jar für den Proxy.
geyser-extension/Erscheint nur, wenn Floodgate lokal ist, Geyser aber ein externer Prozess. Enthält eine Kopie der Jar für den extensions/-Ordner dieses Geyser.

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

Wenn Geyser-Spigot auf diesem Server installiert ist, installiert sich RSPM zusätzlich als Geyser-Erweiterung in plugins/Geyser-Spigot/extensions/ — das ist es, was benutzerdefinierte Bedrock-Entities statt Armor Stands rendern lässt. Es ist dieselbe ResourcePackManager.jar — nichts zusätzlich herunterzuladen —, sie benötigt aber einen Server-Neustart, um wirksam zu werden. Setze geyserExtensionAutoInstall: false in der config.yml, damit RSPM diese Erweiterung nicht mehr installiert und bereitstellt. Siehe Geyser-Erweiterung & benutzerdefinierte Entities.

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