Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
MythicHUD MythicHUD
  • Project overview
    • Project overview
    • Details
    • Activity
  • Issues 4
    • Issues 4
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
  • Wiki
    • Wiki
  • Members
    • Members
  • Activity
  • Create a new issue
  • Issue Boards
Collapse sidebar
  • MythicCraft
  • MythicHUDMythicHUD
  • Wiki
  • Supporting Multiple Versions

Last edited by wordandahalf Jan 30, 2025
Page history

Supporting Multiple Versions

Disclaimer

If you are using an external plugin to manage your pack and your client fails to load the final pack after merging MythicHUD's assets, there is an incompatibility on the part of the other plugin. MythicHUD will always generate a resource pack loadable by clients within the configured version range. Deleting files, especially anything in the shaders/ folder will never result in a properly functioning resource pack. Do not do this.

Instead, check the compatibility page and see if any instructions already exist to solve your issues. If not, come request support and report the plugin name and version you with which you are encountering incompatibilities.

Supporting Multiple Versions

This is a brief primer on how MythicHUD supports many client versions with a single resource pack.

MythicHUD supports multiple client version via a flexible pack build system based upon Creative. When necessary, the plugin generates additional folders in the resource pack. These folders are called overlays and are critical for the pack to function properly on configured versions.

An overlay consists of two parts: configuration in the pack's mcmeta and the aforementioned folder. An overlay is a "pack in a pack" and overrides or provides additional assets on a version-by-version basis.

Take for example the following pack structure:

MythicHUD
    └── built-pack
        ├── assets
        ├── mythichud-example-overlay
        │   └── assets
        ├── pack.mcmeta
        └── pack.png

And in pack.mcmeta,

"overlays": {
  "entries": [{
    "formats": {
      "min_inclusive": 32,
      "max_inclusive": 34
    },
    "directory": "mythichud-example-overlay"
  }]
}

This configures the mythichud-example overlay applied for client versions 1.20.5 to 1.21.1. See the MCW page for a table of pack versions. As explained, overlays are simply resource packs inside of resource packs, so the mythichud-example folder contains an assets subfolder just as a typical resource pack would. The only exception to this is the lack of pack.mcmeta inside.

The plugin will automatically generate overlays necessary to support the configured target client version range. If you are using another plugin to manage your server's assets, it is imperative that it properly supports resource pack overlays. If it does not, then configure the plugin to generate a resource pack which targets a single client version. Otherwise, you may need to manually merge your resource pack by hand.

Clone repository
Home

Getting Started
What's New in MythicHUD?
Commands and Permissions
Configuration Reference

Layouts
Pop-Ups
HUD Components
  • Asset Layers
  • Assets
  • Listeners
  • Conditions
    • Effect
    • Gamemode
    • Placeholder
    • Progress
    • Logical Operators
Fonts

MythicHUD API
  • Dependency Information
  • Events
  • HudHolder
Compatibility
  • Migrating from v1 to v2
  • Supporting Multiple Client Versions
  • Crucible
  • Nexo
  • ItemsAdder
  • Modded Clients