
AddHeads
AddHeads 是一款轻量级的 Paper/Purpur 插件,适用于希望在聊天和游戏内标签页列表中添加玩家头像的服务器。它还提供了可复用的头像占位符,以便进行自定义集成。无需 RP(资源包)或模组
? 只需下载即可使用!
无需为聊天和标签页设置额外的插件配置——该插件在这些功能之上运行。
一切均可在原版客户端上正常工作,不需要任何资源包或模组。
? 语言支持
内置语言:
en-us | es-es | de-de | fr-fr | pt-br | zh-cn | ru-ru
✨ 功能特性
- 自动在游戏内玩家列表名称前添加玩家头像

- 即使在离线模式下,也能与原版玩家列表及标签页相关插件配合工作,无需手动插入占位符
- 在聊天消息前添加玩家头像

- 保留来自其他插件的现有聊天格式
- 在可用时支持与 SkinsRestorer 共享皮肤解析
- 为聊天和占位符提供单一的可复用皮肤缓存
- 包含面向管理员的本地化
/hd settingsGUI
⚙️ 功能列表
- 原版聊天头像渲染
- 无需额外设置即可自动插入玩家列表头像
- 公开 Bukkit 服务 API 供其他插件调用
- 支持 PlaceholderAPI,并提供多种导出格式
- 兼容 SkinsRestorer 的皮肤查找
- 自动刷新皮肤和缓存
- 独立的聊天和玩家列表可见性开关
- 本地化设置 GUI
- 实时重载配置和语言文件
- 重载时自动回填缺失的配置和语言键值
- 可配置聊天和玩家列表中头像与文本之间的间距
- 聊天头像和玩家列表头像拥有独立的阴影设置
- 从 GitHub 和 Modrinth 检查更新
? 支持任意聊天插件
? 支持的标签页列表插件
AddHeads 直接支持以下标签页列表插件:
-
TAB通过
TABAPI 实现原生支持,因此即使TAB格式化前缀、后缀、颜色和标签页名称,头像也能正确显示。 -
CMI / PowerBoard / PowerBoard / 或其他通过标准兼容性路径提供支持。
AddHeads 也可用于其他不阻止外部标签页列表修改的插件。
如果某插件允许外部修改最终的标签页列表名称,AddHeads 通常可以通过其正常兼容性路径在前添加头像。对于 TAB,则使用原生 API 集成,从而确保在启用 TAB 格式化功能时头像仍能正确渲染。
? 依赖要求
- Paper 或 Purpur
1.21.9+ - Java
21
? 可选依赖项
- PlaceholderAPI
- SkinsRestorer
? 命令
| 命令 | 描述 | 权限 |
|---|---|---|
/hd togglechat |
切换执行者玩家的聊天头像显示。 | addhead.togglechat |
/hd toggletab |
切换执行者玩家的标签页头像显示。 | addhead.toggletab |
/hd settings |
打开本地化配置 GUI。 | addhead.settings |
/hd info |
显示插件名称、版本和作者信息。 | 无 |
/hd reload |
重载配置文件、语言文件和皮肤缓存。 | addhead.reload |
? 权限说明
addhead.togglechat- 允许切换自己的聊天头像。addhead.toggletab- 允许切换自己的标签页头像。addhead.settings- 允许打开设置 GUI。addhead.reload- 允许重载插件并使用修复操作。addhead.premium- 仅在premium.mode=permission时使用。
? 安装步骤
- 下载
AddHeads-{version}.jar。 - 将其放入服务器的
plugins/文件夹中。 - 启动或重启服务器。
- 根据需要编辑
config.yml和languages/*.yml,或使用/hd settings。 - 修改完成后使用
/hd reload重载。
? 注意事项
- AddHeads 不会强制使用特定的聊天格式化器。
- 它会在其他聊天插件完成格式化后,对最终的聊天组件进行装饰。
- 默认的标签页路径不需要任何占位符设置。
- 标签页头像是通过游戏内玩家列表名称自动插入的。
- 此功能可与原版玩家列表配合工作,并且旨在确保即使其他标签页相关插件后续重写列表名称,仍能正常工作。
- PlaceholderAPI 占位符仍可用于自定义布局、前缀、记分板和其他类似界面。
- 新的语言键值和配置键值将在重载时从内置默认值自动回填。
? 占位符
%addhead_head%- 用于聊天和组件感知型插件的 JSON 组件头像。%addhead_tab%- 用于自定义基于 PlaceholderAPI 布局的可选标签页头像占位符。%addhead_texture_value%- 原始纹理值。%addhead_texture_signature%- 原始纹理签名。%addhead_texture_hash%-textures.minecraft.net哈希值。%addhead_skin_ready%-true或false,表示共享皮肤缓存是否已有已确认的皮肤。%addhead_tab_visible%-true或false,表示该玩家的标签页头像输出是否已启用。
? 皮肤来源优先级
AddHeads 按以下顺序解析皮肤:
- SkinsRestorer
- 实时 Paper 玩家资料
- Paper 资料更新查询
- 根据玩家名称查询 Mojang 资料/会话
- AddHeads 已解析的缓存值
? 我的其他插件:
- PremiumBridge - 自动认证正版玩家(支持 AddHeads)
- PointCoordinates - 保存重要地点,整理坐标

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

- 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

- 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 settingsGUI 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:
-
TABNative support is implemented through the
TABAPI, so heads are added correctly even whenTABformats prefixes, suffixes, colors, and tab list names. -
CMI / PowerBoard / PowerBoard / Any otherSupported 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 whenpremium.mode=permission.
? Installation
- Download
AddHeads-{version}.jar. - Place it in your server
plugins/folder. - Start or restart the server.
- Edit
config.ymlandlanguages/*.ymlor use/hd settingsif needed. - Use
/hd reloadafter 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.nethash.%addhead_skin_ready%-trueorfalse, whether the shared skin cache already has a confirmed skin.%addhead_tab_visible%-trueorfalse, whether tab head output is enabled for that player.
? Skin Sources
AddHeads resolves skins in this order:
- SkinsRestorer
- live Paper player profile
- Paper profile update lookup
- Mojang profile/session lookup by player name
- cached value already resolved by AddHeads
? My Other Plugins:
- PremiumBridge - auto-authenticate premium players (Supports AddHeads)
- PointCoordinates - save important places, keep coordinates organized
下载 AddHeads
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AddHeads
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AddHeads
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AddHeads
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AddHeads
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AddHeads
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AddHeads
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AddHeads
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
1.2.7
新增
- 通过 Geyser 和 Floodgate 自动检测 Bedrock 玩家。
- 在聊天、标签页、加入消息和死亡消息中,Bedrock 玩家的头像现在会自动隐藏。
- 添加了原生的 Chatty v2 兼容性。
- 通过其最终的 Adventure 组件事件,改进了对 Chatty v3 的兼容性。
- 为 Bukkit 加入和死亡消息添加了头像渲染支持。
修复
- 修复了启用 Chatty 时聊天头像不显示的问题。
- 修复了 Chatty 格式与前置词、后置词、颜色及 MiniMessage 样式的兼容性问题。
- 修复了禁用或重载 Chatty 后集成数据过期的问题。
- 修复了当某位玩家关闭头像功能时,所有接收者均无法看到聊天头像的问题。
- 修复了通过
/hd update和/addhead update命令检查更新的问题。 - 提升了对 Paper、Purpur 和 Folia 的兼容性。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧