WeHeads

A Minecraft plugin for Spigot/Paper/Folia (1.20+) that allows players to get custom heads using Base64 textures.

Features

• Simple Base64 Support: Direct Base64 texture injection into SkullMeta
• Easy to Use: Single command with Base64 texture input
• Inventory Management: Automatic overflow protection
• Permission System: Built-in permission controls

Commands

/wehead give <base64_texture>

Give yourself a custom head using a Base64 texture string from minecraft-heads.com.

Example:

/wehead give eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUv...

Permissions

Permission	Description	Default
wehead.give	Allows using /wehead give command	op

Installation

1. Download the plugin JAR file
2. Place it in your server's plugins/ folder
3. Restart your server
4. Plugin is ready to use!

Requirements

• Minecraft Version: 1.20+
• Server Software: Spigot, Paper, or Folia
• Java Version: 21+

Building from Source

git clone https://github.com/wethink/we-heads.git
cd we-heads
mvn clean package

The compiled JAR will be in the target/ directory.

Getting Base64 Textures

1. Visit minecraft-heads.com
2. Find the head you want
3. Copy the Base64 texture value
4. Use it with /wehead give <base64_texture>

Error Handling

• Invalid Command: Shows usage message
• No Permission: Permission denied message
• Invalid Texture: Error message with texture validation
• Full Inventory: Drops head on ground if inventory is full

Support

For issues, feature requests, or contributions, please visit our GitHub repository.

License

This project is licensed under the MIT License.