Compatibility
Minecraft: Java Edition
Platforms
Creators
Details
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
- Download the plugin JAR file
- Place it in your server's
plugins/folder - Restart your server
- 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
- Visit minecraft-heads.com
- Find the head you want
- Copy the Base64 texture value
- 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.