Skip to content
Marcel edited this page Jul 9, 2025 · 4 revisions

Frequently Asked Questions

Will there be a version available for Forge/Fabric/Quilt/...?

No, there are no plans for supporting any mod loaders, and never will be. There are plenty of other projects in this area to choose from which already achieve this.

Does Optifine work with this plugin?

Optifine is known to cause issues.

Can I restrict players to using certain cosmetics?

Yes, you can find more information on the permissions wiki page.

I have a problem not listed here. Can you help me?

Yes, see the support section.


Common issues

The Plugin Won't Load

If you are on version 2.x.x of the plugin, ensure you have NBT API plugin installed.

Note

If you are getting any errors, fatal messages or stack trace related to the plugin, head to the support section.

Quick Swapping

In some older versions, quick swapping a helmet on while wearing a hat makes it so you can hold the hat item. This item can then be placed in item frames. However, upon clicking the item to equip or move it, it should disappear.

Double Hats

On some versions, when equipping a hat, you might end up with a phantom duplicate of that hat in your inventory. This phantom item disappears once you access a crafting table, or try to click it.

Creative Mode

On creative mode the hat items can be moved freely, but not placed again in the helmet slot. Once the game mode is changed to survival, they disappear once clicked.

Players Can't See the Custom Hats

Having the server resource pack enabled is necessary for hats to be properly displayed. Optifine is also known to be problematic.

Hat missing texture

This is likely a problem with the model .json not referencing the texture correctly. If you're playing on 1.19.3+, this could also be caused by a lack of a texture atlas, or a poorly configured blocks.json file.

Only the First Hat Shows up

Due to the file format, options.yml is quite finicky. You're probably missing some indents before the second hat ID, therefore the parser considers all that data part of the first hat.

Tip

You can use online formatters/validators to help organising this file.