KubeJS：机械动力提示文本

KubeJS：机械动力提示文本

A KubeJS addon for Create that lets you register Create's rich, palette-styled tooltips on any item using a single startup script.

KubeJS

KubeJS：机械动力（Create）提示框

一个面向KubeJS的机械动力（Create）插件，让你只需一个启动脚本，就能为任何物品注册机械动力那种丰富的、调色板风格的提示框。

无需Java代码，无需单独的lang文件——只需KubeJS。

免责声明：

本模组及其描述由AI辅助制作。

快速开始

将模组JAR文件放入你的mods/文件夹中，与机械动力（Create）和KubeJS放在一起。

在kubejs/startup_scripts/tooltips.js创建一个启动脚本：

CreateTooltipEvents.register(event => {
  event.add('minecraft:stick', 'STANDARD_CREATE', {
    tooltip: '',
    summary: '一根简单的_木_棍。非常黏。'
  })
})

启动游戏，按住Shift键悬停在木棍上，即可看到提示框。

API

event.add(itemId, palette, text)

为指定物品注册一个机械动力提示框。lang键的基础部分会自动根据物品的翻译键推导。

event.addWithKey(itemId, palette, langKeyBase, text)

与add()相同，但允许你指定自定义的lang键基础，而不是使用物品的默认键。

调色板

palette参数控制提示框的配色方案。有效值：

STANDARD_CREATE、BLUE、GREEN、YELLOW、RED、PURPLE、GRAY、ALL_GRAY、GRAY_AND_BLUE、GRAY_AND_WHITE、GRAY_AND_GOLD、GRAY_AND_RED

调色板名称不区分大小写。

文本对象

text参数是一个包含以下字段的对象。所有字段都是可选的，但summary是显示提示框所必需的。

字段 显示时机 描述
tooltip - 检测键（机械动力识别物品所需，值不显示）
summary 按住Shift 主要描述文本
condition1...conditionN 按住Shift 条件标签（以灰色渲染）
behaviour1...behaviourN 按住Shift 与条件配对（支持高亮格式）
control1...controlN 按住Ctrl 控制标签（以灰色渲染）
action1...actionN 按住Ctrl 与控制配对（支持高亮格式）

条件/行为和控件/动作的编号从1开始按顺序排列，不允许跳号。

高亮格式

在行为和动作文本中使用下划线来切换高亮颜色：

behaviour1: '_燃烧_ 100个游戏刻'

这会将“燃烧”渲染为调色板的高亮颜色，将“100个游戏刻”渲染为主色。

完整示例

CreateTooltipEvents.register(event => {
  event.add('minecraft:stick', 'STANDARD_CREATE', {
    tooltip: '',
    summary: '一根拥有_许多_用途的简单木棍。',
    condition1: '当用作燃料时',
    behaviour1: '_燃烧_ 100个游戏刻',
    condition2: '当与燧石合成时',
    behaviour2: '制造出_箭矢_',
    control1: '右键点击',
    action1: '_戳刺_东西'
  })
})

VS Code 智能提示

在游戏中运行/kubejs generate_typings来生成TypeScript定义。这能让你在VS Code中获得CreateTooltipEvents及其方法的自动补全和悬停文档。