Vanilla UI Profiles
Vanilla UI Profiles replace real Minecraft client UI textures through the GUIFX resource pack. They are separate from the overlay system.
Why a version profile is required
Minecraft clients do not keep every native GUI asset contract stable. A target can appear later, move path, change its physical PNG size, or gain nine-slice/animation metadata.
client-ui.version-profile tells GUIFX which verified native asset map to use when it builds the pack. It does not affect Overlay Engine artwork.
client-ui:
enabled: true
active-profile: "ocean_hud"
version-profile: "minecraft_1_21_6"
Verified profile groups
| Minecraft client | GUIFX profile |
|---|---|
| 1.21–1.21.1 | minecraft_1_21 |
| 1.21.2 | minecraft_1_21_2 |
| 1.21.3 | minecraft_1_21_3 |
| 1.21.4–1.21.5 | minecraft_1_21_4 |
| 1.21.6–1.21.10 | minecraft_1_21_6 |
| 1.21.11 | minecraft_1_21_11 |
A generated Client UI pack should target the Minecraft version the players will actually run. A 1.21.11 profile is not a safe substitute for a 1.21.1 client just because the server itself accepts both versions.
Use the Client UI Target Atlas to inspect every target in the selected profile.