# AlamHeadsAPI
AlamHeadsAPI is a lightweight and high-performance REST API plugin for Paper/Spigot servers.
It allows websites, applications, and external services to retrieve Minecraft player avatars through a simple HTTP API with automatic skin caching.
## Features
✔ REST Avatar API
✔ Automatic JSON Cache
✔ SkinsRestorer Support
✔ High Performance
✔ CORS Support
✔ Configurable
✔ Reload Command
✔ Status Command
✔ Export Command
✔ Java 21
## Commands
/alamheads reload
/alamheads status
/alamheads export
/alamheads version
## Permission
alamheads.admin
## API Endpoint
GET /avatar/<player>
Example:
http://YOUR_SERVER_IP:8080/avatar/Steve
## Requirements
- Paper / Spigot 1.21+
- Java 21
- SkinsRestorer
## Source Code
https://github.com/acrft/AlamHeadsAPI
AlamHeadsAPI is a lightweight and high-performance REST API plugin for Paper/Spigot servers.
It allows websites, applications, and external services to retrieve Minecraft player avatars through a simple HTTP API with automatic skin caching.
## Features
✔ REST Avatar API
✔ Automatic JSON Cache
✔ SkinsRestorer Support
✔ High Performance
✔ CORS Support
✔ Configurable
✔ Reload Command
✔ Status Command
✔ Export Command
✔ Java 21
## Commands
/alamheads reload
/alamheads status
/alamheads export
/alamheads version
## Permission
alamheads.admin
## API Endpoint
GET /avatar/<player>
Example:
http://YOUR_SERVER_IP:8080/avatar/Steve
## Requirements
- Paper / Spigot 1.21+
- Java 21
- SkinsRestorer
## Source Code
https://github.com/acrft/AlamHeadsAPI
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.17, 1.18, 1.19
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
AlamHeadsAPI is a free Minecraft Java mod. Compatible with Minecraft 1.17, 1.18, 1.19, 1.20 and newer. Downloaded 8 times (via Spigot). Download it and open it directly in the game.