Suite

概览

Tooltip 客户端动态提示数据采集与跨模块共享

Tooltip 物品提示

模块简介

Tooltip 是 Suite 的客户端动态提示数据桥接模块。它接收客户端 ArcartX-Suite-Tooltips 采集的 tooltip 文本行与结构化数据，按玩家与物品去重缓存后，向其他模块提供查询服务。典型应用场景包括 TACZ 枪械属性展示、Apotheosis 词缀预览、聊天物品展示中的动态 Lore 注入等。

属性值
模块 IDtooltip
版本1.6.0
配置文件ArcartXTooltip.yml（gun-list.mode）+ messages.yml
消息文件messages.yml
数据包 IDAXS_TOOLTIP_DATA（C→S）、AXS_GUN_LIST（C→S）
插件消息通道axstooltip:gunui（S→C，枪械 UI 模式推送）
注册 UIAXS:gun_list（ui/gun_list.yml，ax 模式枪械浏览界面）
缓存 TTL60 秒
模块依赖无
外部依赖无
命令入口管理 /axs tooltip
对外能力TooltipDataCapable（tooltip 数据查询）

功能特性

特性说明
客户端 tooltip 采集客户端 ArcartX-Suite-Tooltips 采集 tooltip 文本行和结构化数据并发送给服务端
按物品指纹缓存以玩家 + 物品注册名（如 tacz:ak47）为键去重缓存，避免同一物品重复处理
结构化数据透传保留客户端采集的 JSON 格式结构化数据（如 TACZ 枪属性的 damage、armorIgnore、headshotMultiplier 等字段），供业务逻辑直接解析使用
Lore 注入将 tooltip 文本行注入物品 Lore，用于聊天物品预览等场景，支持 & 颜色码自动转换
跨模块共享其他模块可查询 tooltip 数据、结构化数据并执行 Lore 注入
自动清理缓存 60 秒自动过期，玩家退出时立即清理其全部缓存数据
管理命令/axs tooltip status（缓存/模式/通道）+ /axs tooltip push <玩家>（手动重推模式）
枪械浏览 UITACZ 配件"支持枪械"浏览：gun-list.mode 决定走 AX 自定义界面（AXS:gun_list）还是客户端本地 Forge 界面；模式经 axstooltip:gunui plugin message 进服推送、reload 后补推全部在线玩家

依赖

依赖类型名称必需说明
宿主ArcartXSuite 主插件是模块加载、网络包路由、Capability 注册
客户端ArcartX-Suite-Tooltips是客户端 Forge mod，采集 tooltip 数据并发送 AXS_TOOLTIP_DATA 网络包
模块依赖无-Tooltip 不依赖任何其他模块即可独立运行
外部依赖无-无 PlaceholderAPI / Vault 等外部插件依赖

Tooltip 模块本身无任何模块依赖与外部插件依赖。其核心数据来源是客户端 ArcartX-Suite-Tooltips，服务端仅负责接收、缓存与提供查询。若客户端未安装 mod，模块仍可正常启动，但缓存为空，所有查询返回空值。

使用流程

  1. 客户端 ArcartX-Suite-Tooltips 采集物品 tooltip 文本行与结构化数据并发送给服务端
  2. 服务端按玩家 + 物品注册名（如 tacz:ak47）去重缓存，缓存 60 秒自动过期，玩家退出时立即清理
  3. 其他模块查询并使用这些 tooltip 数据（如 Chat 物品展示时注入动态 Lore）

tooltip 文本行中可能包含 Minecraft 颜色码，Lore 注入时自动转换。同类型物品共享一份 tooltip 数据；客户端未安装 mod 时缓存为空，相关功能自动降级。

与其他模块的关系

消费方模块联动场景
Chat聊天物品展示 [item] 时，注入 tooltip 动态 Lore（TACZ 枪属性、Apotheosis 词缀等）
其他模块可获取结构化 JSON 数据，解析后用于业务逻辑

Tooltip 模块是纯数据提供方，不依赖其他模块。Tooltip 未加载时消费方自动降级（如聊天物品展示无动态 Lore）。

本页目录