<\/p>\n
# AddHeads<\/p>\n
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**<\/p>\n
## \ud83d\ude80 Just Download and it works!<\/p>\n
> No additional plugin settings for chat and tab – the plugin works on top of them.
\n> Everything works on a vanilla client, does not require any resource pack or mods.<\/p>\n
## \ud83c\udf0d Languages<\/p>\n
Bundled languages:<\/p>\n
> en-us | es-es | de-de | fr-fr | pt-br | zh-cn | ru-ru<\/p>\n
## \u2728 What it does<\/p>\n
– automatically prepends the player’s head to the in-game player list name
\n 
\n– keeps working with vanilla player lists and with tab-related plugins without manual placeholder insertion **even in offline mod**
\n– adds the player’s head before the chat message
\n 
\n– preserves existing chat formatting from other plugins
\n– supports shared skin resolution with SkinsRestorer when available
\n– keeps a single reusable skin cache for chat and placeholders
\n– includes a localized `\/hd settings` GUI for admins<\/p>\n
## \u2699\ufe0f Features<\/p>\n
– Vanilla chat head rendering
\n– automatic player-list head insertion without extra setup
\n– public Bukkit service API for other plugins
\n– PlaceholderAPI support with multiple export formats
\n– SkinsRestorer-aware skin lookup
\n– automatic skin and cache refresh
\n– personal chat and player-list visibility toggles
\n– localized settings GUI
\n– live config and language reload
\n– automatic config and language key backfill on reload
\n– configurable spacing between the head and the text in both chat and the player list
\n– separate shadow settings for chat heads and player-list heads
\n– update checks from GitHub and Modrinth<\/p>\n
## \ud83d\udcac SUPPORTS ANY CHAT PLUGIN<\/p>\n
## \ud83e\udde9 Supported Player List Plugins<\/p>\n
AddHeads supports these player-list plugins directly:<\/p>\n
– `TAB`
\n > Native support is implemented through the `TAB` API, so heads are added correctly even when `TAB` formats prefixes, suffixes, colors, and tab list names.<\/p>\n
– `CMI \/ PowerBoard \/ PowerBoard \/ Any other`
\n > Supported through the standard compatibility path.<\/p>\n
AddHeads also works with other player-list plugins that do not block external tab list modifications.<\/p>\n
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.<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– Paper or Purpur `1.21.9+`
\n– Java `21`<\/p>\n
## \ud83d\udd0c Optional dependencies<\/p>\n
– PlaceholderAPI
\n– SkinsRestorer<\/p>\n
## \ud83d\udee0 Commands<\/p>\n
| Command | Description | Permission |
\n| — | — | — |
\n| `\/hd togglechat` | Toggles chat heads for the executing player. | `addhead.togglechat` |
\n| `\/hd toggletab` | Toggles tab heads for the executing player. | `addhead.toggletab` |
\n| `\/hd settings` | Opens the localized config GUI. | `addhead.settings` |
\n| `\/hd info` | Shows plugin name, version, and author. | None |
\n| `\/hd reload` | Reloads config, language files, and skin cache. | `addhead.reload` |<\/p>\n
## \ud83d\udd10 Permissions<\/p>\n
– `addhead.togglechat` – Allows toggling your own chat heads.
\n– `addhead.toggletab` – Allows toggling your own tab heads.
\n– `addhead.settings` – Allows opening the settings GUI.
\n– `addhead.reload` – Allows reloading the plugin and using repair actions.
\n– `addhead.premium` – Used only when `premium.mode=permission`.<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download `AddHeads-{version}.jar`.
\n2. Place it in your server `plugins\/` folder.
\n3. Start or restart the server.
\n4. Edit `config.yml` and `languages\/*.yml` or use `\/hd settings` if needed.
\n5. Use `\/hd reload` after making changes.<\/p>\n
## \ud83d\udcdd Notes<\/p>\n
– AddHeads does not force one specific chat formatter.
\n– It decorates the final chat component after other chat plugins finish formatting it.
\n– The default tab path does not require any placeholder setup.
\n– The tab head is inserted automatically through the in-game player list name.
\n– This works with vanilla player lists and is designed to keep working even if another tab-related plugin rewrites the list name later.
\n– PlaceholderAPI placeholders are still available for custom layouts, prefixes, scoreboards, and similar UI.
\n– New language keys and config keys are backfilled automatically from the bundled defaults on reload.<\/p>\n
## \ud83e\udde0 Placeholders<\/p>\n
– `%addhead_head%` – JSON component head for chat and component-aware plugins.
\n– `%addhead_tab%` – Optional tab head placeholder for custom PlaceholderAPI-based layouts.
\n– `%addhead_texture_value%` – Raw texture value.
\n– `%addhead_texture_signature%` – Raw texture signature.
\n– `%addhead_texture_hash%` – `textures.minecraft.net` hash.
\n– `%addhead_skin_ready%` – `true` or `false`, whether the shared skin cache already has a confirmed skin.
\n– `%addhead_tab_visible%` – `true` or `false`, whether tab head output is enabled for that player.<\/p>\n
## \ud83c\udfa8 Skin Sources<\/p>\n
AddHeads resolves skins in this order:<\/p>\n
1. SkinsRestorer
\n2. live Paper player profile
\n3. Paper profile update lookup
\n4. Mojang profile\/session lookup by player name
\n5. cached value already resolved by AddHeads<\/p>\n
## \ud83d\udcab My Other Plugins:<\/p>\n
– PremiumBridge – auto-authenticate premium players (Supports AddHeads)
\n– PointCoordinates – save important places, keep coordinates organized<\/p>\n","protected":false},"excerpt":{"rendered":"
Adds player heads to chat and tablist, exposes reusable head placeholders for PlaceholderAPI-based plugins | No RP and Mod neded. Offline mode support.<\/p>\n","protected":false},"featured_media":5927,"template":"","meta":{"_minecraft_slug":"addheads","_minecraft_project_id":"SCilJQz4","_minecraft_author":"goshkow","_minecraft_license":"LicenseRef-Non-Commercial-Source-Available-License","_minecraft_downloads":91,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"addheads.zip","_minecraft_size_bytes":420371,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T19:53:13.696417Z","_minecraft_date_created":"2026-03-26T20:34:37.738059Z","_minecraft_date_modified":"2026-03-30T15:25:16.709584Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/addheads","_minecraft_icon_attachment_id":5927,"_minecraft_imported_at":"2026-05-31T14:00:35+00:00","_minecraft_import_hash":"9d234636c1d650bf8d8ff448183be67b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,873,127,128,867,129,92],"mod_loader":[132,133,134],"minecraft_version":[40,41,82],"class_list":["post-5926","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-library","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-9"],"yoast_head":"\n