Official documentation
Head
A free Paper and Folia wardrobe GUI for wearable custom-texture player heads with permission-based access.
Getting started
Installation
- 1
Stop the Minecraft server completely.
- 2
Install every required dependency listed below before HeadWardrobe.
- 3
Place HeadWardrobe.jar inside the plugins folder.
- 4
Start the Minecraft server and review the generated HeadWardrobe configuration folder.
- 5
Test the plugin on a staging server before enabling it for all players.
Supported environments
Compatibility
1.1.0Plugin version
1.21.xMinecraft
Paper / FoliaServer software
Java 21 or newerRuntime
Integrations
Dependencies
No external dependencies are required.
Reference
Commands
Commands
| Command | Description | Permission |
|---|---|---|
/teste | Opens the cosmetic head wardrobe. | headwardrobe.use |
/teste reload | Reloads the configuration. | headwardrobe.admin |
Access control
Permissions
| Permission | Default | Description |
|---|---|---|
headwardrobe.use | Everyone | Allows opening the wardrobe. |
headwardrobe.admin | Administrators | Allows configuration reloads. |
headwardrobe.head.* | Administrators | Allows using every permission-protected head. |
Server setup
Configuration notes
- Add heads under the heads section using a texture value or direct textures.minecraft.net URL.
- Each entry supports a name, lore, enabled flag and optional permission.
Important notes
- Command aliases are /testa, /heads and /headmenu.
- Folia 26.x server builds require the Java version required by that server build.
Visual guide
Images