Перейти к содержимому
Mineforgian

ResourceLoader

A simple and flexible resource pack loader and merger plugin for your servers.

Загрузки
4K
Подписчики
21
Обновлён
19 мая 2026 г.
Лицензия
GPL-3.0-only

Опубликован 26 декабря 2024 г.

Resourceloader

A simple and flexible resource pack loader and merger plugin for Minecraft servers. Load different resource packs and merge multiple packs into one with ResourceLoader!

Features

  • Load the server's default resource pack with a simple command
  • Configure and load multiple additional resource packs
  • Merge multiple resource packs in the plugin itself
  • Support for both URL and file-based resource packs
  • Easy-to-use commands
  • Permission-based access control
  • Simple configuration

Commands

  • /load - Load the default server resource pack
  • /load <packname> - Load a specific resource pack
  • /mergepack <output-file>.zip <pack1> <pack2> [pack3...] - Merge existing resource packs in the plugin itself
  • /listpacks - List all available resource packs
  • /resourcereload - Reload the plugin configuration
  • /resourceversion - Check the version of ResourceLoader you're running

Permissions

  • resourceloader.load - Allows using the /load command (default: true)
  • resourceloader.list - Allows using the /listpacks command (default: true)
  • resourceloader.reload - Allows reloading the plugin configuration (default: op)
  • resourceloader.admin - Allows access to all the admin commands of ResourceLoader (default: op)

Configuration

# Main server resource pack
# Can be either a URL or a file name in the packs folder
# For URLs: "https://example.com/server-pack.zip"
# For files: "server-pack.zip"
server-pack: "server-pack.zip"

# Web server settings
server-port: 40021  # Default port, can be changed to any open port on your host
localhost: false    # Set to false for production servers, true only for local testing
server-address: ""  # Will try to auto-detect if empty
fallback-address: "localhost"  # Used if auto-detection fails

# Additional resource packs
# Can use either URLs or files from the packs folder
# For URLs: "https://example.com/examplepack.zip"
# For files: "example-pack.zip"
resource-packs:
  exampleurlpack: "https://example.com/examplepack.zip"
  examplefilepack: "example-pack.zip"

Installation

  1. Download the latest release
  2. Place the JAR file in your server's plugins folder
  3. Start/restart your server
  4. A packs folder will be created in plugins/Resourceloader/
  5. Place your resource pack files in the packs folder
  6. Configure the packs in config.yml
  7. Use /resourcereload to apply changes

File-based Resource Packs

To use file-based resource packs:

  1. Place your .zip resource pack files in the plugins/Resourceloader/packs/ folder
  2. In config.yml, use just the filename (e.g., "my-pack.zip") instead of a full URL
  3. The plugin will automatically look for the file in the packs folder

URL-based Resource Packs

For URL-based packs:

  1. Use the complete URL in config.yml (e.g., "https://example.com/pack.zip")
  2. Ensure the URL is directly downloadable
  3. The URL must point to a valid Minecraft resource pack .zip file

Requirements

  • Minecraft 1.13 or newer
  • Spigot/Paper server

Support

If you encounter any issues or have suggestions, please contact @vortexunwanted on discord.

Ченджлог

2.4Релиз26.1, 26.1.1, 26.1.2 · 19 мая 2026 г.

Added startup and reload config migration for bundled YAML files that preserves existing server values and creates backups. Improved custom pack directory handling, URL encoding, async pack hashing, resource-pack server safety, and enforcement config key usage.

2.3Релиз1.21.8, 1.21.9, 1.21.10 · 22 ноября 2025 г.
  • Fixed config reading issues
  • Improved logging
  • Improved merged pack integrity
2.2Релиз1.21.8, 1.21.9, 1.21.10 · 13 июля 2025 г.

Resource Pack Validation System

  • Added /checkpack <packname> command for comprehensive pack validation
  • Validates pack structure, JSON files, and texture references
  • Checks pack.mcmeta format and compatibility with server version
  • Provides detailed error reports and warnings
  • Supports both local and URL-based pack validation

Performance Optimizations

  • Implemented SHA1 hash caching system to prevent redundant downloads
  • Added automatic cache cleanup with configurable retention periods
  • Optimized pack serving with reduced memory footprint
  • Enhanced file system event batching to reduce server load

Improved Pack Merging

  • Enhanced JSON merging with intelligent handling of model files and blockstates
  • Automatic pack format detection and compatibility adjustment
  • Better conflict resolution for duplicate textures and assets
  • Improved metadata preservation during merge operations

File System Operations

  • Resolved recursive renaming loops and duplicate notifications
  • Fixed file watcher to properly batch events and prevent spam
  • Added processing locks and delays to handle rapid file system changes
  • Improved file operation error handling and recovery

Monitoring and Statistics

  • Added pack usage tracking and performance metrics
  • Implemented player preference history with configurable limits
  • Enhanced cache statistics and monitoring capabilities
  • Improved validation result reporting with formatted output

Security and Stability

  • Added input sanitization for pack names and file paths
  • Enhanced permission validation throughout command execution
  • Implemented safer file operations with atomic writes where possible
  • Improved configuration protection against corruption
2.1Релиз1.21.3, 1.21.4, 1.21.5 · 29 мая 2025 г.
  • Fixed /autoload
  • Added functionality for utilizing server.properties to load resource pack before player joins
  • Added customizable resource pack folder path
  • Allowed auto-detection to be toggle-able
  • Fixed bugs in messages
  • Added new messages.yml
  • Made resource pack merging more efficient and space conscious
  • Made resource pack loading smoother and more dynamic
2.0.1Релиз1.21.3, 1.21.4, 1.21.5 · 25 мая 2025 г.

Recompiled with Java 17 instead of 23.

2.0Релиз1.21.3, 1.21.4, 1.21.5 · 25 мая 2025 г.

New Features

  1. Resource Pack Enforcement

    • Server owners can now require players to use resource packs
    • Players can be kicked or restricted if they decline the pack
    • Admins can give special players permission to bypass this requirement
    • Better messages when packs are loading, accepted, or fail
  2. Smart Caching System

    • Resource packs now load much faster for returning players
    • Server automatically cleans up old cached packs
    • Less bandwidth usage for both server and players
    • Better handling of connection issues
  3. Performance Improvements

    • Much faster resource pack loading
    • Better handling of large packs
    • Reduced server resource usage
    • Smoother experience when switching packs

Quality of Life Updates

  • Better error messages when something goes wrong
  • Clearer feedback when loading packs
  • More reliable pack merging
  • Updated for latest Minecraft version

For Server Admins

New configuration options in config.yml:

enforcement:
  enabled: false      # Turn on/off required resource packs
  action: kick        # What happens when players decline (kick or restrict)
  decline-message: "You must accept the resource pack!"
cache:
  enabled: true       # Turn on/off pack caching
  days: 7            # How long to keep cached packs
  auto-cleanup: true  # Automatically remove old cache
1.3Релиз1.21.2, 1.21.3, 1.21.4 · 31 декабря 2024 г.

/mergepack added

Users can now merge multiple resource packs on their server into a single pack right in their server itself!

1.2Релиз1.21.2, 1.21.3, 1.21.4 · 29 декабря 2024 г.

Rewrote the entire file path support.

The webserver that's created for hosting the resource pack files locally is now more secure and optimized.

Added a version checking command

/resourceversion (/rv) now tells you the version of Resourceloader you're running.

Комментарии

Загружаем…