❓ What is ChatHeadFont?
ChatHeadFont is a lightweight plugin + resource pack that generates an 8×8 version of a player's head and displays it directly in:

• Chat
• Join/leave messages
• Actionbar
• Bossbar
• Any PlaceholderAPI-supported format

It uses a custom font to generate a clean, tiny pixel head that matches the player’s actual skin.


✨ Features

• Dynamic 8×8 player head icons
• Multiple skin sources (Mojang, Crafatar, Minotar, MCHeads)
• PlaceholderAPI support (PAPI) — see below
• Smart caching for performance
• Works in chat, actionbar, bossbar, join/leave/death messages
• Plug-and-play resource pack (auto-download optional)
• Developer API for custom integrations

PlaceholderAPI (PAPI) Support
ChatHeadFont includes full **PlaceholderAPI** integration.

Available placeholders:

• %chathead% - the player's own head
• %chathead_self% - same as above
• %chathead_other:<player>% - show any other player’s head

These can be used in:

• Chat formats
• Scoreboards
• GUIs/menus
• Holograms
• Any PAPI-compatible plugin

Installation

1. Download the plugin & resource pack from the Releases
2. Place the JAR in `/plugins`
3. Restart the server
4. (Optional) Let the plugin auto-send the resource pack

Full instructions are available on GitHub.

⚙️ Configuration
All configuration settings are documented on GitHub:
https://github.com/OGminso/ChatHeadFont

Includes:

• Skin sources
• Overlay toggle
• Cache length
• Join/leave/chat toggles
• Auto-download resource pack option
• Update checker toggle

Developer API
Simple API for developers who want to use the head icons inside their own plugins.

Maven/Gradle + usage examples:
Developer API Documentation


Screenshots