SamsHead documentation
Welcome to the SamsHead documentation!
Plugins
SamsHead | Custom Head Display System
Make player heads look clean, modern, and unique!
SamsHead provides pixel-perfect player head rendering via text, components, and resource pack fonts. It allows you to display high-quality player avatars in chat, holograms, and menus without the performance overhead of traditional player heads or entities.
Lightweight & Fast
SamsHead uses a custom TTF font to render 8×8 pixel grids using standard text characters, making it significantly faster than using player head items or entities. All skin fetching is handled asynchronously to ensure zero impact on server ticks.
Compatibility
- Java: 21+
- Server Version: 1.21+
- Supported Software: Spigot, Paper, Purpur
Key Features
Pixel-perfect avatars
Face-only or full head (with the hat overlay), in five sizes from small to giant
Smart skin caching
They are cached by UUID (so a name change never leave duplicate) and persisted between restarts.
Nested placeholders
Feed another placeholder's output (a leaderboard name, for example) straight into an avatar!
Render types
Greyscale, sepia, invert, colour tint and an optional coloured border, on any avatar or bust!
Navigation
Support me!
If you enjoy using SamsHead, feel free to Buy me a coffee! Thank you! 🧡