AddHeads

!(https://cdn.modrinth.com/data/cached_images/808ec55d2a814a2658c0a59bdf0af35c30ad8504.png)

AddHeads is a lightweight Paper/Purpur plugin for servers that adds player heads in chat and in the in-game tab list. It also provides reusable head placeholders for custom integrations. NO RP AND MOD NEEDED

## 🚀 Just Download and it works!

> No additional plugin settings for chat and tab - the plugin works on top of them. > Everything works on a vanilla client, does not require any resource pack or mods.

## 🌍 Languages

Bundled languages:

> en-us | es-es | de-de | fr-fr | pt-br | zh-cn | ru-ru

## ✨ What it does

• automatically prepends the player's head to the in-game player list name
• !(https://cdn.modrinth.com/data/cached_images/fb544afeea7b85c1b97b698714d8b5b6eacad820.jpeg)
• keeps working with vanilla player lists and with tab-related plugins without manual placeholder insertion even in offline mod
• adds the player's head before the chat message
• !(https://cdn.modrinth.com/data/cached_images/7f38d6bd830d19776496892d09358b159237cae4.jpeg)
• preserves existing chat formatting from other plugins
• supports shared skin resolution with SkinsRestorer when available
• keeps a single reusable skin cache for chat and placeholders
• includes a localized `/hd settings` GUI for admins

## ⚙️ Features

• Vanilla chat head rendering
• automatic player-list head insertion without extra setup
• public Bukkit service API for other plugins
• PlaceholderAPI support with multiple export formats
• SkinsRestorer-aware skin lookup
• automatic skin and cache refresh
• personal chat and player-list visibility toggles
• localized settings GUI
• live config and language reload
• automatic config and language key backfill on reload
• configurable spacing between the head and the text in both chat and the player list
• separate shadow settings for chat heads and player-list heads
• update checks from GitHub and Modrinth

## 💬 SUPPORTS ANY CHAT PLUGIN

## 🧩 Supported Player List Plugins

AddHeads supports these player-list plugins directly:

• `TAB`
• > Native support is implemented through the `TAB` API, so heads are added correctly even when `TAB` formats prefixes, suffixes, colors, and tab list names.

• `CMI / PowerBoard / PowerBoard / Any other`
• > Supported through the standard compatibility path.

AddHeads also works with other player-list plugins that do not block external tab list modifications.

If a plugin allows the final tab list name to be modified externally, AddHeads can usually prepend the head through its normal compatibility path. For `TAB`, native API integration is used instead, so heads are rendered correctly even with `TAB` formatting features enabled.

## 📋 Requirements

• Paper or Purpur `1. 21. 9+`
• Java `21`

## 🔌 Optional dependencies

• PlaceholderAPI
• SkinsRestorer

## 🛠 Commands

| Command | Description | Permission | | --- | --- | --- | | `/hd togglechat` | Toggles chat heads for the executing player. | `addhead.togglechat` | | `/hd toggletab` | Toggles tab heads for the executing player. | `addhead.toggletab` | | `/hd settings` | Opens the localized config GUI. | `addhead.settings` | | `/hd info` | Shows plugin name, version, and author. | None | | `/hd reload` | Reloads config, language files, and skin cache. | `addhead.reload` |

## 🔐 Permissions

• `addhead.togglechat` - Allows toggling your own chat heads.
• `addhead.toggletab` - Allows toggling your own tab heads.
• `addhead.settings` - Allows opening the settings GUI.
• `addhead.reload` - Allows reloading the plugin and using repair actions.
• `addhead.premium` - Used only when `premium.mode=permission`.

## 📦 Installation

1. Download `AddHeads-{version}.jar`. 2. Place it in your server `plugins/` folder. 3. Start or restart the server. 4. Edit `config.yml` and `languages/*.yml` or use `/hd settings` if needed. 5. Use `/hd reload` after making changes.

## 📝 Notes

• AddHeads does not force one specific chat formatter.
• It decorates the final chat component after other chat plugins finish formatting it.
• The default tab path does not require any placeholder setup.
• The tab head is inserted automatically through the in-game player list name.
• This works with vanilla player lists and is designed to keep working even if another tab-related plugin rewrites the list name later.
• PlaceholderAPI placeholders are still available for custom layouts, prefixes, scoreboards, and similar UI.
• New language keys and config keys are backfilled automatically from the bundled defaults on reload.

## 🧠 Placeholders

• `%addhead_head%` - JSON component head for chat and component-aware plugins.
• `%addhead_tab%` - Optional tab head placeholder for custom PlaceholderAPI-based layouts.
• `%addhead_texture_value%` - Raw texture value.
• `%addhead_texture_signature%` - Raw texture signature.
• `%addhead_texture_hash%` - `textures.minecraft.net` hash.
• `%addhead_skin_ready%` - `tr