Skip to main content

ResourcePackManager Setup

ResourcePackManager merges, hosts, and distributes resource packs from supported plugins and from manual mixer entries.

  1. Install ResourcePackManager.jar.
  2. Start the server once so the config, mixer, blueprint, and output folders are generated.
  3. Decide whether you want:
    • RSPM auto-hosting
    • forced client acceptance
    • manual custom packs in the mixer folder
  4. Run /rspm reload after changing RSPM config or after adding custom packs manually.

Core Commands​

  • /rspm setup — tells you to edit config files directly (no GUI)
  • /rspm reload — rebuilds and re-hosts the merged pack
  • /rspm itemsadder configure — configures ItemsAdder for RSPM hosting
  • /rspm itemsadder dismiss — permanently dismisses the ItemsAdder warning for your player
  • /rspm data_compliance_request — downloads all remotely stored data for this server

ItemsAdder​

The current preferred ItemsAdder path is no longer manual-only.

Use:

/rspm itemsadder configure

That helper updates the relevant ItemsAdder settings, triggers regeneration, and then reloads ResourcePackManager.

If ItemsAdder is already configured to host its own pack (self-host, external-host, or lobfile), the helper stops and tells you to disable ItemsAdder hosting manually first.

Bedrock / GeyserMC Support​

ResourcePackManager can automatically convert the merged Java resource pack into a Bedrock resource pack for GeyserMC. This is currently limited to FreeMinecraftModels bone models.

To enable:

  1. Set bedrockConversionEnabled: true in config.yml.
  2. If Geyser is installed on the same server, the converted pack and custom mappings file are deployed automatically. Set bedrockAutoDeployToGeyser: false to disable this.
  3. If auto-detection does not find your Geyser folder, set bedrockGeyserFolder to the path manually (absolute or relative to the plugins directory).
  4. Restart the server after the Bedrock pack is generated so Geyser loads the new pack.

The generated files are written to:

plugins/ResourcePackManager/output/ResourcePackManager_Bedrock.zip
plugins/ResourcePackManager/output/rspm_geyser_mappings.json