AddHeads

插件

· 作者 goshkow

在聊天和玩家列表中添加玩家头颅,为基于 PlaceholderAPI 的插件提供可复用的头颅占位符 | 无需资源包或模组。支持离线模式。

0 本站下载 0 关注 更新于 3 个月前

最新 1.2.7 · 26.2 · Folia / Paper

一键开服(送7天)

banner

AddHeads

AddHeads 是一款轻量级的 Paper/Purpur 插件,适用于希望在聊天和游戏内标签页列表中添加玩家头像的服务器。它还提供了可复用的头像占位符,以便进行自定义集成。无需 RP(资源包)或模组

? 只需下载即可使用!

无需为聊天和标签页设置额外的插件配置——该插件在这些功能之上运行。
一切均可在原版客户端上正常工作,不需要任何资源包或模组。

? 语言支持

内置语言:

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

✨ 功能特性

  • 自动在游戏内玩家列表名称前添加玩家头像
    tablist example
  • 即使在离线模式下,也能与原版玩家列表及标签页相关插件配合工作,无需手动插入占位符
  • 在聊天消息前添加玩家头像
    chat example
  • 保留来自其他插件的现有聊天格式
  • 在可用时支持与 SkinsRestorer 共享皮肤解析
  • 为聊天和占位符提供单一的可复用皮肤缓存
  • 包含面向管理员的本地化 /hd settings GUI

⚙️ 功能列表

  • 原版聊天头像渲染
  • 无需额外设置即可自动插入玩家列表头像
  • 公开 Bukkit 服务 API 供其他插件调用
  • 支持 PlaceholderAPI,并提供多种导出格式
  • 兼容 SkinsRestorer 的皮肤查找
  • 自动刷新皮肤和缓存
  • 独立的聊天和玩家列表可见性开关
  • 本地化设置 GUI
  • 实时重载配置和语言文件
  • 重载时自动回填缺失的配置和语言键值
  • 可配置聊天和玩家列表中头像与文本之间的间距
  • 聊天头像和玩家列表头像拥有独立的阴影设置
  • 从 GitHub 和 Modrinth 检查更新

? 支持任意聊天插件

? 支持的标签页列表插件

AddHeads 直接支持以下标签页列表插件:

  • TAB

    通过 TAB API 实现原生支持,因此即使 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 时使用。

? 安装步骤

  1. 下载 AddHeads-{version}.jar。
  2. 将其放入服务器的 plugins/ 文件夹中。
  3. 启动或重启服务器。
  4. 根据需要编辑 config.yml 和 languages/*.yml,或使用 /hd settings。
  5. 修改完成后使用 /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 按以下顺序解析皮肤:

  1. SkinsRestorer
  2. 实时 Paper 玩家资料
  3. Paper 资料更新查询
  4. 根据玩家名称查询 Mojang 资料/会话
  5. AddHeads 已解析的缓存值

? 我的其他插件:

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源