键位检测器

键位检测器

检测任何按键,以启用更多按键事件的可能性!!!

技术

键盘检测器命令指南

在 Minecraft 中实现对所有按键的高级键盘事件检测!

命令概览

命令 功能 关键参数
iskeydown 单键按下检测 <KeyAscii>、<keepStatic>
matchgroup 多键组合检测 <KeyAsciiList>
iskeytapped 即时多键组合检测 <KeyAsciiList>
flush 重置子命令 iskeydown 的按键状态 无

1. 单键检测:/keyboarddetector iskeydown

功能

检测特定键盘按键的实时按下状态。

命令语法

/keyboarddetector iskeydown <PlayerID> <KeyAscii>
参数 描述 示例值
<PlayerID> 目标玩家选择器 @p、@a[limit=1]、@e[type=player,limit=1]
<KeyAscii> 要检测的按键 ASCII 码 49
<keepStatic> 持久状态模式(true/false) true、false

用法示例

标准模式:

/keyboarddetector iskeydown @p 49 false

检测按键“1”的长按状态。

持久模式:

/keyboarddetector iskeydown @p 49 true

如果目标玩家按下过“1”键,命令方块将返回 true 并持续激活红石信号 (直到执行 /keyboarddetector flush 为止)。

命令方块行为

模式 行为
标准模式 (keepStatic=false) • 当所有按键同时按下时激活信号
• 任意按键释放时立即停用
持久模式 (keepStatic=true) • 首次成功检测后锁定信号。
• 按键释放后仍保持激活。
• 需要手动 flush 才能重置

2. 组合键检测:/keyboarddetector matchgroup

功能

检测多个按键的同时按下。(独立按键处理)

命令语法

/keyboarddetector matchgroup <PlayerID> <KeyAsciiList> <keepStatic>

参数

参数 描述 示例值
<PlayerID> 目标玩家选择器 @p、@a[limit=1]、@e[type=player,limit=1]
<KeyAscii> 逗号分隔的 ASCII 码 49,50,51

用法示例

/keyboarddetector matchgroup @p 49,50,51

检测按键“1”、“2”、“3”的同时按下。

命令方块行为

  • 在循环命令方块中:
    • 🔴 按键按下:返回 true 并激活红石信号
    • ⚪ 按键释放:返回 false 并停用红石信号

3. 即时组合键检测:/keyboarddetector iskeytapped

功能

仅检测多个按键被按下的瞬间。(独立按键处理)

命令语法

/keyboarddetector iskeytapped <PlayerID> <KeyAsciiList> <keepStatic>

参数

参数 描述 示例值
<PlayerID> 目标玩家选择器 @p、@a[limit=1]、@e[type=player,limit=1]
<KeyAscii> 逗号分隔的 ASCII 码 49,50,51

用法示例

/keyboarddetector iskeytapped @p 49,50,51

仅检测按键“1”、“2”、“3”被按下的瞬间。

命令方块行为

  • 在循环命令方块中:
    • 🔴 按键按下:仅在按键被按下的瞬间返回 true 并激活红石信号。
    • ⚪ 按键持续按住:返回 false 并停用红石信号。(与 /keyboarddetector matchgroup 不同)
    • ⚪ 按键释放:返回 false 并停用红石信号

4. 状态重置命令:/keyboarddetector flush

功能

清除由 iskeydown 在 keepStatic=true 时创建的持久按键状态。

使用场景

  1. 持久模式已激活:
/keyboarddetector iskeydown @p 49 true
  1. 按键被按下后,信号保持激活

  2. 重置检测状态 (必须带条件语句):

/keyboarddetector flush

效果

♻️ 重置所有检测状态

🚦 需要重新按下组合键才能再次激活

注意事项

❗ 当有超过 1 个命令方块执行 /keyboarddetector matchgroup 时,请确保所有 <AsciiList> 都不包含任何重复值。否则只能触发其中一个按键事件。

❗ 不要在没有条件语句的情况下使用 /keyboarddetector flush。否则,所有检测子命令都将不可用。

ASCII 按键参考表

按键 ASCII 码 按键 ASCII 码
数字 字母
0 48 A 65
1 49 B 66
2 50 C 67
3 51 D 68
4 52 E 69
5 53 F 70
6 54 G 71
7 55 H 72
8 56 I 73
9 57 J 74
K 75
L 76
M 77
N 78
O 79
P 80
Q 81
R 82
S 83
T 84
U 85
V 86
W 87
X 88
Y 89
Z 90
功能键 特殊键
F1 112 空格 32
F2 113 回车 13
F3 114 Esc 27
F4 115 Tab 9
F5 116 Caps Lock 20
F6 117 Shift 16
F7 118 Ctrl 17
F8 119 Alt 18
F9 120 退格 8
F10 121 Delete 46
F11 122 Insert 45
F12 123 Home 36
End 35
Page Up 33
Page Down 34
上箭头 38
下箭头 40
左箭头 37
右箭头 39

备注:

  • 小写字母:a=97,b=98 … z=122
  • 数字小键盘:0=96,1=97 … 9=105
  • 区分大小写(A=65 与 a=97)
  • 完整参考:ASCII 表