This library provides a seamless integration between Minecraft-Heads.com and the Minestom server framework. It allows server developers to easily fetch and use custom player heads from the Minecraft-Heads.com database within their Minestom-powered Minecraft servers.

• Simple API for retrieving custom heads from Minecraft-Heads.com
• Caching system to reduce API requests (in compliance with Minecraft-Heads.com terms of use)
• Support for categories, tags, and search functionality
• Easy application of custom heads to Minestom entities and inventory items
• Lightweight implementation optimized for Minestom's performance-focused architecture

<dependency>
    <groupId>org.everbuild.minecraftheads</groupId>
    <artifactId>minecraft-heads-minestom</artifactId>
    <version>1.1.0+1.21.9</version>
</dependency>

implementation("org.everbuild.minecraftheads:minecraft-heads-minestom:1.1.0+1.21.9")

implementation 'org.everbuild.minecraftheads:minecraft-heads-minestom:1.1.0+1.21.9'

Note: In accordance to the API ToS of minecraft-heads.com, a back-linking banner needs to be placed on a website associated with the used feature, such as this one:

This project is licensed under the MIT License, see the LICENSE file for details.

Contributions are welcome! Please feel free to submit a Pull Request.

• Minecraft-Heads.com for providing the head database
• Minestom for the lightweight Minecraft server framework