Skip to main content

​
ResourcePack Configuration

This guide explains how to configure QualityArmory to send the correct resource pack to your players.
  • useDefaultResourcepack: true: Keep this true when using the auto-detection system. It tells the plugin to use the URLs defined under the DefaultResourcepack: section below.
  • DefaultResourcepack:: This section defines the different resource pack URLs for various Minecraft versions.
    • You must have an entry with the key "0". This is the fallback URL used if no specific version matches or if the player’s version cannot be detected.
    • Add entries for specific Minecraft versions using the format "minor" or "minor-patch". The plugin will select the highest version entry that is less than or equal to the player’s version.
    • Keys should be strings (use quotes).
    • This system requires ViaVersion installed to work.
Example DefaultResourcepack Section: 
# ... other config settings ...

useDefaultResourcepack: true

DefaultResourcepack:
  # Fallback/Default URL (REQUIRED)
  '0': 'https://your-default-pack-url.zip'
  # Pack for 1.19.0 up to (but not including) 1.20.0
  '19': 'https://your-1.19.x-pack-url.zip'
  # Pack specifically for 1.20.0 up to (but not including) 1.20.2
  '20': 'https://your-1.20.0-pack-url.zip'
  # Pack for 1.20.2 up to (but not including) 1.21.0
  '20-2': 'https://your-1.20.2-pack-url.zip'
  # Pack for 1.21.0 and newer (until a higher version is added)
  '21': 'https://your-1.21.x-pack-url.zip'

# ... other config settings ...
How it works with the example:
  • Player joins with 1.18.2 -> Gets the '0' pack.
  • Player joins with 1.19.4 -> Gets the '19' pack.
  • Player joins with 1.20.1 -> Gets the '20' pack.
  • Player joins with 1.20.4 -> Gets the '20-2' pack.
  • Player joins with 1.21.0 -> Gets the '21' pack.
  • If you don’t want auto-detection or don’t have ViaVersion, you can force the plugin to use one specific set of models/systems.
  • Set Auto-Detect-Resourcepack: false.
  • Set one of the following to true:
    • ManuallyOverrideTo_1_8_systems: true (For 1.8 style models/mechanics)
    • ManuallyOverrideTo_1_13_systems: true (For 1.9-1.13 style models/mechanics)
    • ManuallyOverrideTo_1_14_systems: true (For 1.14+ style models/mechanics)
  • In this case, the plugin will use the fallback '0' URL from DefaultResourcepack. This setup is less flexible and generally only used for troubleshooting or specific server setups.

​
Using a Single Custom URL (Simple)

  • If you only have one resource pack URL you want everyone to use, regardless of version:
  • Set useDefaultResourcepack: false.
  • Set DefaultResourcepackOverride: true.
  • Define your single URL under DefaultResourcepack: :
# ... other config settings ...

useDefaultResourcepack: false
DefaultResourcepackOverride: true

DefaultResourcepack: 'https://your-single-custom-pack-url.zip'

# ... other config settings ...