Custom Tooltip API

模组

· 作者 Stalemated

基于数据的工具提示文本创建。

0 本站下载 0 关注 更新于 4 周前

需要前置:S-Lib

最新 5.2.1+1.21.1 · 1.21.1 · Fabric

一键开服(送7天)

Custom Tooltip API

Custom Tooltip API 是一款功能强大的客户端 Minecraft 模组及开发者库,让你完全掌控物品工具提示(Tooltip)。添加自定义背景故事、动态实时数据、动画渐变和自定义背景,所有设置均可在游戏内或通过代码进行配置。

基础使用无需编写代码,因为它提供了一个强大的游戏内界面并支持完整的 JSON。同时,它也提供了稳健的 Developer API,供希望以编程方式注入工具提示的开发者使用。


主要特性

  • 图标对齐: 将来自外部资源包的工具提示图标对齐到行首,确保位置一致!

  • 高级目标定位: 针对特定的物品 ID(minecraft:diamond_sword)、标签组(#c:swords)、整个模组命名空间(minecraft:*)、正则表达式模式(regex:.*_sword),或一次性针对所有物品(*)。

  • 动态占位符: 使用 %durability%、%max_durability%、%weapon_damage% 或 %enchantments% 等变量,将实时的物品数据直接嵌入文本中。你还可以使用 <key:key.jump> -> [Space] 格式嵌入快捷键提示。

  • 多行支持(背景故事): 添加整段的背景故事或技能描述。

  • 视觉效果与渐变:

    • 彩虹: 动画彩虹效果。
    • 滑动渐变: 在文本中流动的双色渐变。
    • 呼吸渐变: 两种颜色之间的平滑脉冲。
    • 静态渐变与纯色: 固定的渐变或传统的纯色文本。
    • 颜色: 十六进制代码(如 #RRGGBB)、旧版代码(如 &d)或 Minecraft 颜色名称(如 blue)。
  • 自定义背景与边框: 支持纯色、渐变、纹理(拉伸)或纹理(边框/九宫格)模式,并可完全控制透明度。将任意背景图片放入 config/custom-tooltip-api/backgrounds/,并通过动态生成的资源包为每个工具提示启用。完全兼容 Tierify 的自定义渲染。

  • 自定义字体: 将任意字体放入 config/custom-tooltip-api/fonts/,并通过动态生成的资源包为每个工具提示启用。

  • 位置设定: 精确决定文本出现的位置:

    • 顶部: 位于物品名称正下方。
    • 底部: 位于所有描述的末尾。
    • 前置: 位于特定行的开头。
    • 后置: 位于特定行的末尾。
    • 替换名称: 用你的自定义文本替换物品的默认名称。
    • 替换行: 用你的自定义文本替换特定的一行。
    • 替换全部: 完全清除原始工具提示,仅显示你自己的内容。
  • 可见性条件: 仅在物品受损、附魔或不可破坏时显示工具提示。使用 Require Keybind 模式,直到玩家按住可配置的按键才显示工具提示。

  • 文本修饰符: 完全支持 Bold(加粗)、Italic(斜体)、Underlined(下划线)、Strikethrough(删除线)以及 O̷͍̞͐͑b̷̻̌f̶̯̈u̸̲͗͐s̶̩̬͝c̵͎̊a̸̹̟̎ẗ̴͖̿e̴̟̪͊̈́ď̴̹̪(混淆)文本。


游戏内界面 (GUI)

  • 直接从 Mods Menu(模组菜单)管理所有工具提示。除非你愿意,否则无需手动编辑文件。

  • 在编辑界面按住 CTRL,即可即时预览你的工具提示。

  • 复制/粘贴条目到剪贴板,重新排序、复制、启用/禁用,并按创建日期或字母顺序排序。


面向开发者 (API)

开发者可以使用内置 API,通过代码直接注册工具提示和自定义占位符,并完整支持 .dynamicText(),用于实现每帧更新的实时数据,如能量、法力值或任何自定义 NBT 数据。

  • 查看项目 GitHub 上的 README.md 文件!
  • 代码示例可以在 这里 找到。

面向整合包创作者

该模组会在你的 config 文件夹中生成一个 custom_tooltip_api/config.json5 文件。它完全支持代码注释,使你能够极其轻松地为开发团队或社区记录整合包的系统。

将自定义背景放入 config/custom-tooltip-api/backgrounds/,将自定义字体放入 config/custom-tooltip-api/fonts/。启用动态生成的资源包以激活它们。


依赖项

所有平台必需:

仅限 Fabric:

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源