Troubleshooting

Common ClothesPlus setup and runtime issues.

Plugin does not start: class file version error

Example:

UnsupportedClassVersionError: class file version 67.0, runtime recognizes up to 65.0

Class file version 67.0 means that jar was compiled with Java 23. Current ClothesPlus builds target Java 21, so rebuild/use the Java 21-targeted jar and run Paper with Java 21.

Resource pack is purple/black

Check:

• resourcepack.enabled: true
• standalone users have resourcepack.public-url set to a URL clients can reach
• provider users are letting ItemsAdder/Nexo/Oraxen/CraftEngine send the combined pack
• supported-formats-min and supported-formats-max cover the player's Minecraft version
• run /clothes pack apply

For provider mode, do not enable native pack sending unless ClothesPlus is the only pack sender.

ItemsAdder/Nexo/Oraxen/CraftEngine pack does not update

Run:

/clothes pack reload

If bundled files must be restored:

/clothes pack restore-bundled

Then rebuild or resend the provider pack from the pack manager.

Pack generation logs too much every restart

Current builds use fingerprints and content checks. Unchanged pack outputs should be reported as up to date and unchanged files should be skipped.

If it still rewrites everything:

• check that pack-types is not being deleted by the host
• check that resourcepack-edit is not modified on every boot
• check that a provider plugin is not clearing its generated folders

MineSkin failures equip nothing

If MineSkin generation fails, the final skin application should fail instead of silently equipping a clothing state that cannot be rendered. Check console for [MineSkin] errors and verify your API key.

Use:

/clothes apikey <mineskin-api-key>

Wardrobe blocks with body type or palette message

This only applies when:

base_skin: false

Run:

/clothes select alex_male
/clothes palette

Use steve_male or female instead if appropriate.

Cursor creator overlay changes do not appear

After editing overlay folders:

/clothes cursor generate
/clothes cursor reload

If resource-pack assets changed:

/clothes pack apply

Cursor buttons feel offset

Tune the relevant click-radius-x, click-radius-y, position, and background width/height values in:

uis/creator/cursor_ui_layout.yml
uis/previewer/previewer.yml

The editor can stage and save many UI placement values:

/clothes cursor editor [section]
/clothes cursor editor save

DynamicUV avatar is misaligned

Check the .bbmodel bone names:

head, chest, waist, hip,
left_arm, left_forearm, right_arm, right_forearm,
left_leg, left_foreleg, right_leg, right_foreleg

If a slim arm looks like a Steve arm, check the model geometry and UVs for that side. The left and right arm/forearm parts must use the correct 3 px or 4 px width for the selected player model.

Animation stutters on texture changes

Keep the idle animation name stable and avoid restarting the preview session. ClothesPlus avoids restarting the same running animation when only the avatar texture changes.

License validation fails after adding a key

Put the key in:

plugins/ClothesPlus/licensing/clothesplus-license.key

Then restart once. The legacy root clothesplus-license.key is accepted and copied into licensing/ on startup.

After a valid check, ClothesPlus caches the validation and only rechecks the server after 5 to 6 days.