ResourceLoader
A powerful and flexible resource pack management plugin for Minecraft servers. Manage, merge, and distribute resource packs with advanced features for optimization and user experience!
Features
1.
Advanced resource pack management system with automatic backups and statistics
2.
Smart compression system with adaptive compression levels based on player connection
3.
Merge multiple resource packs with conflict resolution and preview options
4. Support for both
URL and file-based resource packs
5.
Automatic resource pack enforcement with customizable actions
6.
Automatic sync between packs folder and configuration
Performance optimizations with caching and compression
7.
GUI interface for pack merging
8.
Easy-to-use commands with tab completion
9.
Permission-based access control
10.
Comprehensive configuration options
Installation Guide
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 plugin in
config.yml (or let it auto-configure)
7. Use
/resourcereload to apply changes
8. Load your resource pack with
/load <PackName>
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
- 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
Config File
Code (YAML):
# ResourceLoader Configuration
# For detailed documentation, visit: https://github.com/DefectiveVortex/Resourceloader
#====================#
# Resource Packs #
#====================#
# The default server resource pack that will be loaded when using /load without arguments
# Examples:
# Local file: "server-pack.zip"
# URL: "https://example.com/server-pack.zip"
server-pack
:
""
# Individual resource pack definitions
# Format:
# packname: "filename.zip" # For local files
# packname: "https://..." # For external URLs
resource-packs
:
# example1: "pack1.zip"
# example2: "https://example.com/pack2.zip"
# Storage configuration
storage
:
# Custom directory for resource packs (absolute path)
# Leave empty to use plugins/ResourceLoader/packs/
resource-pack-directory
:
""
# Automatic resource pack detection
auto-detection
: true
#====================#
# Server Settings #
#====================#
# Web server configuration for serving resource packs
server
:
# The port to serve resource packs on (default: 40021)
port
: 40021
# Network settings (advanced)
localhost
: false
# Set to true only for local testing
address
:
""
# Leave empty for auto-detection
fallback
: localhost
# Used if auto-detection fails
#====================#
# Performance #
#====================#
# Resource pack compression settings
compression
:
# Enable compression of resource packs
enabled
: true
# Compression level selection
auto-select
: true
# Choose compression based on player's connection
default-level
:
"medium"
# Used when auto-select is false
# Options: "low", "medium", "high"
# Cache settings for downloaded resource packs
cache:
enabled
: true
expiry-days
: 7
# How long to keep cached packs
auto-cleanup
: true
# Automatically remove expired cache entries
#====================#
# Pack Management #
#====================#
# Backup configuration
backup:
enabled
: true
interval-hours
: 24
# Hours between automatic backups
keep-count
: 5
# Number of backup files to retain
# Usage statistics and player preferences
statistics:
enabled
: true
# Track pack usage and performance
save-preferences
: true
# Remember player's last used packs
max-preferences
: 5
# Number of packs to remember per player
#====================#
# User Interface #
#====================#
# GUI settings for the pack merger
gui:
enabled
: true
show-preview
: true
# Show pack preview before merging
conflict-handling
:
"ask"
# How to handle conflicts: "ask", "overwrite", "skip"
#====================#
# Enforcement #
#====================#
# Resource pack enforcement settings
enforcement:
enabled
: false
kick-on-decline
: true
kick-on-fail
: true
restrict:
prevent-interaction
: true
# Whether to use vanilla Minecraft's resource pack system by modifying server.properties
# WARNING: This will override any existing resource pack settings in server.properties
use-server-properties
: false
# If true, will create a public URL for the pack that doesn't require authentication
# Only used when use-server-properties is true and a local file is used
make-pack-public
: false
Commands
/load [PackName] - Load the specific/default resource pack
/autoload [PackName] - Load the specific/default resource pack upon joining
/listpacks - List all the available packs on the server
/mergepack <output-file>.zip <pack1> <pack2> [pack3...] - Merge existing resource packs in the plugin itself
/mergegui <output-file>.zip - Open the graphical interface for merging packs
/resourcereload - Reload the plugin configuration
/autoload <PackName> - Automatically load the preferred resource pack on joining
/resourceversion - Check the current version of ResourceLoader you're running!
/removepack <PackName> - Remove a resource pack.
Support
- Support: Reach out via the discussion tab or contact @vortexunwanted on discord.
License
This plugin is licensed under MIT.