MegaZeux US Key-Mapping Guide

MegaZeux 2.93 — December 31st, 2023

This guide contains information and warnings for reading keycodes in MegaZeux games.

 
 
 
 
NumL. n/a

n/a

key_numlock
/ 53

267

key_kp_divide
* 55

268

key_kp_multiply
- 74

269

key_kp_minus
7 Home 71

263

key_kp7
8 ▲ 72

264

key_kp8
9 PgUp 73

265

key_kp9
+ 78

270

key_kp_plus
4 ◀ 75

260

key_kp4
5 76

261

key_kp5
6 ▶ 77

262

key_kp6
1 End 79

257

key_kp1
2 ▼ 80

258

key_kp2
3 PgDn 81

259

key_kp3
Enter 28

271

key_kp_enter
0 Insert 82

256

key_kp0
.Delete 83

266

key_kp_period
SysRq 55

317

key_sysreq
Scr.L. 70

302

key_scrolllock
Break 197

318

key_break
Insert 82

277

key_insert
Home 71

278

key_home
PgUp 73

280

key_pageup
Delete 83

127

key_delete
End 79

279

key_end
PgDn 81

281

key_pagedown
 
 
 
 
▲ 72

273

key_up
 
◀ 75

276

key_left
▼ 80

274

key_down
▶ 77

275

key_right
Esc 1

27

key_escape
F1 59

282

key_f1
F2 60

283

key_f2
F3 61

284

key_f3
F4 62

285

key_f4
F5 63

286

key_f5
F6 64

287

key_f6
F7 65

288

key_f7
F8 66

289

key_f8
F9 67

290

key_f9
F10 68

291

key_f10
F11 87

292

key_f11
F12 88

293

key_f12
` 41

96

key_backquote
1 2

49

key_1
2 3

50

key_2
3 4

51

key_3
4 5

52

key_4
5 6

53

key_5
6 7

54

key_6
7 8

55

key_7
8 9

56

key_8
9 10

57

key_9
0 11

48

key_0
- 12

45

key_minus
= 13

61

key_equals
BackSp. 14

8

key_backspace
Tab 15

9

key_tab
Q 16

113

key_q
W 17

119

key_w
E 18

101

key_e
R 19

114

key_r
T 20

116

key_t
Y 21

121

key_y
U 22

117

key_u
I 23

105

key_i
O 24

111

key_o
P 25

112

key_p
[ 26

91

key_leftbracket
] 27

93

key_rightbracket
\ 43

92

key_backslash
58

301

key_capslock
A 30

97

key_a
S 31

115

key_s
D 32

100

key_d
F 33

102

key_f
G 34

103

key_g
H 35

104

key_h
J 36

106

key_j
K 37

107

key_k
L 38

108

key_l
; 39

59

key_semicolon
' 40

39

key_quote
Enter 28

13

key_return
L. Shift 42

304

key_lshift
Z 44

122

key_z
X 45

120

key_x
C 46

99

key_c
V 47

118

key_v
B 48

98

key_b
N 49

110

key_n
M 50

109

key_m
, 51

44

key_comma
. 52

46

key_period
/ 53

47

key_slash
R. Shift 54

303

key_rshift
 
L. Ctrl 29

306

key_lctrl
L. Win 91

311

key_lsuper
L. Alt 56

308

key_lalt
Space 57

32

key_space
R. Alt 56

307

key_ralt
R. Win 92

312

key_rsuper
Menu 93

319

key_menu
R. Ctrl 29

305

key_rctrl
 
Key: key_code / key(n) [PC XT]

key_pressed [internal]

(hover: config file key name) Key names can be used instead of key_pressed numbers in the config file. To get the config file name for a key, hover over it.
Normal key—always available for use.
Game key—can disable via Robotic or other means.
Debug key—has a unique function only while testing.
This key may be missing between keyboards.
Unusable key—can not or should not be used ever.
  F12 is currently used as the screenshot key on platforms that support screenshots. Screenshot support can be disabled in the config file. Other function keys (e.g. F13) are not supported by MegaZeux.
  The results for this value can vary between systems or may not be detected at all by MegaZeux. Personal use only.
  In previous versions of MegaZeux, Caps Lock would be held while enabled. In 2.90, it acts like a regular key.
  Modifier keys have slightly different repeating behavior than regular keys and may trigger special MZX or operating system functionality in conjunction with other keys. The Windows key (aka "Meta", "Super") is equivalent to the Command key on Mac keyboards, however, the positions of these keys are swapped with the Alt keys (which may be called "Option").
 
Game keys can be bypassed using game settings, Robotic, or the config file.
Enter The game menu can be disabled by setting the ENTER_MENU counter to 0.
Escape The escape menu can be disabled by setting the ESCAPE_MENU counter to 0. The user can still access this menu by pressing Alt+F4.
F1 The help menu can be disabled by setting the HELP_MENU counter to 0.
F2 The settings menu can be disabled by setting the F2_MENU counter to 0. The user can still access this menu by pressing Ctrl+F2 or Alt+F2 unless standalone mode is enabled.
F3/F9 Saving can be restricted on a per-board basis with the Board Settings dialog or using the Robotic commands enable saving, disable saving, and enable sensoronly saving.
F4/F10 Loading can be disabled by setting the LOAD_MENU counter to 0.
F12 Screenshots can be configured by the user with the config file option allow_screenshots.
Space Shooting can be disabled with the board flags Can shoot and Player attack locked or by the Robotic commands lockplayer and lockplayer attack. The "You can't shoot here!" message can be disabled by setting the BIMESG counter to 0. Both shooting and the behavior that prevents the player from moving while space is held can be disabled by setting the SPACELOCK counter to 0.
F5/Insert/Delete Bomb switching and bombing can be disabled with the board flags Can bomb and Player attack locked or by the Robotic commands lockplayer and lockplayer attack. The "You can't bomb here!" message can be disabled by setting the BIMESG counter to 0.
Arrows Player movement can be disabled with the board flags Player locked N/S and Player locked E/W or by the Robotic commands lockplayer, lockplayer ns, and lockplayer ew. The behavior that causes the viewport to snap to the player when the player moves can be disabled with the Robotic command lockscroll.


License

Copyright © 2010-2023 Lachesis — https://github.com/AliceLR/megazeux/

Permission to use, copy, modify, and distribute this document for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE DOCUMENT IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS DOCUMENT INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS DOCUMENT.