Перейти к содержимому
Mineforgian

AddHeads

Adds player heads to chat and tablist, exposes reusable head placeholders for PlaceholderAPI-based plugins | No RP and Mod neded. Offline mode support.

Загрузки
392
Подписчики
6
Обновлён
10 июня 2026 г.
Лицензия
Non-Commercial-Source-Available-License

Опубликован 26 марта 2026 г.

Исходный кодСообщить об ошибке

banner

AddHeads

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
    tablist example
  • 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
    chat example
  • 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% - true or false, whether the shared skin cache already has a confirmed skin.
  • %addhead_tab_visible% - true or false, whether tab head output is enabled for that player.

🎨 Skin Sources

AddHeads resolves skins in this order:

  1. SkinsRestorer
  2. live Paper player profile
  3. Paper profile update lookup
  4. Mojang profile/session lookup by player name
  5. cached value already resolved by AddHeads

💫 My Other Plugins:

Ченджлог

1.2.2Релиз26.1, 26.1.1, 26.1.2 · 10 июня 2026 г.
  • 26.1.x Support
1.2.0Релиз1.21.9, 1.21.10, 1.21.11 · 30 марта 2026 г.

1.2.0

  • Added automatic native TAB API integration. If TAB is installed and player-list heads are enabled, AddHeads now switches to the built-in TAB compatibility path automatically with no extra AddHeads-side toggle.
  • Fixed player-list head rendering with TAB when tablist-name-formatting is enabled, so heads now render correctly together with TAB prefixes, suffixes, colors, and other tab formatting options.
  • Preserved external tab formatting more reliably so AddHeads prepends the head without wiping colors, prefixes, or suffixes from supported player-list plugins.
  • Applied the same tab head settings to the TAB integration path, including correct skin loading from cache, tab head shadow handling, and configurable spacing after the head.
  • Synchronized TAB component settings with AddHeads tab settings by forcing the compatible parser mode and matching TAB head-shadow behavior to AddHeads' tab shadow option.
  • Kept viewer-based tab head rendering through ProtocolLib for the standard compatibility path, so /hd toggletab controls which heads the viewer sees instead of changing one global player-list name for everyone.
  • Reapplied tab heads after joins, cache refresh cycles, TAB player-load events, and TAB reload events so formatted names and heads recover correctly after refreshes.
  • Confirmed compatibility with CMI, QuickBoardX, and PowerBoard through the standard packet / scoreboard compatibility path, with no extra AddHeads-side integration toggle required.
  • Included a broad set of tab compatibility fixes and stability improvements across the built-in player-list path and the native TAB path.
1.1.0Релиз1.21.9, 1.21.10, 1.21.11 · 28 марта 2026 г.

1.1.0

  • Added a public AddHeads API with service registration through Bukkit ServicesManager.
  • Added reusable API models for render targets, render options, output formats, and skin textures.
  • Added API events for plugin reloads and resolved skin updates.
  • Added richer export formats for both the public API and PlaceholderAPI.
  • Added format-aware placeholders such as format_*, chat_*, and tab_*.
  • Reworked spacing after heads into configurable spacing counts instead of simple on/off toggles.
  • Added separate spacing and shadow defaults for chat heads and player-list heads.
  • Unified the cache refresh cycle so one configurable interval now drives skin cache refresh and player-list head reapplication.
  • Added a confirmation flow for update downloads, with chat confirmation before queueing the file into plugins/update.
  • Moved GitHub and Modrinth release sources into the plugin itself and left only the update-check enable/interval settings in config.
  • Reworked premium detection to support auto, auto_permission, and permission modes without plugin-specific premium hooks.
  • Preserved premium player preferences across joins and only apply premium defaults when a player transitions into premium state.
  • Updated documentation to describe AddHeads as a universal head provider for chat, player lists, placeholders, and third-party integrations.
1.0.2Релиз1.21.9, 1.21.10, 1.21.11 · 27 марта 2026 г.

1.0.2

  • Reworked tab head insertion so AddHeads now prepends the head directly to the in-game player list name.
  • The default tab path no longer requires additional TAB configuration or placeholder setup.
  • Tab head insertion is now universal and works with vanilla player lists as well as tab-related plugins that rewrite the list name later.
  • Added a dedicated tab.enabled switch and tab.refresh-interval-seconds setting for the automatic player-list head path.
  • Fixed duplicate tab heads during plugin reload by restoring the raw player-list name before reapplying the head.
  • Updated tab visibility handling so the player-side toggle now removes or restores the actual tab head, not only placeholder output.
  • Added additional skin resolution fallbacks so tab heads can still resolve more reliably when the primary source does not return a texture.
  • Updated README, config notes, and release metadata to match the new placeholder-free default tab flow.
1.0.1Релиз1.21.9, 1.21.10, 1.21.11 · 27 марта 2026 г.

1.0.1

  • Added automatic update checks for GitHub and Modrinth releases.
  • Added clickable admin notifications for new releases.
  • Added config and language backfill improvements.
  • Fixed chat hover inheritance so links and other hover events are preserved.
  • Improved the settings GUI layout and inactive premium state handling.
  • Added per-command sound feedback for successful actions.
  • Added toggle permissions for chat and tab head visibility.
  • Updated the plugin version to 1.0.1.
1.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 26 марта 2026 г.

v1.0.0 - Initial Release

  • First public release of AddHeads.
  • Added player head rendering in chat while preserving formatting from other chat plugins.
  • Added PlaceholderAPI support for reusable head placeholders.
  • Added SkinsRestorer support for resolving correct player skins.
  • Added shared skin cache with automatic refresh.
  • Added personal toggle commands for chat heads and tab head placeholders.
  • Added localized /hd settings GUI for admins.
  • Added live language switching with bundled translations.
  • Added automatic backfill for missing config and language keys on reload.
  • Added premium detection modes and premium-specific defaults.
  • Added TAB compatibility warnings and admin fix action for MiniMessage mode.
  • Added plugin info command and cleaner tab-complete suggestions.

Комментарии

Загружаем…