LogoArcartX Doc
ArcartX工具集目录

Keyboard:键盘控制

Keyboard 键盘输入工具集

Keyboard.isKeyDown(key)

  • 检测指定按键是否被按下
  • 参数key: 字符串类型(按键名称)
  • 返回值:布尔类型
  • 调用示例
Keyboard.isKeyDown("W")

Keyboard.getKeyBindingKey(binding)

  • 获取按键绑定的 MC 键位 ID(如 key.keyboard.left.control
  • getKeyBindingKeyName 的区别:此函数返回的是固定的键位 ID,不会随客户端语言变化
  • 参数binding: 字符串类型(按键绑定名称)
  • 返回值:字符串类型(MC 键位 ID)
  • 调用示例
Keyboard.getKeyBindingKey("forward")
  • 示例返回值
"key.keyboard.w"

Keyboard.getKeyBindingKeyName(binding)

  • 获取按键绑定的显示名称(会根据客户端语言变化)
  • 参数binding: 字符串类型(按键绑定名称)
  • 返回值:字符串类型
  • 调用示例
Keyboard.getKeyBindingKeyName("forward")
  • 示例返回值
"W"

Keyboard.getKeyBindingKeyModifierName(binding)

  • 获取按键绑定的修饰键名称
  • 参数binding: 字符串类型(按键绑定名称)
  • 返回值:字符串类型(修饰键名称,无修饰键时返回空字符串)
  • 调用示例
Keyboard.getKeyBindingKeyModifierName("screenshot")
  • 示例返回值
"CONTROL"

Fabric 版本不支持修饰键功能,此函数在 Fabric 上始终返回空字符串。

Keyboard.setKeyBindingKeyName(binding, modifier, keyName)

  • 设置按键绑定的按键
  • 参数
    • binding: 字符串类型(按键绑定名称)
    • modifier: 字符串类型(修饰键名称,Fabric 上填任意字符串即可,不会生效)
    • keyName: 字符串类型(按键名称,如 key.keyboard.w
  • 返回值:无
  • 调用示例
Keyboard.setKeyBindingKeyName("forward", "NONE", "key.keyboard.w")

第三个参数已从数字 ID 改为按键名称字符串。使用 MC 的键位 ID 格式,如 key.keyboard.wkey.keyboard.left.control 等。

Keyboard.keyPress(key, pressed)

  • 模拟按键按下或释放
  • 参数
    • key: 字符串类型(按键名称)
    • pressed: 布尔类型(true 为按下,false 为释放)
  • 返回值:无
  • 调用示例
Keyboard.keyPress("W", true)

key 参数支持两种格式:MC 键位 ID(如 key.keyboard.w)和 AX 键位名称(如 W)。

On this page