
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
- Download the latest release
- Place the JAR file in your server's
pluginsfolder - Start/restart your server
- A
packsfolder will be created inplugins/Resourceloader/ - Place your resource pack files in the
packsfolder - Configure the packs in
config.yml - Use
/resourcereloadto apply changes
File-based Resource Packs
To use file-based resource packs:
- Place your .zip resource pack files in the
plugins/Resourceloader/packs/folder - In config.yml, use just the filename (e.g., "my-pack.zip") instead of a full URL
- The plugin will automatically look for the file in the packs folder
URL-based Resource Packs
For URL-based packs:
- Use the complete URL in config.yml (e.g., "https://example.com/pack.zip")
- Ensure the URL is directly downloadable
- 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.propertiesto 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
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
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
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.
Комментарии
Загружаем…