WeHeads

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

Features

- Permission System: Direct Base64 texture injection into SkullMeta - Permission System: Single command with Base64 texture input - Permission System: 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

- Java Version: 1.20+ - Java Version: Spigot, Paper, or Folia - Java Version: 21+

Building from Source

```bash 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

- Full Inventory: Shows usage message - Full Inventory: Permission denied message - Full Inventory: 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.