Minecraft:Key codes: Difference between revisions
From SAS Gaming Wiki
More actions
Sync: updated from Minecraft |
Sync: updated from Minecraft |
||
| (9 intermediate revisions by the same user not shown) | |||
| 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. | |||
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. | ||
| Line 404: | Line 406: | ||
| {{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 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.}} | ||
| {{code|key.keyboard.f25 | | {{code|key.keyboard.f25}} | ||
|- | |- | ||
! {{code|key.keyboard.keypad.0}} | ! {{code|key.keyboard.keypad.0}} | ||
| Line 518: | Line 520: | ||
! {{code|key.keyboard.menu}} | ! {{code|key.keyboard.menu}} | ||
| {{btn|Menu}} | | {{btn|Menu}} | ||
| colspan="2" | {{key|Menu}}{{until|java 26.3}} | | colspan="2" | {{key|Menu}}{{until|java 26.3}}<br>{{key|Compose}}{{upcoming|je 26.3}} | ||
| {{code|key.keyboard.menu}} | | {{code|key.keyboard.menu}} | ||
|- | |- | ||
| Line 690: | 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"> | ! 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"/> | ||
| | | Windows/Linux | ||
| {{code|key.keyboard. | | {{key|Hangeul}} | ||
| rowspan="2" | {{code|key.keyboard.lang1}}<ref name="genericintl"/> | |||
|- | |||
| macOS | |||
| {{key|Kana}} | |||
|- | |||
! 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 712: | Line 722: | ||
! {{code|key.keyboard.lang5}}{{upcoming|java 26.3}}<ref name="genericintl"/> | ! {{code|key.keyboard.lang5}}{{upcoming|java 26.3}}<ref name="genericintl"/> | ||
| {{btn|Language 5}}<ref name="genericintl"/> | | {{btn|Language 5}}<ref name="genericintl"/> | ||
| colspan="2" | {{key| | | colspan="2" | {{key|Zenkaku/Hankaku}}{{note|May not work correctly on Linux: {{bug|MC-310984}}}} | ||
| {{code|key.keyboard.lang5}}<ref name="genericintl"/> | | {{code|key.keyboard.lang5}}<ref name="genericintl"/> | ||
|- | |- | ||
| Line 739: | Line 749: | ||
| colspan="2" | {{key|Muhenkan}} | | colspan="2" | {{key|Muhenkan}} | ||
| {{code|key.keyboard.international5}}<ref name="genericintl"/> | | {{code|key.keyboard.international5}}<ref name="genericintl"/> | ||
|- | |||
! {{code|key.keyboard.international6}}{{upcoming|java 26.3}}<ref name="generic9800">{{bug|MC-311184}}</ref> | |||
| {{btn|International 6}}<ref name="generic9800"/> | |||
| colspan="2" | {{key|Numpad ,}} (PC-9800){{note|Windows only; it is assumed that KEY_KPJPCOMMA is meant to represent this on Linux, but is incorrectly bound to International 5 - see https://github.com/libsdl-org/SDL/pull/16168}} | |||
| {{code|key.keyboard.international6}}<ref name="generic9800"/> | |||
|- | |||
! {{code|key.keyboard.alternate.erase}}{{upcoming|java 26.3}} | |||
| {{btn|Alternate Erase}} | |||
| colspan="2" | {{note|Not recognised for some reason: {{bug|MC-311320}}}} | |||
| {{code|key.keyboard.alternate.erase}} | |||
|- | |- | ||
! {{code|key.keyboard.mute}}{{upcoming|java 26.3}} | ! {{code|key.keyboard.mute}}{{upcoming|java 26.3}} | ||
| Line 759: | Line 779: | ||
| colspan="2" | {{key|Media Play Pause}} | | colspan="2" | {{key|Media Play Pause}} | ||
| {{code|key.keyboard.media.play.pause}} | | {{code|key.keyboard.media.play.pause}} | ||
|- | |||
! {{code|key.keyboard.media.play}}{{upcoming|java 26.3}} | |||
| {{btn|Media Play}} | |||
| colspan="2" | {{key|Media Play}} | |||
| {{code|key.keyboard.media.play}} | |||
|- | |||
! {{code|key.keyboard.media.pause}}{{upcoming|java 26.3}} | |||
| {{btn|Media Pause}} | |||
| colspan="2" | {{key|Media Pause}} | |||
| {{code|key.keyboard.media.pause}} | |||
|- | |||
! {{code|key.keyboard.media.record}}{{upcoming|java 26.3}} | |||
| {{btn|Record}} | |||
| colspan="2" | {{key|Media Record}} | |||
| {{code|key.keyboard.media.record}} | |||
|- | |||
! {{code|key.keyboard.media.fast.forward}}{{upcoming|java 26.3}} | |||
| {{btn|Fast Forward}} | |||
| colspan="2" | {{key|Media Fast Forward}} | |||
| {{code|key.keyboard.media.fast.forward}} | |||
|- | |||
! {{code|key.keyboard.media.rewind}}{{upcoming|java 26.3}} | |||
| {{btn|Rewind}} | |||
| colspan="2" | {{key|Media Rewind}} | |||
| {{code|key.keyboard.media.rewind}} | |||
|- | |||
! {{code|key.keyboard.media.next.track}}{{upcoming|java 26.3}} | |||
| {{btn|Next Track}} | |||
| colspan="2" | {{key|Media Next Track}} | |||
| {{code|key.keyboard.media.next.track}} | |||
|- | |||
! {{code|key.keyboard.media.previous.track}}{{upcoming|java 26.3}} | |||
| {{btn|Previous Track}} | |||
| colspan="2" | {{key|Media Previous Track}} | |||
| {{code|key.keyboard.media.previous.track}} | |||
|- | |||
! {{code|key.keyboard.media.stop}}{{upcoming|java 26.3}} | |||
| {{btn|Media Stop}} | |||
| colspan="2" | {{key|Media Stop}} | |||
| {{code|key.keyboard.media.stop}} | |||
|- | |||
! {{code|key.keyboard.media.eject}}{{upcoming|java 26.3}} | |||
| {{btn|Eject}} | |||
| colspan="2" | {{key|Media Eject}} | |||
| {{code|key.keyboard.media.eject}} | |||
|- | |||
! {{code|key.keyboard.media.select}}{{upcoming|java 26.3}} | |||
| {{btn|Media Select}} | |||
| colspan="2" | {{key|Media Select}} | |||
| {{code|key.keyboard.media.select}} | |||
|- | |- | ||
! {{code|key.keyboard.stop}}{{upcoming|java 26.3}} | ! {{code|key.keyboard.stop}}{{upcoming|java 26.3}} | ||
| Line 764: | Line 834: | ||
| colspan="2" | {{key|Stop}} | | colspan="2" | {{key|Stop}} | ||
| {{code|key.keyboard.stop}} | | {{code|key.keyboard.stop}} | ||
|- | |||
! {{code|key.keyboard.cancel}}{{upcoming|java 26.3}} | |||
| {{btn|Cancel}} | |||
| colspan="2" | {{key|Cancel}} | |||
| {{code|key.keyboard.cancel}} | |||
|- | |- | ||
! {{code|key.keyboard.cut}}{{upcoming|java 26.3}} | ! {{code|key.keyboard.cut}}{{upcoming|java 26.3}} | ||
| Line 794: | Line 869: | ||
| colspan="2" | {{key|Application New}} | | colspan="2" | {{key|Application New}} | ||
| {{code|key.keyboard.ac.new}} | | {{code|key.keyboard.ac.new}} | ||
|- | |||
! {{code|key.keyboard.ac.open}}{{upcoming|java 26.3}} | |||
| {{btn|AC Open}} | |||
| colspan="2" | {{key|Application Open}} | |||
| {{code|key.keyboard.ac.open}} | |||
|- | |- | ||
! {{code|key.keyboard.ac.save}}{{upcoming|java 26.3}} | ! {{code|key.keyboard.ac.save}}{{upcoming|java 26.3}} | ||
| Line 809: | Line 889: | ||
| colspan="2" | {{key|Find}} | | colspan="2" | {{key|Find}} | ||
| {{code|key.keyboard.find}} | | {{code|key.keyboard.find}} | ||
|- | |||
! {{code|key.keyboard.ac.close}}{{upcoming|java 26.3}} | |||
| {{btn|AC Close}} | |||
| colspan="2" | {{key|Application Close}} | |||
| {{code|key.keyboard.ac.close}} | |||
|- | |||
! {{code|key.keyboard.ac.exit}}{{upcoming|java 26.3}} | |||
| {{btn|AC Exit}} | |||
| colspan="2" | {{key|Application Exit}} | |||
| {{code|key.keyboard.ac.exit}} | |||
|- | |||
! {{code|key.keyboard.ac.stop}}{{upcoming|java 26.3}} | |||
| {{btn|AC Stop}} | |||
| colspan="2" | {{key|Application Stop}} | |||
| {{code|key.keyboard.ac.stop}} | |||
|- | |||
! {{code|key.keyboard.ac.properties}}{{upcoming|java 26.3}} | |||
| {{btn|AC Properties}} | |||
| colspan="2" | {{key|Application Properties}} | |||
| {{code|key.keyboard.ac.properties}} | |||
|- | |||
! {{code|key.keyboard.ac.search}}{{upcoming|java 26.3}} | |||
| {{btn|AC Search}} | |||
| colspan="2" | {{key|Application Search}} | |||
| {{code|key.keyboard.ac.search}} | |||
|- | |||
! {{code|key.keyboard.ac.home}}{{upcoming|java 26.3}} | |||
| {{btn|AC Home}} | |||
| colspan="2" | {{key|Application Home}} | |||
| {{code|key.keyboard.ac.home}} | |||
|- | |||
! {{code|key.keyboard.ac.back}}{{upcoming|java 26.3}} | |||
| {{btn|AC Back}} | |||
| colspan="2" | {{key|Application Back}} | |||
| {{code|key.keyboard.ac.back}} | |||
|- | |||
! {{code|key.keyboard.ac.forward}}{{upcoming|java 26.3}} | |||
| {{btn|AC Forward}} | |||
| colspan="2" | {{key|Application Forward}} | |||
| {{code|key.keyboard.ac.forward}} | |||
|- | |||
! {{code|key.keyboard.ac.refresh}}{{upcoming|java 26.3}} | |||
| {{btn|AC Refresh}} | |||
| colspan="2" | {{key|Application Refresh}} | |||
| {{code|key.keyboard.ac.refresh}} | |||
|- | |||
! {{code|key.keyboard.ac.bookmarks}}{{upcoming|java 26.3}} | |||
| {{btn|AC Favorites}} | |||
| colspan="2" | {{key|Application Bookmarks}} | |||
| {{code|key.keyboard.ac.bookmarks}} | |||
|- | |||
! {{code|key.keyboard.power}}{{upcoming|java 26.3}} | |||
| {{btn|Power}} | |||
| colspan="2" | {{key|Power}} | |||
| {{code|key.keyboard.power}} | |||
|- | |||
! {{code|key.keyboard.sleep}}{{upcoming|java 26.3}} | |||
| {{btn|Sleep}} | |||
| colspan="2" | {{key|Sleep}} | |||
| {{code|key.keyboard.sleep}} | |||
|- | |||
! {{code|key.keyboard.wake}}{{upcoming|java 26.3}} | |||
| {{btn|Wake}} | |||
| colspan="2" | {{key|Wake}} | |||
| {{code|key.keyboard.wake}} | |||
|- | |- | ||
! {{code|scancode.{{note|name="oldkeynumberid"|Two or three digit number representing operating system key ID}}}}{{until|java 26.3}} | ! {{code|scancode.{{note|name="oldkeynumberid"|Two or three digit number representing operating system key ID}}}}{{until|java 26.3}} | ||
| Line 815: | Line 960: | ||
| {{code|scancode.{{note|name="oldkeynumberid"}}}} | | {{code|scancode.{{note|name="oldkeynumberid"}}}} | ||
|- | |- | ||
! {{code|key.keyboard.{{note|name="newkeynumberid"|Three digit number representing SDL3 key ID}}}}{{upcoming|java 26.3}}{{more info| | ! {{code|key.keyboard.{{note|name="newkeynumberid"|Three digit number representing SDL3 key ID}}}}{{upcoming|java 26.3}}{{more info|confirm whether key numbers undefined by SDL3 use this still}} | ||
| {{btn|key.keyboard.}}{{note|name="newkeynumberid"}} | | {{btn|key.keyboard.}}{{note|name="newkeynumberid"}} | ||
| colspan="2" | Keys with no assigned ID | | colspan="2" | Keys with no assigned ID | ||
| Line 821: | Line 966: | ||
|} | |} | ||
==== | ==== 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. | |||
SDL3 | |||
These can be set via modifying {{code|[[Minecraft:options.txt]]}} manually, but will not be triggerable due to the lack of an associated key. | |||
Keys such as World 2, Keypad Decimal and Escape may warrant inclusion here later.{{upcoming|java 26.3}} | |||
{| class="wikitable sortable" data-description="IDs of unused keys" style="margin-left:auto; margin-right:auto; text-align: center" | |||
{| class="wikitable sortable" data-description=" | ! ID{{note|The translation string is assumed to match unless stated otherwise.}} | ||
! Displayed name | ! Displayed name | ||
! | ! Notes | ||
|- | |- | ||
! {{code|key.keyboard.ac.print}} | |||
| {{ | | {{btn|AC Print}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.call}} | |||
| {{ | | {{btn|Call}} | ||
| | | This is a mobile phone button.<ref name="SDLmasterlist">https://wiki.libsdl.org/SDL3/SDL_Scancode</ref> | ||
|- | |- | ||
! {{code|key.keyboard.channel.down}} | |||
| {{ | | {{btn|Channel Down}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.channel.up}} | |||
| {{ | | {{btn|Channel Up}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.clear}} | |||
| {{ | | {{btn|Clear}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.clear.again}} | |||
| {{ | | {{btn|Clear Again}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.crsel}} | |||
| {{ | | {{btn|CrSel}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.currency.subunit}} | |||
| {{ | | {{btn|Currency Subunit}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.currency.unit}} | |||
| {{ | | {{btn|Currency Unit}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.decimal.separator}} | |||
| {{ | | {{btn|Decimal Separator}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.end.call}} | |||
| {{ | | {{btn|End Call}} | ||
| | | This is a mobile phone button.<ref name="SDLmasterlist"/> | ||
|- | |- | ||
! {{code|key.keyboard.enter2}} | |||
| {{ | | {{btn|Enter 2}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.execute}} | |||
| {{ | | {{btn|Execute}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.exsel}} | |||
| {{ | | {{btn|ExSel}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.international7}} | |||
| {{ | | {{btn|International 7}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.international8}} | |||
| {{ | | {{btn|International 8}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.international9}} | |||
| {{ | | {{btn|International 9}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.keypad.00}} | |||
| {{ | | {{btn|Keypad 00}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.keypad.000}} | |||
| {{ | | {{btn|Keypad 000}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.keypad.a}} | |||
| {{ | | {{btn|Keypad A}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.keypad.ampersand}} | |||
| {{ | | {{btn|Keypad &}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.keypad.at}} | |||
| {{ | | {{btn|Keypad @}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.keypad.b}} | |||
| {{ | | {{btn|Keypad B}} | ||
| | | | ||
|- | |- | ||
! {{code|key.keyboard.keypad.backspace}} | |||
| {{btn|Keypad Backspace}} | |||
| | |||
|- | |- | ||
! | ! {{code|key.keyboard.keypad.binary}} | ||
| {{btn|Keypad Binary}} | |||
| | |||
|- | |- | ||
! {{code|key. | ! {{code|key.keyboard.keypad.c}} | ||
| {{btn| | | {{btn|Keypad C}} | ||
| | | | ||
! {{ | |- | ||
! {{code|key.keyboard.keypad.clear}} | |||
| {{btn|Keypad Clear}} | |||
| | |||
|- | |- | ||
! {{code|key. | ! {{code|key.keyboard.keypad.clear.entry}} | ||
| {{btn| | | {{btn|Keypad Clear Entry}} | ||
| | | | ||
|- | |- | ||
! {{code|key. | ! {{code|key.keyboard.keypad.colon}} | ||
| {{btn| | | {{btn|Keypad :}} | ||
| | |||
|- | |- | ||
! {{code|key. | ! {{code|key.keyboard.keypad.d}} | ||
| {{btn| | | {{btn|Keypad D}} | ||
| | |||
|- | |- | ||
! {{code|key. | ! {{code|key.keyboard.keypad.double.ampersand}} | ||
| {{btn| | | {{btn|Keypad &&}} | ||
| | | | ||
|- | |- | ||
! {{code|key.mouse.6}} | ! {{code|key.keyboard.keypad.double.vertical.bar}} | ||
| {{btn|Button 6}} | | {{btn|Keypad <nowiki>||</nowiki>}} | ||
| {{mouse|sixth}} | | | ||
! {{tc|No}} | |- | ||
! {{tc|Yes}} | ! {{code|key.keyboard.keypad.e}} | ||
! {{tc|Yes}} | | {{btn|Keypad E}} | ||
|- | | | ||
! {{code|key.mouse.7}} | |- | ||
| {{btn|Button 7}} | ! {{code|key.keyboard.keypad.equals.as400}} | ||
| {{mouse|seventh}} | | {{btn|Keypad {{=}} (AS400)}} | ||
! {{tc|No}} | | | ||
! {{tc|Yes}} | |- | ||
! {{tc|Yes}} | ! {{code|key.keyboard.keypad.exclamation}} | ||
|- | | {{btn|Keypad !}} | ||
! {{code|key.mouse.8}} | | | ||
| {{btn|Button 8}} | |- | ||
| {{mouse|eighth}} | ! {{code|key.keyboard.keypad.f}} | ||
! {{tc|No}} | | {{btn|Keypad F}} | ||
! {{tc|Yes}} | | | ||
! {{tc|Yes}} | |- | ||
|- | ! {{code|key.keyboard.keypad.greater}} | ||
! {{code|key.mouse.9}} | | {{btn|Keypad >}} | ||
| {{btn|Button 9}} | | | ||
| {{mouse|ninth}} | |- | ||
! {{tc|No}} | ! {{code|key.keyboard.keypad.hash}} | ||
! {{tc|Yes}}{{upcoming|java 26.3}} | | {{btn|Keypad #}} | ||
! {{tc|Yes}}{{upcoming|java 26.3}} | | | ||
|- | |- | ||
! {{code|key.mouse.10}} | ! {{code|key.keyboard.keypad.hexadecimal}} | ||
| {{btn|Button 10}} | | {{btn|Keypad Hexadecimal}} | ||
| {{mouse|tenth}} | | | ||
! {{tc|No}} | |- | ||
! {{tc|Yes}}{{upcoming|java 26.3}} | ! {{code|key.keyboard.keypad.left.brace}} | ||
! {{tc|Yes}}{{upcoming|java 26.3}} | | {{btn|Keypad {}} | ||
|- | | | ||
! {{code|key.mouse.11}} | |- | ||
| {{btn|Button 11}} | ! {{code|key.keyboard.keypad.less}} | ||
| {{mouse|eleventh}} | | {{btn|Keypad <}} | ||
! {{tc|No}} | | | ||
! {{tc|Yes}}{{upcoming|java 26.3}} | |- | ||
! {{tc|Yes}}{{upcoming|java 26.3}} | ! {{code|key.keyboard.keypad.memory.add}} | ||
|- | | {{btn|Keypad M+}} | ||
! {{code|key.mouse.12}} | | | ||
| {{btn|Button 12}} | |- | ||
! {{code|key.keyboard.keypad.memory.clear}} | |||
| {{btn|Keypad MC}} | |||
| | |||
|- | |||
! {{code|key.keyboard.keypad.memory.divide}} | |||
| {{btn|Keypad M/}} | |||
| | |||
|- | |||
! {{code|key.keyboard.keypad.memory.multiply}} | |||
| {{btn|Keypad M*}} | |||
| | |||
|- | |||
! {{code|key.keyboard.keypad.memory.recall}} | |||
| {{btn|Keypad MR}} | |||
| | |||
|- | |||
! {{code|key.keyboard.keypad.memory.store}} | |||
| {{btn|Keypad MS}} | |||
| | |||
|- | |||
! {{code|key.keyboard.keypad.memory.subtract}} | |||
| {{btn|Keypad M-}} | |||
| | |||
|- | |||
! {{code|key.keyboard.keypad.octal}} | |||
| {{btn|Keypad Octal}} | |||
| | |||
|- | |||
! {{code|key.keyboard.keypad.percent}} | |||
| {{btn|Keypad %}} | |||
| | |||
|- | |||
! {{code|key.keyboard.keypad.power}} | |||
| {{btn|Keypad ^}} | |||
| | |||
|- | |||
! {{code|key.keyboard.keypad.right.brace}} | |||
| {{btn|Keypad <nowiki>}</nowiki>}} | |||
| | |||
|- | |||
! {{code|key.keyboard.keypad.space}} | |||
| {{btn|Keypad Space}} | |||
| | |||
|- | |||
! {{code|key.keyboard.keypad.tab}} | |||
| {{btn|Keypad Tab}} | |||
| | |||
|- | |||
! {{code|key.keyboard.keypad.vertical.bar}} | |||
| {{btn|Keypad <nowiki>|</nowiki>}} | |||
| | |||
|- | |||
! {{code|key.keyboard.keypad.xor}} | |||
| {{btn|Keypad XOR}} | |||
| | |||
|- | |||
! {{code|key.keyboard.lang6}} | |||
| {{btn|Language 6}} | |||
| | |||
|- | |||
! {{code|key.keyboard.lang7}} | |||
| {{btn|Language 7}} | |||
| | |||
|- | |||
! {{code|key.keyboard.lang8}} | |||
| {{btn|Language 8}} | |||
| | |||
|- | |||
! {{code|key.keyboard.lang9}} | |||
| {{btn|Language 9}} | |||
| | |||
|- | |||
! {{code|key.keyboard.mode}} | |||
| {{btn|Mode}} | |||
| Accidentally assignable in Linux.<ref>{{bug|MC-310984}}</ref> | |||
|- | |||
! {{code|key.keyboard.oper}} | |||
| {{btn|Oper}} | |||
| | |||
|- | |||
! {{code|key.keyboard.out}} | |||
| {{btn|Out}} | |||
| | |||
|- | |||
! {{code|key.keyboard.prior}} | |||
| {{btn|Prior}} | |||
| | |||
|- | |||
! {{code|key.keyboard.select}} | |||
| {{btn|Select}} | |||
| | |||
|- | |||
! {{code|key.keyboard.separator}} | |||
| {{btn|Separator}} | |||
| | |||
|- | |||
! {{code|key.keyboard.soft.left}} | |||
| {{btn|Soft Left}} | |||
| This is a mobile phone button.<ref name="SDLmasterlist"/> | |||
|- | |||
! {{code|key.keyboard.soft.right}} | |||
| {{btn|Soft Right}} | |||
| This is a mobile phone button.<ref name="SDLmasterlist"/> | |||
|- | |||
! {{code|key.keyboard.sys.req}} | |||
| {{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}}}} | |||
| | |||
|- | |||
! {{code|key.keyboard.thousands.separator}} | |||
| {{btn|Thousands Separator}} | |||
| | |||
|} | |||
=== Mouse codes === | |||
Mouse buttons are handled as a signed 32-bit integer, meaning that through editing options.txt, values from {{code|key.mouse.-2147483648}} to {{code|key.mouse.2147483647}} can be specified without being rejected by the game as invalid.<ref>{{bug|MC-268286}}</ref> However, the USB HID specification only permits mouse buttons from 1 to 65535,<ref>https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf</ref> meaning that all negative values and the vast majority of the positive values can never actually be assigned to in-game actions without file editing. | |||
Only the first eight mouse buttons can have controls assigned to them.{{until|java 26.3}} | |||
On Linux, mouse buttons up to 48{{upcoming|java 26.3}} can be specified (evdev key press events 272 to 319) - it is not known if any supported operating systems support a 49th or higher mouse button as input. The maximum mouse button on macOS is 32,<ref>according to what karabiner-elements allows: https://discord.com/channels/647810384031645728/648555495564509184/1528136787434930358</ref> and the maximum mouse button on Windows is 5. | |||
For the first three mouse buttons, the translation keys match the key IDs; all other buttons follow a generic template. | |||
{| class="wikitable" data-description="Mouse button IDs" style="margin-left:auto; margin-right:auto; text-align:center" | |||
! rowspan="2" | ID | |||
! rowspan="2" | Displayed name | |||
! rowspan="2" | Description | |||
! colspan="3" | Usable on | |||
|- | |||
! Windows | |||
! macOS | |||
! Linux | |||
|- | |||
! {{code|key.mouse.left}}{{note|{{code|key.mouse.1}} is automatically converted to this{{info needed|I assume upon reading options.txt when the game is started? or at another time?}}}} | |||
| {{btn|Left Button}} | |||
| {{mouse|left}} | |||
! {{tc|Yes}} | |||
! {{tc|Yes}} | |||
! {{tc|Yes}} | |||
|- | |||
! {{code|key.mouse.right}}{{note|{{code|key.mouse.3}} is automatically converted to this}} | |||
| {{btn|Right Button}} | |||
| {{mouse|right}} | |||
! {{tc|Yes}} | |||
! {{tc|Yes}} | |||
! {{tc|Yes}} | |||
|- | |||
! {{code|key.mouse.middle}}{{note|{{code|key.mouse.2}} is automatically converted to this}} | |||
| {{btn|Middle Button}} | |||
| {{mouse|middle}} | |||
! {{tc|Yes}} | |||
! {{tc|Yes}} | |||
! {{tc|Yes}} | |||
|- | |||
! {{code|key.mouse.4}} | |||
| {{btn|Button 4}} | |||
| {{mouse|fourth}} | |||
! {{tc|Yes}} | |||
! {{tc|Yes}} | |||
! {{tc|Yes}} | |||
|- | |||
! {{code|key.mouse.5}} | |||
| {{btn|Button 5}} | |||
| {{mouse|fifth}} | |||
! {{tc|Yes}} | |||
! {{tc|Yes}} | |||
! {{tc|Yes}} | |||
|- | |||
! {{code|key.mouse.6}} | |||
| {{btn|Button 6}} | |||
| {{mouse|sixth}} | |||
! {{tc|No}} | |||
! {{tc|Yes}} | |||
! {{tc|Yes}} | |||
|- | |||
! {{code|key.mouse.7}} | |||
| {{btn|Button 7}} | |||
| {{mouse|seventh}} | |||
! {{tc|No}} | |||
! {{tc|Yes}} | |||
! {{tc|Yes}} | |||
|- | |||
! {{code|key.mouse.8}} | |||
| {{btn|Button 8}} | |||
| {{mouse|eighth}} | |||
! {{tc|No}} | |||
! {{tc|Yes}} | |||
! {{tc|Yes}} | |||
|- | |||
! {{code|key.mouse.9}} | |||
| {{btn|Button 9}} | |||
| {{mouse|ninth}} | |||
! {{tc|No}} | |||
! {{tc|Yes}}{{upcoming|java 26.3}} | |||
! {{tc|Yes}}{{upcoming|java 26.3}} | |||
|- | |||
! {{code|key.mouse.10}} | |||
| {{btn|Button 10}} | |||
| {{mouse|tenth}} | |||
! {{tc|No}} | |||
! {{tc|Yes}}{{upcoming|java 26.3}} | |||
! {{tc|Yes}}{{upcoming|java 26.3}} | |||
|- | |||
! {{code|key.mouse.11}} | |||
| {{btn|Button 11}} | |||
| {{mouse|eleventh}} | |||
! {{tc|No}} | |||
! {{tc|Yes}}{{upcoming|java 26.3}} | |||
! {{tc|Yes}}{{upcoming|java 26.3}} | |||
|- | |||
! {{code|key.mouse.12}} | |||
| {{btn|Button 12}} | |||
| {{mouse|twelfth}} | | {{mouse|twelfth}} | ||
! {{tc|No}} | ! {{tc|No}} | ||
| Line 1,330: | Line 1,657: | ||
! {{code|13}} | ! {{code|13}} | ||
| {{btn|RETURN|be=1}} | | {{btn|RETURN|be=1}} | ||
| {{key| | | {{key|Return}} | ||
| {{code|keyboard.keyName.return}} | | {{code|keyboard.keyName.return}} | ||
|- | |- | ||
| Line 1,360: | Line 1,687: | ||
! {{code|21}} | ! {{code|21}} | ||
| {{btn|Button21|be=1}} | | {{btn|Button21|be=1}} | ||
| {{key| | | {{key|Kana}}{{verify}} / {{key|Hangeul}} | ||
| | | | ||
|- | |- | ||
| Line 1,380: | Line 1,707: | ||
! {{code|25}} | ! {{code|25}} | ||
| {{btn|Button25|be=1}} | | {{btn|Button25|be=1}} | ||
| {{key|Hanja}} / {{key| | | {{key|Hanja}} / {{key|Eisu}}{{verify}} | ||
| | | | ||
|- | |- | ||
| Line 1,930: | Line 2,257: | ||
! {{code|166}} | ! {{code|166}} | ||
| {{btn|Button166|be=1}} | | {{btn|Button166|be=1}} | ||
| {{key| | | {{key|Application Back}} | ||
| | | | ||
|- | |- | ||
! {{code|167}} | ! {{code|167}} | ||
| {{btn|Button167|be=1}} | | {{btn|Button167|be=1}} | ||
| {{key| | | {{key|Application Forward}} | ||
| | | | ||
|- | |- | ||
! {{code|168}} | ! {{code|168}} | ||
| {{btn|Button168|be=1}} | | {{btn|Button168|be=1}} | ||
| {{key| | | {{key|Application Refresh}} | ||
| | | | ||
|- | |- | ||
! {{code|169}} | ! {{code|169}} | ||
| {{btn|Button169|be=1}} | | {{btn|Button169|be=1}} | ||
| {{key| | | {{key|Application Stop}} | ||
| | | | ||
|- | |- | ||
! {{code|170}} | ! {{code|170}} | ||
| {{btn|Button170|be=1}} | | {{btn|Button170|be=1}} | ||
| {{key| | | {{key|Application Search}} | ||
| | | | ||
|- | |- | ||
! {{code|171}} | ! {{code|171}} | ||
| {{btn|Button171|be=1}} | | {{btn|Button171|be=1}} | ||
| {{key| | | {{key|Application Bookmarks}} | ||
| | | | ||
|- | |- | ||
! {{code|172}} | ! {{code|172}} | ||
| {{btn|Button172|be=1}} | | {{btn|Button172|be=1}} | ||
| {{key| | | {{key|Application Home}} | ||
| | | | ||
|- | |- | ||
| Line 2,052: | Line 2,379: | ||
| {{key|`}} | | {{key|`}} | ||
| {{code|keyboard.keyName.grave}} | | {{code|keyboard.keyName.grave}} | ||
|-- | |||
! {{code|194}} | |||
| {{btn|Button193|be=1}} | |||
| {{more info|It's the International 1 key, but I don't know what that is specifically.}} | |||
| | |||
|- | |||
! {{code|194}} | |||
| {{btn|Button194|be=1}} | |||
| {{key|Numpad ,}} | |||
| | |||
|- | |- | ||
! {{code|219}} | ! {{code|219}} | ||
| Line 2,216: | Line 2,553: | ||
| {{btn|Button254|be=1}} | | {{btn|Button254|be=1}} | ||
| {{key|Clear}} | | {{key|Clear}} | ||
| | |||
|- | |||
! {{code|255}} | |||
| {{btn|Button255|be=1}} | |||
| All unknown keys | |||
| | | | ||
|} | |} | ||
| Line 2,408: | Line 2,750: | ||
|Controls that are not bound to anything now display "Not bound". | |Controls that are not bound to anything now display "Not bound". | ||
|The game now uses GLFW. | |The game now uses GLFW. | ||
|Added translation keys for most key codes, which are only displayed for keys GLFW doesn't return a name for.}} | |Added translation keys for most key codes, which are only displayed for keys GLFW doesn't return a name for. | ||
|Keys with no assigned ID are called {{code|scancode.###}} | |||
|Accepted values are -2147483648 to 2147483647,{{verify}} though obviously only a tiny subset are attainable.}} | |||
|{{HistoryLine|||dev=17w45a|Keyboard key codes and their translation keys are now prefixed with {{code|key.keyboard.}}. | |{{HistoryLine|||dev=17w45a|Keyboard key codes and their translation keys are now prefixed with {{code|key.keyboard.}}. | ||
|{{code|key.keyboard.-1}} is now used for controls that are not bound to anything.}} | |{{code|key.keyboard.-1}} is now used for controls that are not bound to anything.}} | ||
| Line 2,420: | Line 2,764: | ||
|{{HistoryLine|java upcoming}} | |{{HistoryLine|java upcoming}} | ||
|{{HistoryLine||26.3|dev=snap4|Valid but undefined key codes have been changed from {{code|scancode.###}} to {{code|key.keyboard.###}}. | |{{HistoryLine||26.3|dev=snap4|Valid but undefined key codes have been changed from {{code|scancode.###}} to {{code|key.keyboard.###}}. | ||
|Removed {{code|key.keyboard.f25}}. | |Removed {{code|key.keyboard.f25}}. Its translation string is purposefully retained in the game files for an unknown reason.<ref>{{bug|MC-311176}}</ref> | ||
|Keypad keys are now prefixed with "Keypad ". | |Keypad keys are now prefixed with "Keypad ". | ||
|Keys are only displayed as the internal name that SDL provides if that name is one character long and uses the translation key otherwise. | |Keys are only displayed as the internal name that SDL provides if that name is one character long and uses the translation key otherwise. | ||
|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 recognised 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.menu}} is now assigned with {{key|Compose}} instead of {{key|Menu}}.}} | |||
|{{HistoryLine|||dev=snap7|Several new translatable key codes have been added: | |{{HistoryLine|||dev=snap7|Several new translatable key codes have been added: | ||
{{collapse|content= | {{collapse|content= | ||
* {{code|key.keyboard.keypad.period}} | * {{code|key.keyboard.99}} → {{code|key.keyboard.keypad.period}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.101}} → {{code|key.keyboard.application}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.117}} → {{code|key.keyboard.help}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.120}} → {{code|key.keyboard.stop}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.121}} → {{code|key.keyboard.again}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.122}} → {{code|key.keyboard.undo}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.123}} → {{code|key.keyboard.cut}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.124}} → {{code|key.keyboard.copy}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.125}} → {{code|key.keyboard.paste}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.126}} → {{code|key.keyboard.find}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.127}} → {{code|key.keyboard.mute}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.128}} → {{code|key.keyboard.volume.up}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.129}} → {{code|key.keyboard.volume.down}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.133}} → {{code|key.keyboard.keypad.comma}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.182}} → {{code|key.keyboard.keypad.left.parenthesis}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.183}} → {{code|key.keyboard.keypad.right.parenthesis}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.215}} → {{code|key.keyboard.keypad.plus.minus}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.271}} → {{code|key.keyboard.media.play.pause}} | ||
* {{code|key.keyboard.new}} | * {{code|key.keyboard.273}} → {{code|key.keyboard.new}} | ||
* {{code|key.keyboard.save}} | * {{code|key.keyboard.277}} → {{code|key.keyboard.save}} | ||
}} | }} | ||
|{{code|key.keyboard.left.alt}}, {{code|key.keyboard.right.alt}}, {{code|key.keyboard.left.win}}, and {{code|key.keyboard.right.win}} now | |{{code|key.keyboard.left.alt}}, {{code|key.keyboard.right.alt}}, {{code|key.keyboard.left.win}}, and {{code|key.keyboard.right.win}} now use different translation keys based on the user's operating system.}} | ||
|{{HistoryLine|||dev=snap9| | |{{HistoryLine|||dev=snap9|IDs and translation strings have been added for all SDL scancodes, regardless of whether or not said keycodes correspond to actual, bindable keyboard buttons: | ||
{{collapse|content= | {{collapse|content= | ||
* {{code|key.keyboard. | * {{code|key.keyboard.102}} → {{code|key.keyboard.power}} | ||
* {{code|key.keyboard.116}} → {{code|key.keyboard.execute}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.119}} → {{code|key.keyboard.select}} | ||
* {{code|key.keyboard.134}} → {{code|key.keyboard.keypad.equals.as400}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.135}} → {{code|key.keyboard.international1}} | ||
* {{code|key.keyboard.136}} → {{code|key.keyboard.international2}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.137}} → {{code|key.keyboard.international3}} | ||
* {{code|key.keyboard.138}} → {{code|key.keyboard.international4}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.139}} → {{code|key.keyboard.international5}} | ||
* {{code|key.keyboard.140}} → {{code|key.keyboard.international6}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.141}} → {{code|key.keyboard.international7}} | ||
* {{code|key.keyboard.142}} → {{code|key.keyboard.international8}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.143}} → {{code|key.keyboard.international9}} | ||
* {{code|key.keyboard.144}} → {{code|key.keyboard.lang1}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.145}} → {{code|key.keyboard.lang2}} | ||
* {{code|key.keyboard.146}} → {{code|key.keyboard.lang3}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.147}} → {{code|key.keyboard.lang4}} | ||
* {{code|key.keyboard.148}} → {{code|key.keyboard.lang5}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.149}} → {{code|key.keyboard.lang6}} | ||
* {{code|key.keyboard.150}} → {{code|key.keyboard.lang7}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.151}} → {{code|key.keyboard.lang8}} | ||
* {{code|key.keyboard.152}} → {{code|key.keyboard.lang9}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.153}} → {{code|key.keyboard.alternate.erase}} | ||
* {{code|key.keyboard.154}} → {{code|key.keyboard.sys.req}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.155}} → {{code|key.keyboard.cancel}} | ||
* {{code|key.keyboard.156}} → {{code|key.keyboard.clear}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.157}} → {{code|key.keyboard.prior}} | ||
* {{code|key.keyboard.158}} → {{code|key.keyboard.enter2}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.159}} → {{code|key.keyboard.separator}} | ||
* {{code|key.keyboard.160}} → {{code|key.keyboard.out}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.161}} → {{code|key.keyboard.oper}} | ||
* {{code|key.keyboard.162}} → {{code|key.keyboard.clear.again}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.163}} → {{code|key.keyboard.crsel}} | ||
* {{code|key.keyboard.164}} → {{code|key.keyboard.exsel}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.176}} → {{code|key.keyboard.keypad.00}} | ||
* {{code|key.keyboard.177}} → {{code|key.keyboard.keypad.000}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.178}} → {{code|key.keyboard.thousands.separator}} | ||
* {{code|key.keyboard.179}} → {{code|key.keyboard.decimal.separator}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.180}} → {{code|key.keyboard.currency.unit}} | ||
* {{code|key.keyboard.181}} → {{code|key.keyboard.currency.subunit}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.184}} → {{code|key.keyboard.keypad.left.brace}} | ||
* {{code|key.keyboard.185}} → {{code|key.keyboard.keypad.right.brace}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.186}} → {{code|key.keyboard.keypad.tab}} | ||
* {{code|key.keyboard.187}} → {{code|key.keyboard.keypad.backspace}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.188}} → {{code|key.keyboard.keypad.a}} | ||
* {{code|key.keyboard.189}} → {{code|key.keyboard.keypad.b}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.190}} → {{code|key.keyboard.keypad.c}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.191}} → {{code|key.keyboard.keypad.d}} | ||
* {{code|key.keyboard.192}} → {{code|key.keyboard.keypad.e}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.193}} → {{code|key.keyboard.keypad.f}} | ||
* {{code|key.keyboard.194}} → {{code|key.keyboard.keypad.xor}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.195}} → {{code|key.keyboard.keypad.power}} | ||
* {{code|key.keyboard.196}} → {{code|key.keyboard.keypad.percent}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.197}} → {{code|key.keyboard.keypad.less}} | ||
* {{code|key.keyboard.198}} → {{code|key.keyboard.keypad.greater}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.199}} → {{code|key.keyboard.keypad.ampersand}} | ||
* {{code|key.keyboard.200}} → {{code|key.keyboard.keypad.double.ampersand}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.201}} → {{code|key.keyboard.keypad.vertical.bar}} | ||
* {{code|key.keyboard.202}} → {{code|key.keyboard.keypad.double.vertical.bar}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.203}} → {{code|key.keyboard.keypad.colon}} | ||
* {{code|key.keyboard.204}} → {{code|key.keyboard.keypad.hash}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.205}} → {{code|key.keyboard.keypad.space}} | ||
* {{code|key.keyboard.206}} → {{code|key.keyboard.keypad.at}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.207}} → {{code|key.keyboard.keypad.exclamation}} | ||
* {{code|key.keyboard.208}} → {{code|key.keyboard.keypad.memory.store}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.209}} → {{code|key.keyboard.keypad.memory.recall}} | ||
* {{code|key.keyboard.210}} → {{code|key.keyboard.keypad.memory.clear}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.211}} → {{code|key.keyboard.keypad.memory.add}} | ||
* {{code|key.keyboard.212}} → {{code|key.keyboard.keypad.memory.subtract}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.213}} → {{code|key.keyboard.keypad.memory.multiply}} | ||
* {{code|key.keyboard.214}} → {{code|key.keyboard.keypad.memory.divide}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.216}} → {{code|key.keyboard.keypad.clear}} | ||
* {{code|key.keyboard.217}} → {{code|key.keyboard.keypad.clear.entry}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.218}} → {{code|key.keyboard.keypad.binary}} | ||
* {{code|key.keyboard.219}} → {{code|key.keyboard.keypad.octal}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.221}} → {{code|key.keyboard.keypad.hexadecimal}} | ||
* {{code|key.keyboard.257}} → {{code|key.keyboard.mode}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.258}} → {{code|key.keyboard.sleep}} | ||
* {{code|key.keyboard.259}} → {{code|key.keyboard.wake}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.260}} → {{code|key.keyboard.channel.up}} | ||
* {{code|key.keyboard.261}} → {{code|key.keyboard.channel.down}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.262}} → {{code|key.keyboard.media.play}} | ||
* {{code|key.keyboard.263}} → {{code|key.keyboard.media.pause}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.264}} → {{code|key.keyboard.media.record}} | ||
* {{code|key.keyboard.265}} → {{code|key.keyboard.media.fast.forward}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.266}} → {{code|key.keyboard.media.rewind}} | ||
* {{code|key.keyboard.267}} → {{code|key.keyboard.media.next.track}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.268}} → {{code|key.keyboard.media.previous.track}} | ||
* {{code|key.keyboard.269}} → {{code|key.keyboard.media.stop}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.270}} → {{code|key.keyboard.media.eject}} | ||
* {{code|key.keyboard.272}} → {{code|key.keyboard.media.select}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.274}} → {{code|key.keyboard.ac.open}} | ||
* {{code|key.keyboard.275}} → {{code|key.keyboard.ac.close}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.276}} → {{code|key.keyboard.ac.exit}} | ||
* {{code|key.keyboard.278}} → {{code|key.keyboard.ac.print}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.279}} → {{code|key.keyboard.ac.properties}} | ||
* {{code|key.keyboard.280}} → {{code|key.keyboard.ac.search}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.281}} → {{code|key.keyboard.ac.home}} | ||
* {{code|key.keyboard.282}} → {{code|key.keyboard.ac.back}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.283}} → {{code|key.keyboard.ac.forward}} | ||
* {{code|key.keyboard.284}} → {{code|key.keyboard.ac.stop}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.285}} → {{code|key.keyboard.ac.refresh}} | ||
* {{code|key.keyboard.286}} → {{code|key.keyboard.ac.bookmarks}} | |||
* {{code|key.keyboard. | * {{code|key.keyboard.287}} → {{code|key.keyboard.soft.left}} | ||
* {{code|key.keyboard. | * {{code|key.keyboard.288}} → {{code|key.keyboard.soft.right}} | ||
* {{code|key.keyboard.289}} → {{code|key.keyboard.call}} | |||
* {{code|key.keyboard.wake}} | * {{code|key.keyboard.290}} → {{code|key.keyboard.end.call}} | ||
}} | }} | ||
|{{code|key.keyboard.application}} now displays as "Application". | |{{code|key.keyboard.application}} now displays as "Application". | ||
Latest revision as of 11:07, 8 September 2026
Template:For This is a list of key codes used by Minecraft:Minecraft, which are used in the Minecraft:options.txt file.
Java Edition
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>Template:Bug</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 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.
Java Edition does not provide official support for controllers.
Keyboard codes
Template:Info needed section Keyboard buttons are handled as a signed 32-bit integer, meaning that through editing options.txt, values from Template:Code to Template:Code can be specified without being rejected by the game as invalid. Any keys corresponding to a valid SDL key code will be automatically converted to one of the named keys below.
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.
Unused
Template:Info needed section 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.
These can be set via modifying Template:Code manually, but will not be triggerable due to the lack of an associated key.
Keys such as World 2, Keypad Decimal and Escape may warrant inclusion here later.Template:Upcoming
Mouse codes
Mouse buttons are handled as a signed 32-bit integer, meaning that through editing options.txt, values from Template:Code to Template:Code can be specified without being rejected by the game as invalid.<ref>Template:Bug</ref> However, the USB HID specification only permits mouse buttons from 1 to 65535,<ref>https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf</ref> meaning that all negative values and the vast majority of the positive values can never actually be assigned to in-game actions without file editing.
Only the first eight mouse buttons can have controls assigned to them.Template:Until
On Linux, mouse buttons up to 48Template:Upcoming can be specified (evdev key press events 272 to 319) - it is not known if any supported operating systems support a 49th or higher mouse button as input. The maximum mouse button on macOS is 32,<ref>according to what karabiner-elements allows: https://discord.com/channels/647810384031645728/648555495564509184/1528136787434930358</ref> and the maximum mouse button on Windows is 5.
For the first three mouse buttons, the translation keys match the key IDs; all other buttons follow a generic template.
Bedrock Edition
Keyboard codes
Template:Info needed section Template:Cleanup In Template:BE, keys are stored as the decimal representation of their virtual key code.
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.
The virtual key code specification also provides numbers for buttons on the mouse. However, mouse buttons are not stored as those numbers.
Mouse codes
Template:Info needed section Mouse buttons are represented by negative numbers.
Controller codes
History
Java Edition
Removed keys
Notes
References
Template:Navbox Java Edition technical Template:Navbox Bedrock Edition
Minecraft:fr:Codes de touche Minecraft:hu:Billentyűkódok Minecraft:ja:キーコード Minecraft:nl:Toetscodes Minecraft:pt:Códigos de teclas Minecraft:ru:Коды клавиш Minecraft:uk:Коди клавіш Minecraft:zh:键控代码