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 — die Proxy-Einrichtung ist anders und benötigt ein eigenes Jar.

Empfohlene Einrichtung (Eigenständig)​

  1. Lege ResourcePackManager.jar in den plugins/-Ordner deines Servers.
  2. Starte den Server einmal, damit die Konfiguration sowie die Ordner Mixer, Blueprint, Output und Proxy-Extension 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 — gibt einen einzeiligen Hinweis aus, dass du die Konfigurationsdateien direkt bearbeiten sollst (es gibt kein GUI-Menü)
  • /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.

Berechtigungen:

  • /rspm setup erfordert resourcepackmanager.setup und ist nur für Spieler nutzbar (er gibt lediglich einen einzeiligen Hinweis auf die Konfigurationsdateien aus).
  • /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, führt /iazip aus 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
  • versendet /iazip
  • lädt ResourcePackManager nach einer Pause von 5 Sekunden neu

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-Extension-Jars — Pfade zu den gebündelten Velocity-/Bungee-Jars (auch auf eigenständigen Servern extrahiert — nützlich, falls du später einen Proxy hinzufügst)
  • Integrationen — Floodgate-/Geyser-Spigot-Erkennung, Anzahl Online-Spieler

Wenn etwas nicht passt, siehe Fehlerbehebung.

Wie es weitergeht​