Minecraft:Key codes - Revision history

SyncBot: Sync: updated from Minecraft

2026-10-22T11:21:58Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:21, 22 October 2026
Line 15:		Line 15:

	The displayed names of several keys will change depending on the currently active system keyboard layout. The values displayed in this table assume a standard en-US QWERTY layout. Some keys also have operating system dependent names, which are assigned different rows sharing an ID.		The displayed names of several keys will change depending on the currently active system keyboard layout. The values displayed in this table assume a standard en-US QWERTY layout. Some keys also have operating system dependent names, which are assigned different rows sharing an ID.

			If SDL does not define a specific key as a valid input, it will be set to "Not Bound" if attempting to bind a control to it.{{until\|java 26.4}}

			If a key is pressed that SDL does not assign a key code to, the game will act as though no key is pressed.{{upcoming\|java 26.4}} This is a bug which Mojang have decided not to fix.<ref>{{bug\|MC-312500}}</ref>

	{\| class="wikitable sortable" data-description="Keyboard key and multimedia button IDs" style="margin-left:auto; margin-right:auto; text-align: center"		{\| class="wikitable sortable" data-description="Keyboard key and multimedia button IDs" style="margin-left:auto; margin-right:auto; text-align: center"
Line 24:		Line 28:
	! {{code\|key.keyboard.unknown}}		! {{code\|key.keyboard.unknown}}
	\| {{btn\|Not Bound}}		\| {{btn\|Not Bound}}
	\| colspan="2" \| Unassigned, or unrecognized<ref>{{bug\|MC-310108}}</ref>		\| colspan="2" \| Unassigned, or unrecognized<ref>{{bug\|MC-310108}}</ref>{{until\|java 26.4}}
	\| {{code\|key.keyboard.unknown}}		\| {{code\|key.keyboard.unknown}}
	\|-		\|-

SyncBot: Sync: updated from Minecraft

2026-10-05T11:10:13Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:10, 5 October 2026
Line 24:		Line 24:
	! {{code\|key.keyboard.unknown}}		! {{code\|key.keyboard.unknown}}
	\| {{btn\|Not Bound}}		\| {{btn\|Not Bound}}
	\| colspan="2" \| Unassigned, or ~~unrecognised~~<ref>{{bug\|MC-310108}}</ref>		\| colspan="2" \| Unassigned, or unrecognized<ref>{{bug\|MC-310108}}</ref>
	\| {{code\|key.keyboard.unknown}}		\| {{code\|key.keyboard.unknown}}
	\|-		\|-
Line 946:		Line 946:
	! {{code\|key.keyboard.channel.down}}		! {{code\|key.keyboard.channel.down}}
	\| {{btn\|Channel Down}}		\| {{btn\|Channel Down}}
	\| colspan="2" \| {{note\|name=channelproblem\|Linux only, but not assignable as the game fails to ~~recognise~~ key presses above ID 247: {{bug\|MC-311578}}}}		\| colspan="2" \| {{note\|name=channelproblem\|Linux only, but not assignable as the game fails to recognize key presses above ID 247: {{bug\|MC-311578}}}}
	\| {{code\|key.keyboard.channel.down}}		\| {{code\|key.keyboard.channel.down}}
	\|-		\|-
Line 956:		Line 956:
	! {{code\|key.keyboard.clear}}		! {{code\|key.keyboard.clear}}
	\| {{btn\|Clear}}		\| {{btn\|Clear}}
	\| colspan="2" \| {{note\|name=247plus\|Linux only, but not assignable as the game fails to ~~recognise~~ key presses above ID 247: {{bug\|MC-311584}}}}		\| colspan="2" \| {{note\|name=247plus\|Linux only, but not assignable as the game fails to recognize key presses above ID 247: {{bug\|MC-311584}}}}
	\| {{code\|key.keyboard.clear}}		\| {{code\|key.keyboard.clear}}
	\|-		\|-

SyncBot: Sync: updated from Minecraft

2026-10-01T11:13:05Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:13, 1 October 2026
Line 2,928:		Line 2,928:
	{{reflist}}		{{reflist}}

			== Navigation ==
	{{Navbox input}}		{{Navbox input}}

SyncBot: Sync: updated from Minecraft

2026-09-21T11:11:55Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:11, 21 September 2026
Line 1,609:		Line 1,609:
	{{info needed section\|In the lang files there are translation strings for each translatable keycode that is a shortened version (e.g. PgUp instead of PAGE UP). Figure out if these ever appear in the game and, if they do, add a column for them.}}		{{info needed section\|In the lang files there are translation strings for each translatable keycode that is a shortened version (e.g. PgUp instead of PAGE UP). Figure out if these ever appear in the game and, if they do, add a column for them.}}
	{{cleanup\|section=1\|for differing operating systems (e.g. things involving the command key), implement something similar to what is seen with the Java Edition keyboard table above: make the key ID span multiple rows (rowspan 2), and have sub-rows per operating system}}		{{cleanup\|section=1\|for differing operating systems (e.g. things involving the command key), implement something similar to what is seen with the Java Edition keyboard table above: make the key ID span multiple rows (rowspan 2), and have sub-rows per operating system}}
	In {{BE}}, keys are stored as the decimal representation of their [https://learn.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes Windows virtual key code]. This also includes platforms other than Windows, where keys are loosely mapped to these ~~keycodes~~.		In {{BE}}, keys are stored as the decimal representation of their [https://learn.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes Windows virtual key code]. This also includes platforms other than Windows, where keys are loosely mapped to these key codes.

	On Android, the majority of non-basic keys are not recognized, and the Menu key is mapped to unknown (255).		On Android, the majority of non-basic keys are not recognized, and the Menu key is mapped to unknown (255).

	Some numbers are skipped because they are reserved or not assigned. By modifying options.txt, you can force the game to show these numbers (prefixed with "Button"), but they are unobtainable by pressing a key.		Some numbers are skipped because they are reserved or not assigned. By modifying <samp>options.txt</samp>, you can force the game to show these numbers (prefixed with "Button"), but they are unobtainable by pressing a key. The virtual key code specification also provides numbers for buttons on the mouse. However, mouse buttons are not stored as those numbers.

	~~The virtual~~ key ~~code specification also provides numbers~~ for ~~buttons on~~ the ~~mouse. However~~, ~~mouse buttons are not stored as those numbers~~.		Multiple keys can be bound to the same action by separating their key codes with a comma in <samp>options.txt</samp>. There is not a way to do this in-game. For example, the default value in <samp>options.txt</samp> for opening the chat is {{cd\|84,13}}, representing both {{key\|T}} and {{key\|Return}}.
	{\| class="wikitable" data-description="Keyboard button IDs" style="margin-left:auto; margin-right:auto; text-align:center"		{\| class="wikitable" data-description="Keyboard button IDs" style="margin-left:auto; margin-right:auto; text-align:center"
	! ID		! ID
Line 1,649:		Line 1,649:
	! {{code\|13}}		! {{code\|13}}
	\| {{btn\|RETURN\|be=1}}		\| {{btn\|RETURN\|be=1}}
	\| {{key\|Return}}		\| {{key\|Return}} / {{key\|Numpad Enter}}
	\| {{code\|keyboard.keyName.return}}		\| {{code\|keyboard.keyName.return}}
	\|-		\|-

SyncBot: Sync: updated from Minecraft

2026-09-18T11:20:48Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:20, 18 September 2026
Line 957:		Line 957:
	\| {{btn\|Clear}}		\| {{btn\|Clear}}
	\| colspan="2" \| {{note\|name=247plus\|Linux only, but not assignable as the game fails to recognise key presses above ID 247: {{bug\|MC-311584}}}}		\| colspan="2" \| {{note\|name=247plus\|Linux only, but not assignable as the game fails to recognise key presses above ID 247: {{bug\|MC-311584}}}}
	\|		\| {{code\|key.keyboard.clear}}
	\|-		\|-
	! {{code\|key.keyboard.mode}}		! {{code\|key.keyboard.mode}}
Line 1,609:		Line 1,609:
	{{info needed section\|In the lang files there are translation strings for each translatable keycode that is a shortened version (e.g. PgUp instead of PAGE UP). Figure out if these ever appear in the game and, if they do, add a column for them.}}		{{info needed section\|In the lang files there are translation strings for each translatable keycode that is a shortened version (e.g. PgUp instead of PAGE UP). Figure out if these ever appear in the game and, if they do, add a column for them.}}
	{{cleanup\|section=1\|for differing operating systems (e.g. things involving the command key), implement something similar to what is seen with the Java Edition keyboard table above: make the key ID span multiple rows (rowspan 2), and have sub-rows per operating system}}		{{cleanup\|section=1\|for differing operating systems (e.g. things involving the command key), implement something similar to what is seen with the Java Edition keyboard table above: make the key ID span multiple rows (rowspan 2), and have sub-rows per operating system}}
	In {{BE}}, keys are stored as the decimal representation of their [https://learn.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes virtual key code].		In {{BE}}, keys are stored as the decimal representation of their [https://learn.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes Windows virtual key code]. This also includes platforms other than Windows, where keys are loosely mapped to these keycodes.

			On Android, the majority of non-basic keys are not recognized, and the Menu key is mapped to unknown (255).

	Some numbers are skipped because they are reserved or not assigned. By modifying options.txt, you can force the game to show these numbers (prefixed with "Button"), but they are unobtainable by pressing a key.		Some numbers are skipped because they are reserved or not assigned. By modifying options.txt, you can force the game to show these numbers (prefixed with "Button"), but they are unobtainable by pressing a key.
Line 2,552:		Line 2,554:

	=== Mouse codes ===		=== Mouse codes ===
	{{info needed section\|~~how~~ many mouse buttons does ~~bedrock~~ support? ~~there~~ are no official Linux versions, but perhaps ~~chrome OS~~, or iOS ~~with an attached mouse,~~ could support more than Windows's five}}
			{{info needed section\|How many mouse buttons does Bedrock support? There are no official Linux versions, but perhaps ChromeOS (unlikely, due to the build being near identical to Android) or iOS could support more than Windows's five}}

	Mouse buttons are represented by negative numbers.		Mouse buttons are represented by negative numbers.

			On Android, only 3 buttons are recognized, despite the OS supporting up to 5 buttons.

	{\| class="wikitable" data-description="Keyboard button IDs" style="margin-left:auto; margin-right:auto"		{\| class="wikitable" data-description="Keyboard button IDs" style="margin-left:auto; margin-right:auto"
	! ID		! ID

SyncBot: Sync: updated from Minecraft

2026-09-17T11:16:54Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:16, 17 September 2026
Line 681:		Line 681:
	\| {{code\|key.keyboard.right.meta}}		\| {{code\|key.keyboard.right.meta}}
	\|-		\|-
	! rowspan="2" \| {{code\|key.keyboard.lang1}}<ref name="genericintl">Mojang have chosen to ~~assign~~ generic, non-descriptive titles to these keys, matching their internal SDL3 IDs rather than the actual real-life key names: {{bug\|MC-311175}}</ref>		! rowspan="2" \| {{code\|key.keyboard.lang1}}<ref name="genericintl">Mojang have chosen to keep the generic, non-descriptive USB HID titles for these keys, matching their internal SDL3 IDs rather than the actual real-life key names: {{bug\|MC-311175}}</ref>
	\| rowspan="2" \| {{btn\|Language 1}}<ref name="genericintl"/>		\| rowspan="2" \| {{btn\|Language 1}}<ref name="genericintl"/>
	\| Windows/Linux		\| Windows/Linux
Line 1,248:		Line 1,248:
	! {{code\|key.keyboard.world.2}}		! {{code\|key.keyboard.world.2}}
	\| {{btn\|<nowiki>#</nowiki>}}		\| {{btn\|<nowiki>#</nowiki>}}
	\| {{code~~\|key~~.~~keyboard.world.2}}{{note\|name=world-key-translation}}~~		\| Represents "Non-US Hash", which in practice is always pointed to the same code as the ANSI backslash.
	\|}		\|}

SyncBot: Sync: updated from Minecraft

2026-09-16T11:25:27Z

Sync: updated from Minecraft

Show changes

SyncBot: Sync: updated from Minecraft

2026-09-14T11:08:23Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:08, 14 September 2026
Line 5:		Line 5:
	{{For\|the codes used prior to [[Minecraft:the Flattening]]\|Java Edition pre-flattening data values#Key codes}}		{{For\|the codes used prior to [[Minecraft:the Flattening]]\|Java Edition pre-flattening data values#Key codes}}

	Only keys which can be directly detected by the operating system are able to be bound to game controls - keys such as F Lock<ref>{{bug\|MC-265854}}</ref> or Fn typically are not ~~recognisable~~ themselves as keys, and Minecraft and all other computer programs will be oblivious to them in isolation.		Only keys which can be directly detected by the operating system are able to be bound to game controls - keys such as F Lock<ref>{{bug\|MC-265854}}</ref> or Fn typically are not recognizable themselves as keys, and Minecraft and all other computer programs will be oblivious to them in isolation.

	Only mouse buttons can have controls be bound to them in the options menu. Mouse movement, vertical scrolling and horizontal scrolling are hardcoded, and their default actions cannot be assigned to other keys or buttons, nor can scrolling or moving the mouse be made to do anything else.		Only mouse buttons can have controls be bound to them in the options menu. Mouse movement, vertical scrolling and horizontal scrolling are hardcoded, and their default actions cannot be assigned to other keys or buttons, nor can scrolling or moving the mouse be made to do anything else.
Line 25:		Line 25:
	! {{code\|key.keyboard.unknown}}		! {{code\|key.keyboard.unknown}}
	\| {{btn\|Not Bound}}		\| {{btn\|Not Bound}}
	\| colspan="2" \| Unassigned{{note\|Also used by keys ~~unrecognised~~ by SDL3, see {{bug\|MC-310108}}{{upcoming\|java 26.3}}}}		\| colspan="2" \| Unassigned{{note\|Also used by keys unrecognized by SDL3, see {{bug\|MC-310108}}{{upcoming\|java 26.3}}}}
	\| {{code\|key.keyboard.unknown}}		\| {{code\|key.keyboard.unknown}}
	\|-		\|-
Line 405:		Line 405:
	! {{code\|key.keyboard.f25}}{{until\|java 26.3}}		! {{code\|key.keyboard.f25}}{{until\|java 26.3}}
	\| {{btn\|F25}}		\| {{btn\|F25}}
	\| colspan="2" \| Unclear{{note\|Ostensibly for a twenty-fifth function key, but Windows, Linux and presumably macOS only ~~recognise~~ up to F24. Some keyboards from decades past go past F24, and Arch Linux can apparently ~~recognise~~ up to F246, however it is unknown if Minecraft would ~~recognise~~ either of these.}}		\| colspan="2" \| Unclear{{note\|Ostensibly for a twenty-fifth function key, but Windows, Linux and presumably macOS only recognize up to F24. Some keyboards from decades past go past F24, and Arch Linux can apparently recognize up to F246, however it is unknown if Minecraft would recognize either of these.}}
	\| {{code\|key.keyboard.f25}}		\| {{code\|key.keyboard.f25}}
	\|-		\|-
Line 757:		Line 757:
	! {{code\|key.keyboard.alternate.erase}}{{upcoming\|java 26.3}}		! {{code\|key.keyboard.alternate.erase}}{{upcoming\|java 26.3}}
	\| {{btn\|Alternate Erase}}		\| {{btn\|Alternate Erase}}
	\| colspan="2" \| {{note\|Not ~~recognised~~ for some reason: {{bug\|MC-311320}}}}		\| colspan="2" \| {{note\|Not recognized for some reason: {{bug\|MC-311320}}}}
	\| {{code\|key.keyboard.alternate.erase}}		\| {{code\|key.keyboard.alternate.erase}}
	\|-		\|-
Line 2,740:		Line 2,740:
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|java classic}}		\|{{HistoryLine\|java classic}}
	\|{{HistoryLine\|\|0.0.23a\|Controls can now be customized. Only keyboard buttons are ~~recognised~~ as valid for rebinding.}}		\|{{HistoryLine\|\|0.0.23a\|Controls can now be customized. Only keyboard buttons are recognized as valid for rebinding.}}
	\|{{HistoryLine\|java beta}}		\|{{HistoryLine\|java beta}}
	\|{{HistoryLine\|\|1.8\|dev=Pre-release\|Controls can now be bound to mouse buttons; these are handled using negative numbers.}}		\|{{HistoryLine\|\|1.8\|dev=Pre-release\|Controls can now be bound to mouse buttons; these are handled using negative numbers.}}
Line 2,769:		Line 2,769:
	\|Certain keys, such as keypad plus-or-minus, keypad opening bracket and keypad closing bracket, now display the character they represent, despite not being defined key codes in the game.<ref>{{bug\|MC-310109}}, {{bug\|MC-310110}}</ref>		\|Certain keys, such as keypad plus-or-minus, keypad opening bracket and keypad closing bracket, now display the character they represent, despite not being defined key codes in the game.<ref>{{bug\|MC-310109}}, {{bug\|MC-310110}}</ref>
	\|The game now uses SDL3.		\|The game now uses SDL3.
	\|The international backslash key is now ~~recognised~~ as {{code\|key.keyboard.world.1}} on Windows, rather than {{code\|key.keyboard.world.2}}.		\|The international backslash key is now recognized as {{code\|key.keyboard.world.1}} on Windows, rather than {{code\|key.keyboard.world.2}}.
	\|{{code\|key.keyboard.keypad.decimal}} can no longer be assigned.		\|{{code\|key.keyboard.keypad.decimal}} can no longer be assigned.
	\|{{code\|key.keyboard.menu}} is now assigned with {{key\|Compose}} instead of {{key\|Menu}}.}}		\|{{code\|key.keyboard.menu}} is now assigned with {{key\|Compose}} instead of {{key\|Menu}}.}}

SyncBot: Sync: updated from Minecraft

2026-09-08T11:07:28Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:07, 8 September 2026
Line 1,251:		Line 1,251:
	\|-		\|-
	! {{code\|key.keyboard.sys.req}}		! {{code\|key.keyboard.sys.req}}
	\| {{btn\|SysRq}}		\| {{btn\|SysRq}}{{note\|Mojang have chosen to keep this name, despite it being abbreviated in direct contrast to almost all other keys: {{bug\|MC-311713}}}}
	\|		\|
	\|-		\|-

SyncBot: Sync: updated from Minecraft

2026-09-07T11:09:35Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:09, 7 September 2026
Line 12:		Line 12:

	=== Keyboard codes ===		=== Keyboard codes ===
			{{info needed section\|Instead of bug reports, it may be better to cite https://github.com/libsdl-org/SDL/pull/16239 for some unintuitive Linux mappings}}
	Keyboard buttons are handled as a signed 32-bit integer, meaning that through editing options.txt, values from {{code\|key.keyboard.-2147483648}} to {{code\|key.keyboard.2147483647}} can be specified without being rejected by the game as invalid. Any keys corresponding to a valid [[Minecraft:SDL3 scancodes\|SDL key code]] will be automatically converted to one of the named keys below.		Keyboard buttons are handled as a signed 32-bit integer, meaning that through editing options.txt, values from {{code\|key.keyboard.-2147483648}} to {{code\|key.keyboard.2147483647}} can be specified without being rejected by the game as invalid. Any keys corresponding to a valid [[Minecraft:SDL3 scancodes\|SDL key code]] will be automatically converted to one of the named keys below.

Line 691:		Line 692:
	\| {{code\|key.keyboard.right.meta}}{{upcoming\|java 26.3}}		\| {{code\|key.keyboard.right.meta}}{{upcoming\|java 26.3}}
	\|-		\|-
	! {{code\|key.keyboard.lang1}}{{upcoming\|java 26.3}}<ref name="genericintl">Mojang have chosen to assign generic, non-descriptive titles to these keys, matching their internal SDL3 IDs rather than the actual real-life key names: {{bug\|MC-311175}}</ref>		! rowspan="2" \| {{code\|key.keyboard.lang1}}{{upcoming\|java 26.3}}<ref name="genericintl">Mojang have chosen to assign generic, non-descriptive titles to these keys, matching their internal SDL3 IDs rather than the actual real-life key names: {{bug\|MC-311175}}</ref>
	\| {{btn\|Language 1}}<ref name="genericintl"/>		\| rowspan="2" \| {{btn\|Language 1}}<ref name="genericintl"/>
	\| ~~colspan="2"~~ \| {{key\|~~Hangul~~}}		\| Windows/Linux
	\| {{code\|key.keyboard.lang1}}<ref name="genericintl"/>		\| {{key\|Hangeul}}
			\| rowspan="2" \| {{code\|key.keyboard.lang1}}<ref name="genericintl"/>
	\|-		\|-
	! {{code\|key.keyboard.lang2}}{{upcoming\|java 26.3}}<ref name="genericintl"/>		\| macOS
	\| {{btn\|Language 2}}<ref name="genericintl"/>		\| {{key\|Kana}}
	\| ~~colspan="2"~~ \| {{key\|Hanja}}		\|-
	\| {{code\|key.keyboard.lang2}}<ref name="genericintl"/>		! rowspan="2" \| {{code\|key.keyboard.lang2}}{{upcoming\|java 26.3}}<ref name="genericintl"/>
			\| rowspan="2" \| {{btn\|Language 2}}<ref name="genericintl"/>
			\| Windows/Linux
			\| {{key\|Hanja}}
			\| rowspan="2" \| {{code\|key.keyboard.lang2}}<ref name="genericintl"/>
			\|-
			\| macOS
			\| {{key\|Eisu}}
	\|-		\|-
	! {{code\|key.keyboard.lang3}}{{upcoming\|java 26.3}}<ref name="genericintl"/>		! {{code\|key.keyboard.lang3}}{{upcoming\|java 26.3}}<ref name="genericintl"/>
Line 958:		Line 967:

	==== Unused ====		==== Unused ====
			{{info needed section\|on Linux, SysRq, Channel Up, Channel Down, Mode, Select and Clear should be usable - move at least some to above table and cite bug reports explaining why they aren't, maybe making a new one for the first beforehand}}
	Minecraft includes IDs and translation strings for all named SDL3 key IDs, even those which are not present in the key binding files for any supported operating system, and therefore cannot be accessed.		Minecraft includes IDs and translation strings for all named SDL3 key IDs, even those which are not present in the key binding files for any supported operating system, and therefore cannot be accessed.

Line 1,677:		Line 1,687:
	! {{code\|21}}		! {{code\|21}}
	\| {{btn\|Button21\|be=1}}		\| {{btn\|Button21\|be=1}}
	\| {{key\|~~IME~~ Kana}}{{~~info needed\|Is this the hiragana-katakana toggle?~~}} / {{key\|~~Hangul~~}}		\| {{key\|Kana}}{{verify}} / {{key\|Hangeul}}
	\|		\|
	\|-		\|-
Line 1,697:		Line 1,707:
	! {{code\|25}}		! {{code\|25}}
	\| {{btn\|Button25\|be=1}}		\| {{btn\|Button25\|be=1}}
	\| {{key\|Hanja}} / {{key\|~~IME Kanji~~}}		\| {{key\|Hanja}} / {{key\|Eisu}}{{verify}}
	\|		\|
	\|-		\|-

← Older revision		Revision as of 11:21, 22 October 2026
Line 15:		Line 15:

	The displayed names of several keys will change depending on the currently active system keyboard layout. The values displayed in this table assume a standard en-US QWERTY layout. Some keys also have operating system dependent names, which are assigned different rows sharing an ID.		The displayed names of several keys will change depending on the currently active system keyboard layout. The values displayed in this table assume a standard en-US QWERTY layout. Some keys also have operating system dependent names, which are assigned different rows sharing an ID.

			If SDL does not define a specific key as a valid input, it will be set to "Not Bound" if attempting to bind a control to it.{{until\|java 26.4}}

			If a key is pressed that SDL does not assign a key code to, the game will act as though no key is pressed.{{upcoming\|java 26.4}} This is a bug which Mojang have decided not to fix.<ref>{{bug\|MC-312500}}</ref>

	{\| class="wikitable sortable" data-description="Keyboard key and multimedia button IDs" style="margin-left:auto; margin-right:auto; text-align: center"		{\| class="wikitable sortable" data-description="Keyboard key and multimedia button IDs" style="margin-left:auto; margin-right:auto; text-align: center"
Line 24:		Line 28:
	! {{code\|key.keyboard.unknown}}		! {{code\|key.keyboard.unknown}}
	\| {{btn\|Not Bound}}		\| {{btn\|Not Bound}}
	\| colspan="2" \| Unassigned, or unrecognized<ref>{{bug\|MC-310108}}</ref>		\| colspan="2" \| Unassigned, or unrecognized<ref>{{bug\|MC-310108}}</ref>{{until\|java 26.4}}
	\| {{code\|key.keyboard.unknown}}		\| {{code\|key.keyboard.unknown}}
	\|-		\|-

← Older revision		Revision as of 11:10, 5 October 2026
Line 24:		Line 24:
	! {{code\|key.keyboard.unknown}}		! {{code\|key.keyboard.unknown}}
	\| {{btn\|Not Bound}}		\| {{btn\|Not Bound}}
	\| colspan="2" \| Unassigned, or ~~unrecognised~~<ref>{{bug\|MC-310108}}</ref>		\| colspan="2" \| Unassigned, or unrecognized<ref>{{bug\|MC-310108}}</ref>
	\| {{code\|key.keyboard.unknown}}		\| {{code\|key.keyboard.unknown}}
	\|-		\|-
Line 946:		Line 946:
	! {{code\|key.keyboard.channel.down}}		! {{code\|key.keyboard.channel.down}}
	\| {{btn\|Channel Down}}		\| {{btn\|Channel Down}}
	\| colspan="2" \| {{note\|name=channelproblem\|Linux only, but not assignable as the game fails to ~~recognise~~ key presses above ID 247: {{bug\|MC-311578}}}}		\| colspan="2" \| {{note\|name=channelproblem\|Linux only, but not assignable as the game fails to recognize key presses above ID 247: {{bug\|MC-311578}}}}
	\| {{code\|key.keyboard.channel.down}}		\| {{code\|key.keyboard.channel.down}}
	\|-		\|-
Line 956:		Line 956:
	! {{code\|key.keyboard.clear}}		! {{code\|key.keyboard.clear}}
	\| {{btn\|Clear}}		\| {{btn\|Clear}}
	\| colspan="2" \| {{note\|name=247plus\|Linux only, but not assignable as the game fails to ~~recognise~~ key presses above ID 247: {{bug\|MC-311584}}}}		\| colspan="2" \| {{note\|name=247plus\|Linux only, but not assignable as the game fails to recognize key presses above ID 247: {{bug\|MC-311584}}}}
	\| {{code\|key.keyboard.clear}}		\| {{code\|key.keyboard.clear}}
	\|-		\|-

← Older revision		Revision as of 11:08, 14 September 2026
Line 5:		Line 5:
	{{For\|the codes used prior to [[Minecraft:the Flattening]]\|Java Edition pre-flattening data values#Key codes}}		{{For\|the codes used prior to [[Minecraft:the Flattening]]\|Java Edition pre-flattening data values#Key codes}}

	Only keys which can be directly detected by the operating system are able to be bound to game controls - keys such as F Lock<ref>{{bug\|MC-265854}}</ref> or Fn typically are not ~~recognisable~~ themselves as keys, and Minecraft and all other computer programs will be oblivious to them in isolation.		Only keys which can be directly detected by the operating system are able to be bound to game controls - keys such as F Lock<ref>{{bug\|MC-265854}}</ref> or Fn typically are not recognizable themselves as keys, and Minecraft and all other computer programs will be oblivious to them in isolation.

	Only mouse buttons can have controls be bound to them in the options menu. Mouse movement, vertical scrolling and horizontal scrolling are hardcoded, and their default actions cannot be assigned to other keys or buttons, nor can scrolling or moving the mouse be made to do anything else.		Only mouse buttons can have controls be bound to them in the options menu. Mouse movement, vertical scrolling and horizontal scrolling are hardcoded, and their default actions cannot be assigned to other keys or buttons, nor can scrolling or moving the mouse be made to do anything else.
Line 25:		Line 25:
	! {{code\|key.keyboard.unknown}}		! {{code\|key.keyboard.unknown}}
	\| {{btn\|Not Bound}}		\| {{btn\|Not Bound}}
	\| colspan="2" \| Unassigned{{note\|Also used by keys ~~unrecognised~~ by SDL3, see {{bug\|MC-310108}}{{upcoming\|java 26.3}}}}		\| colspan="2" \| Unassigned{{note\|Also used by keys unrecognized by SDL3, see {{bug\|MC-310108}}{{upcoming\|java 26.3}}}}
	\| {{code\|key.keyboard.unknown}}		\| {{code\|key.keyboard.unknown}}
	\|-		\|-
Line 405:		Line 405:
	! {{code\|key.keyboard.f25}}{{until\|java 26.3}}		! {{code\|key.keyboard.f25}}{{until\|java 26.3}}
	\| {{btn\|F25}}		\| {{btn\|F25}}
	\| colspan="2" \| Unclear{{note\|Ostensibly for a twenty-fifth function key, but Windows, Linux and presumably macOS only ~~recognise~~ up to F24. Some keyboards from decades past go past F24, and Arch Linux can apparently ~~recognise~~ up to F246, however it is unknown if Minecraft would ~~recognise~~ either of these.}}		\| colspan="2" \| Unclear{{note\|Ostensibly for a twenty-fifth function key, but Windows, Linux and presumably macOS only recognize up to F24. Some keyboards from decades past go past F24, and Arch Linux can apparently recognize up to F246, however it is unknown if Minecraft would recognize either of these.}}
	\| {{code\|key.keyboard.f25}}		\| {{code\|key.keyboard.f25}}
	\|-		\|-
Line 757:		Line 757:
	! {{code\|key.keyboard.alternate.erase}}{{upcoming\|java 26.3}}		! {{code\|key.keyboard.alternate.erase}}{{upcoming\|java 26.3}}
	\| {{btn\|Alternate Erase}}		\| {{btn\|Alternate Erase}}
	\| colspan="2" \| {{note\|Not ~~recognised~~ for some reason: {{bug\|MC-311320}}}}		\| colspan="2" \| {{note\|Not recognized for some reason: {{bug\|MC-311320}}}}
	\| {{code\|key.keyboard.alternate.erase}}		\| {{code\|key.keyboard.alternate.erase}}
	\|-		\|-
Line 2,740:		Line 2,740:
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|java classic}}		\|{{HistoryLine\|java classic}}
	\|{{HistoryLine\|\|0.0.23a\|Controls can now be customized. Only keyboard buttons are ~~recognised~~ as valid for rebinding.}}		\|{{HistoryLine\|\|0.0.23a\|Controls can now be customized. Only keyboard buttons are recognized as valid for rebinding.}}
	\|{{HistoryLine\|java beta}}		\|{{HistoryLine\|java beta}}
	\|{{HistoryLine\|\|1.8\|dev=Pre-release\|Controls can now be bound to mouse buttons; these are handled using negative numbers.}}		\|{{HistoryLine\|\|1.8\|dev=Pre-release\|Controls can now be bound to mouse buttons; these are handled using negative numbers.}}
Line 2,769:		Line 2,769:
	\|Certain keys, such as keypad plus-or-minus, keypad opening bracket and keypad closing bracket, now display the character they represent, despite not being defined key codes in the game.<ref>{{bug\|MC-310109}}, {{bug\|MC-310110}}</ref>		\|Certain keys, such as keypad plus-or-minus, keypad opening bracket and keypad closing bracket, now display the character they represent, despite not being defined key codes in the game.<ref>{{bug\|MC-310109}}, {{bug\|MC-310110}}</ref>
	\|The game now uses SDL3.		\|The game now uses SDL3.
	\|The international backslash key is now ~~recognised~~ as {{code\|key.keyboard.world.1}} on Windows, rather than {{code\|key.keyboard.world.2}}.		\|The international backslash key is now recognized as {{code\|key.keyboard.world.1}} on Windows, rather than {{code\|key.keyboard.world.2}}.
	\|{{code\|key.keyboard.keypad.decimal}} can no longer be assigned.		\|{{code\|key.keyboard.keypad.decimal}} can no longer be assigned.
	\|{{code\|key.keyboard.menu}} is now assigned with {{key\|Compose}} instead of {{key\|Menu}}.}}		\|{{code\|key.keyboard.menu}} is now assigned with {{key\|Compose}} instead of {{key\|Menu}}.}}

← Older revision		Revision as of 11:09, 7 September 2026
Line 12:		Line 12:

	=== Keyboard codes ===		=== Keyboard codes ===
			{{info needed section\|Instead of bug reports, it may be better to cite https://github.com/libsdl-org/SDL/pull/16239 for some unintuitive Linux mappings}}
	Keyboard buttons are handled as a signed 32-bit integer, meaning that through editing options.txt, values from {{code\|key.keyboard.-2147483648}} to {{code\|key.keyboard.2147483647}} can be specified without being rejected by the game as invalid. Any keys corresponding to a valid [[Minecraft:SDL3 scancodes\|SDL key code]] will be automatically converted to one of the named keys below.		Keyboard buttons are handled as a signed 32-bit integer, meaning that through editing options.txt, values from {{code\|key.keyboard.-2147483648}} to {{code\|key.keyboard.2147483647}} can be specified without being rejected by the game as invalid. Any keys corresponding to a valid [[Minecraft:SDL3 scancodes\|SDL key code]] will be automatically converted to one of the named keys below.

Line 691:		Line 692:
	\| {{code\|key.keyboard.right.meta}}{{upcoming\|java 26.3}}		\| {{code\|key.keyboard.right.meta}}{{upcoming\|java 26.3}}
	\|-		\|-
	! {{code\|key.keyboard.lang1}}{{upcoming\|java 26.3}}<ref name="genericintl">Mojang have chosen to assign generic, non-descriptive titles to these keys, matching their internal SDL3 IDs rather than the actual real-life key names: {{bug\|MC-311175}}</ref>		! rowspan="2" \| {{code\|key.keyboard.lang1}}{{upcoming\|java 26.3}}<ref name="genericintl">Mojang have chosen to assign generic, non-descriptive titles to these keys, matching their internal SDL3 IDs rather than the actual real-life key names: {{bug\|MC-311175}}</ref>
	\| {{btn\|Language 1}}<ref name="genericintl"/>		\| rowspan="2" \| {{btn\|Language 1}}<ref name="genericintl"/>
	\| ~~colspan="2"~~ \| {{key\|~~Hangul~~}}		\| Windows/Linux
	\| {{code\|key.keyboard.lang1}}<ref name="genericintl"/>		\| {{key\|Hangeul}}
			\| rowspan="2" \| {{code\|key.keyboard.lang1}}<ref name="genericintl"/>
	\|-		\|-
	! {{code\|key.keyboard.lang2}}{{upcoming\|java 26.3}}<ref name="genericintl"/>		\| macOS
	\| {{btn\|Language 2}}<ref name="genericintl"/>		\| {{key\|Kana}}
	\| ~~colspan="2"~~ \| {{key\|Hanja}}		\|-
	\| {{code\|key.keyboard.lang2}}<ref name="genericintl"/>		! rowspan="2" \| {{code\|key.keyboard.lang2}}{{upcoming\|java 26.3}}<ref name="genericintl"/>
			\| rowspan="2" \| {{btn\|Language 2}}<ref name="genericintl"/>
			\| Windows/Linux
			\| {{key\|Hanja}}
			\| rowspan="2" \| {{code\|key.keyboard.lang2}}<ref name="genericintl"/>
			\|-
			\| macOS
			\| {{key\|Eisu}}
	\|-		\|-
	! {{code\|key.keyboard.lang3}}{{upcoming\|java 26.3}}<ref name="genericintl"/>		! {{code\|key.keyboard.lang3}}{{upcoming\|java 26.3}}<ref name="genericintl"/>
Line 958:		Line 967:

	==== Unused ====		==== Unused ====
			{{info needed section\|on Linux, SysRq, Channel Up, Channel Down, Mode, Select and Clear should be usable - move at least some to above table and cite bug reports explaining why they aren't, maybe making a new one for the first beforehand}}
	Minecraft includes IDs and translation strings for all named SDL3 key IDs, even those which are not present in the key binding files for any supported operating system, and therefore cannot be accessed.		Minecraft includes IDs and translation strings for all named SDL3 key IDs, even those which are not present in the key binding files for any supported operating system, and therefore cannot be accessed.

Line 1,677:		Line 1,687:
	! {{code\|21}}		! {{code\|21}}
	\| {{btn\|Button21\|be=1}}		\| {{btn\|Button21\|be=1}}
	\| {{key\|~~IME~~ Kana}}{{~~info needed\|Is this the hiragana-katakana toggle?~~}} / {{key\|~~Hangul~~}}		\| {{key\|Kana}}{{verify}} / {{key\|Hangeul}}
	\|		\|
	\|-		\|-
Line 1,697:		Line 1,707:
	! {{code\|25}}		! {{code\|25}}
	\| {{btn\|Button25\|be=1}}		\| {{btn\|Button25\|be=1}}
	\| {{key\|Hanja}} / {{key\|~~IME Kanji~~}}		\| {{key\|Hanja}} / {{key\|Eisu}}{{verify}}
	\|		\|
	\|-		\|-