Skip to main content

Resource Pack Manager Troubleshooting

Troubleshooting​

Server side issue: Failed to Load (404 Error)​

When a player connects, Minecraft tries to download the resource pack generated by RSPM from the auto-hosted link. A 404 error means the hosting server responded with “file not found,” so the resource pack cannot be downloaded.

rspm_failed_to_reach_server.jpg

Expand for more Info

Important note:
This hosting service is internal to RSPM and not configurable by server admins. The download link is generated automatically.

Common causes:

  • The hosting service is temporarily down or unreachable.
  • The resource pack failed to upload correctly during generation.
  • The link is blocked by a firewall, ISP, or network restrictions (common in schools or workplaces).
  • SSL/HTTPS connections are blocked by your server's firewall or proxy.

How to fix:

  1. Have the affected player copy the resource pack URL from their Minecraft chat or console and try to open it in a web browser.
  2. If it loads correctly in the browser but not in Minecraft, the player may have a caching issue; restarting Minecraft usually resolves this.
  3. If the link does not open in the browser, try regenerating the resource pack by running /rspm reload on the server and then rejoin.
  4. If all players experience this issue, it may indicate that the hosting service is temporarily unavailable, wait and try again later.

Server side issue: Session Expired or Lost Connection​

The resource pack hosting session has expired or the connection to the hosting server was lost. This causes the 404 error when players try to download the pack.

Expand for more Info

Common causes:

  • Server was offline or crashed for an extended period.
  • Server underwent extended maintenance without keep-alive pings.
  • Hosting session expired after 24 hours of inactivity.

How to fix:

  1. Run /rspm reload to re-initialize the hosting session and re-upload the resource pack.
  2. Wait a few seconds for the upload to complete, then have players reconnect.
  3. Check server console for any error messages from ResourcePackManager during startup or reload.

Technical details: ResourcePackManager sends keep-alive pings to the hosting server every 6 hours to maintain the session. If the server is offline for more than 24 hours, the session is automatically cleaned up and must be re-initialized.

Server side issue: SSL/HTTPS Connection Blocked​

ResourcePackManager cannot connect to the hosting server because HTTPS connections are being blocked by your server's firewall, proxy, or network configuration.

Expand for more Info

Common causes:

  • Server firewall blocking outbound HTTPS connections to magmaguy.com.
  • Corporate or network proxy requiring SSL inspection or authentication.
  • Restrictive hosting environment that limits external connections.
  • SSL certificate validation failures due to outdated Java or system configurations.

How to fix:

  1. Check your server's firewall rules and allow outbound HTTPS connections to https://magmaguy.com/rsp/.
  2. If behind a corporate proxy, configure Java to use the proxy settings or whitelist the hosting domain.
  3. Ensure your Java installation is up to date with current SSL certificates.
  4. If auto-hosting cannot work in your environment, consider using the resourcePackRerouting option to self-host the pack on your own web server or CDN.

Technical note: ResourcePackManager uses HTTPS (SSL) for all connections to the hosting server for security. HTTP connections are not supported.

Server side issue: Error in Console Resource Pack Size Exceeds Limit​

The resource pack generated by RSPM exceeds the maximum allowed size for auto-hosting on the server, which is currently set to 50 MB.

rspm_resource_pack_size_limit.jpg

Expand for more Info

Common causes:

  • Adding too many or very large resource packs to be merged.
  • Including high-resolution textures or large custom models that increase pack size.

How to fix:

  • Remove or reduce the size of some resource packs or assets.
  • Optimize textures and models to be smaller in file size.
  • Consider disabling auto-hosting in the config.yml and hosting the resource pack yourself using an external web host.

Note:
The 50 MB size limit is set to ensure reliable and fast downloads for players and is subject to change based on hosting provider policies.

Client side issue: Failed to Load (Invalid Resource Pack)​

Minecraft successfully downloaded the resource pack, but rejected it because the pack is corrupted, incomplete, or missing essential files.

rspm.jpg

Expand for more Info

Common causes:

  • The merging process failed due to incompatible resource packs from different plugins.
  • One or more source packs contain malformed files, such as broken JSON files or invalid mcmeta files.
  • Asset file paths exceed Minecraft’s maximum allowed folder depth or include illegal characters.

How to fix:

  1. Run /rspm reload to force a clean regeneration of the merged resource pack.
  2. Temporarily remove any recently added plugins that add resource packs, then try again to see if the issue resolves.
  3. Add those plugins back one by one, testing after each, to identify which resource pack is causing the problem.
  4. Check the RSPM server logs for warnings about merge conflicts or missing files, which can help pinpoint the source of the issue.

Client side issue: Purple and Black Textures or Purple and Black Cube Models​

The purple-and-black checkerboard pattern in Minecraft indicates the game cannot find the required texture or model in the loaded resource pack. Seeing purple cubes instead of custom models means the model JSON exists but references a missing or invalid texture or model files.

rspm_purple_and_black_squares.jpg

Expand for more Info

Common causes:

  • The required texture was not included in the merged resource pack.
  • The model JSON file points to an incorrect or outdated texture path.
  • Conflicts between multiple plugin resource packs where one pack overwrites another’s assets.

How to fix:

  1. Use the priorityOrder list in config.yml to make sure the correct resource pack has precedence during merging.
  2. Verify the missing texture file is present in the original source resource pack.
  3. Check the model JSON file to confirm its texture path matches the actual file location in the pack.
  4. After making corrections, run /rspm reload to regenerate the merged pack and test again.

Client side issue: GUI Textures for Menus are Offset​

When GUI textures appear misaligned—such as icons shifted or bars out of place—it is usually caused by conflicts in font files. Minecraft only supports one active font set at a time, so multiple packs overriding fonts can cause display issues.

rspm_offset_textures.jpg

Expand for more Info

Common causes:

  • Several plugin resource packs modify font/default.json or related font files.
  • RSPM merges these without a clear priority set for which font to use.

How to fix:

  1. Open plugins/ResourcePackManager/config.yml and find the priorityOrder section.
  2. Move the plugin pack whose fonts you want to preserve to the top of the list.
  3. Run /rspm reload to regenerate the merged resource pack.

Note: It is not possible to fully merge multiple font files in Minecraft—only one font set will take effect, so priority must be chosen.

Client side issue: Loaded but Some Elements Don’t Work​

Some items, textures, or models either load incorrectly or do not appear at all in the game.

rspm.jpg

Expand for more Info

Common causes:

  • Mismatch between the Minecraft client version and the server version (for example, between different minor versions like 1.20.6 vs 1.21.0).
  • Use of ViaVersion or similar plugins that allow clients with unsupported versions to connect.
  • Resource packs using newer model formats that older clients cannot handle, or vice versa.

How to fix:

  1. Make sure all players use the same Minecraft version as the server.
  2. If you have ViaVersion installed, know that some assets may not work properly until full compatibility is added.
  3. Keep both client and server resource pack features within the same supported Minecraft version range to avoid conflicts.

Client side issue: Loaded but Assets from One Plugin Override Another​

Two or more plugin resource packs contain files with the same names and paths. When RSPM merges them, the pack lower in the priority order overwrites the assets from the one above it.

rspm.jpg

Expand for more Info

How to fix:

  1. Open plugins/ResourcePackManager/config.yml.
  2. In the priorityOrder list, move the plugin whose assets you want to keep higher up, above the conflicting ones.
  3. Run /rspm reload to regenerate the merged resource pack.

Default Priority Order: ResourcePackManager uses the following priority order by default (highest to lowest):

  1. ResourcePackManager
  2. EliteMobs
  3. FreeMinecraftModels
  4. ModelEngine
  5. Nova
  6. ItemsAdder
  7. Oraxen
  8. BetterHUD
  9. ValhallaMMO
  10. MMOInventory
  11. vane-core
  12. RealisticSurvival

You can customize this order in config.yml to prioritize different plugins.

Note: Minecraft 1.20.3 and newer support multiple resource packs simultaneously, while older versions replace the entire pack when conflicts occur. In cases where conflicts cannot be resolved by priority alone, manual merging or editing of the source resource packs may be necessary.

Client side issue: Slow Resource Pack Download​

Players may experience slow downloads or lag when the resource pack is being sent by the server. This is usually due to the resource pack being hosted on remote servers, meaning download speed depends on the player's location and internet quality.

rspm_slow_rp_download.jpg

Expand for more Info

Common causes:

  • Player is located far from the hosting server geographically.
  • The player's internet connection is slow or unstable.
  • Temporary network congestion between the player and the hosting server.

How to fix or mitigate:

  1. Encourage players to check their internet connection speed and stability.
  2. Players can try connecting from a different network or location to see if the speed improves.
  3. If slow downloads are a persistent problem, consider hosting the resource pack on an alternative hosting service closer to your player base. You can disable RSPM’s auto-hosting in the config and provide a direct resource pack URL in server.properties.
  4. Make sure the resource pack size is optimized and not larger than necessary to minimize download time.

Note: Unfortunately, due to the nature of remote hosting, some players will experience slower downloads based on factors outside server control.

Understanding Automatic Resource Pack Updates​

ResourcePackManager automatically monitors resource pack files for changes and regenerates the merged pack when updates are detected. This happens without needing to run /rspm reload manually.

Expand for more Info

How it works:

  • ResourcePackManager continuously monitors all registered resource pack files and directories.
  • When changes are detected, it waits for file stability (no changes for 10 seconds) before processing.
  • Once stable, the plugin automatically merges the updated packs and re-uploads to the hosting server.
  • Players who join after the update will receive the new pack automatically.

Important notes:

  • Files must remain unchanged for 10 seconds before processing begins to avoid merging incomplete updates.
  • SHA1 hash checking prevents redundant uploads—the pack only re-uploads if the content actually changed.
  • Existing players need to disconnect and reconnect to receive the updated pack.

Troubleshooting automatic updates:

  • If packs seem "stuck" and won't update, the files may be changing too frequently. Ensure all file operations are complete before expecting an update.
  • Check server console for ResourcePackManager messages indicating file changes were detected.
  • If automatic updates are not desired, you can disable file monitoring by regenerating packs manually with /rspm reload only.

Configuration Options Reference​

ResourcePackManager provides several configuration options in plugins/ResourcePackManager/config.yml that can help resolve or prevent issues.

Expand for more Info

Available Configuration Options:

  • autoHost (default: true)

    • Enables automatic hosting of the merged resource pack on MagmaGuy's servers.
    • Set to false if you want to host the pack yourself using an external web server or CDN.

  • forceResourcePack (default: false)

    • When set to true, players must accept the resource pack to join the server.
    • Players who decline the pack will be disconnected.

  • resourcePackPrompt (default: "Use recommended resource pack?")

    • Customizes the message shown to players when they connect.
    • You can change this to provide specific instructions or information about your resource pack.

  • resourcePackRerouting (default: "" - empty)

    • Specifies a directory path where the merged resource pack should be copied.
    • Useful for self-hosting scenarios where you want to upload the pack to your own web server or CDN.
    • Example: resourcePackRerouting: "C:/webserver/htdocs/resourcepack/"

  • priorityOrder (default: list of 12 plugins)

    • Controls which plugin's assets take precedence when there are file conflicts.
    • Higher position in the list means higher priority.
    • See the "Assets from One Plugin Override Another" section for the default list.

Common Configuration Scenarios:

Self-hosting the resource pack:

  1. Set autoHost: false
  2. Set resourcePackRerouting: "/path/to/your/webserver/"
  3. Configure your web server to serve the generated pack file
  4. Set the resource pack URL in server.properties

Forcing players to use the pack:

  1. Set forceResourcePack: true
  2. Optionally customize resourcePackPrompt to explain why the pack is required

Supported Plugins​

ResourcePackManager officially supports resource packs from the following plugins. The plugins are listed in their default priority order (highest to lowest).

Expand for more Info

Plugins in Default Priority Order:

  1. ResourcePackManager - The plugin itself
  2. EliteMobs - Custom boss and mob system
  3. FreeMinecraftModels - Custom model library
  4. ModelEngine - Advanced custom entity models
  5. Nova - Item and block customization framework
  6. ItemsAdder - Custom items, blocks, and models
  7. Oraxen - Custom items and resource pack manager
  8. BetterHUD - HUD customization plugin
  9. ValhallaMMO - MMO progression system
  10. MMOInventory - Custom inventory system
  11. vane-core - Vane server suite core plugin
  12. RealisticSurvival - Survival gameplay enhancements

Additional Supported Plugins: Some plugins have official support but are not included in the default priority order. You can add them manually to your config.yml:

  • BackpackPlus - Backpack storage system
  • InfiniteVehicles - Custom vehicle plugin
  • MegaBlockSurvivors - Block-based survival game

Important Notes:

  • Plugins higher in the priority order will have their assets take precedence when there are conflicts.
  • You can add any plugin to the priority order, even if it's not officially supported, as long as it provides a resource pack.
  • The order can be customized in plugins/ResourcePackManager/config.yml under the priorityOrder section.