summaryrefslogtreecommitdiff log msg author committer range
path: root/lib/help/command.txt
blob: 2c2f16467f87e1970ddc24af90899dbed0999700 (plain)
 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248  .highlight .hll { background-color: #ffffcc } .highlight .c { color: #888888 } /* Comment */ .highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */ .highlight .k { color: #008800; font-weight: bold } /* Keyword */ .highlight .ch { color: #888888 } /* Comment.Hashbang */ .highlight .cm { color: #888888 } /* Comment.Multiline */ .highlight .cp { color: #cc0000; font-weight: bold } /* Comment.Preproc */ .highlight .cpf { color: #888888 } /* Comment.PreprocFile */ .highlight .c1 { color: #888888 } /* Comment.Single */ .highlight .cs { color: #cc0000; font-weight: bold; background-color: #fff0f0 } /* Comment.Special */ .highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */ .highlight .ge { font-style: italic } /* Generic.Emph */ .highlight .gr { color: #aa0000 } /* Generic.Error */ .highlight .gh { color: #333333 } /* Generic.Heading */ .highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */ .highlight .go { color: #888888 } /* Generic.Output */ .highlight .gp { color: #555555 } /* Generic.Prompt */ .highlight .gs { font-weight: bold } /* Generic.Strong */ .highlight .gu { color: #666666 } /* Generic.Subheading */ .highlight .gt { color: #aa0000 } /* Generic.Traceback */ .highlight .kc { color: #008800; font-weight: bold } /* Keyword.Constant */ .highlight .kd { color: #008800; font-weight: bold } /* Keyword.Declaration */ .highlight .kn { color: #008800; font-weight: bold } /* Keyword.Namespace */ .highlight .kp { color: #008800 } /* Keyword.Pseudo */ .highlight .kr { color: #008800; font-weight: bold } /* Keyword.Reserved */ .highlight .kt { color: #888888; font-weight: bold } /* Keyword.Type */ .highlight .m { color: #0000DD; font-weight: bold } /* Literal.Number */ .highlight .s { color: #dd2200; background-color: #fff0f0 } /* Literal.String */ .highlight .na { color: #336699 } /* Name.Attribute */ .highlight .nb { color: #003388 } /* Name.Builtin */ .highlight .nc { color: #bb0066; font-weight: bold } /* Name.Class */ .highlight .no { color: #003366; font-weight: bold } /* Name.Constant */ .highlight .nd { color: #555555 } /* Name.Decorator */ .highlight .ne { color: #bb0066; font-weight: bold } /* Name.Exception */ .highlight .nf { color: #0066bb; font-weight: bold } /* Name.Function */ .highlight .nl { color: #336699; font-style: italic } /* Name.Label */ .highlight .nn { color: #bb0066; font-weight: bold } /* Name.Namespace */ .highlight .py { color: #336699; font-weight: bold } /* Name.Property */ .highlight .nt { color: #bb0066; font-weight: bold } /* Name.Tag */ .highlight .nv { color: #336699 } /* Name.Variable */ .highlight .ow { color: #008800 } /* Operator.Word */ .highlight .w { color: #bbbbbb } /* Text.Whitespace */ .highlight .mb { color: #0000DD; font-weight: bold } /* Literal.Number.Bin */ .highlight .mf { color: #0000DD; font-weight: bold } /* Literal.Number.Float */ .highlight .mh { color: #0000DD; font-weight: bold } /* Literal.Number.Hex */ .highlight .mi { color: #0000DD; font-weight: bold } /* Literal.Number.Integer */ .highlight .mo { color: #0000DD; font-weight: bold } /* Literal.Number.Oct */ .highlight .sa { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Affix */ .highlight .sb { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Backtick */ .highlight .sc { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Char */ .highlight .dl { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Delimiter */ .highlight .sd { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Doc */ .highlight .s2 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Double */ .highlight .se { color: #0044dd; background-color: #fff0f0 } /* Literal.String.Escape */ .highlight .sh { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Heredoc */ .highlight .si { color: #3333bb; background-color: #fff0f0 } /* Literal.String.Interpol */ .highlight .sx { color: #22bb22; background-color: #f0fff0 } /* Literal.String.Other */ .highlight .sr { color: #008800; background-color: #fff0ff } /* Literal.String.Regex */ .highlight .s1 { color: #dd2200; background-color: #fff0f0 } /* Literal.String.Single */ .highlight .ss { color: #aa6600; background-color: #fff0f0 } /* Literal.String.Symbol */ .highlight .bp { color: #003388 } /* Name.Builtin.Pseudo */ .highlight .fm { color: #0066bb; font-weight: bold } /* Name.Function.Magic */ .highlight .vc { color: #336699 } /* Name.Variable.Class */ .highlight .vg { color: #dd7700 } /* Name.Variable.Global */ .highlight .vi { color: #3333bb } /* Name.Variable.Instance */ .highlight .vm { color: #336699 } /* Name.Variable.Magic */ .highlight .il { color: #0000DD; font-weight: bold } /* Literal.Number.Integer.Long */|||||oy ~~~~~99|Commands #####R=== List of Commands === Angband commands are entered as an "underlying command" (a single key) plus a variety of optional or required arguments. You may choose how the "keyboard keys" are mapped to the "underlying commands" by choosing one of two standard "keysets", the "original" keyset or the "roguelike" keyset. The original keyset is very similar to the "underlying" command set, with a few additions (such as the ability to use the numeric "directions" to "walk" or the "5" key to "stay still"). The roguelike keyset provides similar additions, and also allows the use of the h/j/k/l/y/u/b/n keys to "walk" (or, in combination with the shift or control keys, to run or tunnel), which thus requires a variety of key mappings to allow access to the underlying commands used for walking/running/tunneling. In particular, the "roguelike" keyset includes many more "capital" and "control" keys, as shown below. Note that any keys that are not required for access to the underlying command set may be used by the user as "command macro" triggers (see below). You may always specify any "underlying command" directly by pressing backslash ("\") plus the "underlying command" key. This is normally only used in "macro" definitions. [[[[[BYou may often enter "control-keys" as a caret ("^") plus the key] (so "^" + "p" often yields "^P"). Some commands allow an optional "repeat count", which allows you to tell the game that you wish to do the command multiple times, unless you press a key or are otherwise disturbed. To enter a "repeat count", type '0', followed by the numerical count, followed by the command. You must type "space" before entering certain commands. Skipping the numerical count yields a count of 99. An option allows certain commands (open, disarm, tunnel, etc) to auto-repeat. Some commands will prompt for extra information, such as a direction, an inventory or equipment item, a spell, a textual inscription, the symbol of a monster race, a sub-command, a verification, an amount of time, a quantity, a file name, or various other things. Normally you can hit return to choose the "default" response, or escape to cancel the command entirely. Some commands will prompt for a spell or an inventory item. Pressing space (or '*') will give you a list of choices. Pressing "-" (minus) selects the item on the floor. Pressing a lowercase letter selects the given item. Pressing a capital letter selects the given item after verification. Pressing a numeric digit '#' selects the first item (if any) whose inscription contains "@#" or "@x#", where "x" is the current "underlying command". You may only specify items which are "legal" for the command. Whenever an item inscription contains "!*" or "!x" (with "x" as above) you must verify its selection. In ToME, there are items which occasionally teleport you away, asking for permission first. The recurring "Teleport (y/n)?" can be annoying, and this behavior can be eliminated by inscribing the object which causes the teleportation with "." (or any inscription containing the character "."). With this inscription, the object will no longer teleport you around nor keep asking you. If you want to restore the teleport ability to the object, just remove the "." from its inscription. Note that cursed items which teleport you are unaffected by the inscription. Some commands will prompt for a direction. You may enter a "compass" direction using any of the "direction keys" shown below. Sometimes, you may specify that you wish to use the current "target", by pressing "t" or "5", or that you wish to select a new target, by pressing "*" (see "Target" below). ~~~~~95 #####G Original Keyset Directions Roguelike Keyset Directions 7 8 9 y k u 4 6 h l 1 2 3 b j n Each of the standard keysets provides some short-cuts over the "underlying commands". For example, both keysets allow you to "walk" by simply pressing an "original" direction key (or a "roguelike" direction key if you are using the roguelike keyset), instead of using the "walk" command plus a direction. [[[[[BThe roguelike keyset allows you to "run" or "tunnel" by simply holding the] [[[[[Bshift or control modifier key down while pressing a "roguelike" direction key,] [[[[[Binstead of using the "run" or "tunnel" command plus a direction.] Both keysets allow the use of the "5" key to "stand still", which is most convenient when using the original keyset. Note that on many systems, it is possible to define "macros" (or "command macros") to various keys, or key combinations, so that it is often possible to make macros which, for example, allow the use of the shift or control modifier keys, plus a numeric keypad key, to specify the "run" or "tunnel" command, with the given direction, regardless of any keymap definitions, by using the fact that you can always, for example, use "\" + "." + "6", to specify "run east". ~~~~~100|Commands|Original keyset #####R=== Original Keyset Command Summary (4.2.x) === *****command.txt*1[a Aim a wand] *****command.txt*2[A Activate an artifact] *****command.txt*3[b Browse a book] *****command.txt*4[B Bash a door] *****command.txt*5[c Close a door] *****command.txt*6[C Character description] *****command.txt*7[d Drop an item] *****command.txt*8[D Disarm a trap] *****command.txt*9[e Equipment list] *****command.txt*10[E Eat some food] *****command.txt*11[f Fire (shoot) an item] *****command.txt*12[F Fuel your lantern/torch] *****command.txt*13[g Stay still (flip pickup)] *****command.txt*14[G Gain new skills] *****command.txt*15[h Hack up a corpse] *****command.txt*16[H Drink from a fountain] *****command.txt*17[i Inventory list] *****command.txt*18[I Inspect (closely examine) an item] *****command.txt*19[j Jam a door] J (unused) *****command.txt*20[k Destroy an item] *****command.txt*21[K Cure meat] *****command.txt*22[l Look around] *****command.txt*23[L Look around dungeon by sector] *****command.txt*24[m Cast a spell / use mental power] *****command.txt*25[M Full dungeon map] *****command.txt*85[n Repeat last command] *****command.txt*91[N Abilities Screen] *****command.txt*26[o Open a door or chest] *****command.txt*27[O Sacrifice at an altar] *****command.txt*28[p Pray to your god (if any)] *****command.txt*29[P Pet commands] *****command.txt*30[q Quaff a potion] *****command.txt*31[Q Quit (commit suicide)] *****command.txt*32[r Read a scroll] *****command.txt*33[R Rest for a period] *****command.txt*34[s Search for traps/doors] *****command.txt*35[S Toggle search mode] *****command.txt*36[t Take off equipment] *****command.txt*37[T Dig a tunnel] *****command.txt*38[u Use a staff] *****command.txt*39[U Use bonus power (if any)] *****command.txt*40[v Throw an item] *****command.txt*41[V Version Info] *****command.txt*42[w Wear/wield equipment] W (unused) *****command.txt*43[x Engrave the floor] X (unused) *****command.txt*44[y Give item to monster] *****command.txt*96[Y Chat with a monster] *****command.txt*45[z Zap a rod] *****command.txt*46[Z Steal] *****command.txt*47[! Interact with system] *****debug.txt*101[^A (special - debug command)] *****command.txt*49[@ Interact with macros] ^B (unused) *****command.txt*89[# Begin extended command] ^C (special - break) *****command.txt*97[$Record macros] ^D (unused) *****command.txt*51[% Interact with visuals] *****command.txt*52[^E Toggle choice window] ^ (special - control key) *****command.txt*53[^F Repeat level feeling] *****command.txt*54[& Interact with colors] ^G (unused) *****command.txt*55[* Target monster or location] ^H (unused) ( (unused) ^I (special - tab) ) (unused) ^J (special - linefeed) *****command.txt*58[{ Inscribe an object] ^K (unused) *****command.txt*59[} Uninscribe an object] ^L (unused) [ (unused) ^M (special - return) ] (unused) ^N (unused) *****command.txt*60[- Walk (flip pickup)] ^O (unused) *****command.txt*61[_ Re-Enter store] *****command.txt*62[^P Show previous messages] *****command.txt*63[+ Alter grid] *****command.txt*64[^Q Quit to next midi song] *****command.txt*65[= Set options] *****command.txt*66[^R Redraw the screen] *****command.txt*67[; Walk (with pickup)] *****command.txt*68[^S Save and don't quit] *****command.txt*69[: Take notes] *****command.txt*70[^T Time of the day] ' (unused) ^U (unused) *****command.txt*71[" Enter a user pref command] ^V (unused) *****command.txt*72[, Stay still (with pickup)] ^W (special - wizard mode) *****command.txt*74[< Go up staircase] *****command.txt*75[^X Save and quit] *****command.txt*76[. Run] ^Y (unused) *****command.txt*77[> Go down staircase] ^Z (special - borg command) *****command.txt*79[\ (special - bypass keymap)] *****command.txt*80[| Do cmovies] *****command.txt*81[ (special - escape)] *****command.txt*82[~ Display current knowledge] *****command.txt*83[/ Identify symbol] *****command.txt*84[? Help] *****command.txt*98[^\] Take an html screenshot] ~~~~~101|Commands|Roguelike keyset #####R=== Roguelike Keyset Command Summary (4.2.x) === *****command.txt*45[a Zap a rod (Activate)] *****command.txt*2[A Activate an artifact] *****command.txt*95[b (walk - south west)] *****command.txt*95[B (run - south west)] *****command.txt*5[c Close a door] *****command.txt*6[C Character description] *****command.txt*7[d Drop an item] *****command.txt*8[D Disarm a trap or chest] *****command.txt*9[e Equipment list] *****command.txt*10[E Eat some food] *****command.txt*4[f Bash a door (force)] *****command.txt*12[F Fuel your lantern/torch] *****command.txt*13[g Stay still (flip pickup)] *****command.txt*14[G Gain new skills] *****command.txt*95[h (walk - west)] *****command.txt*95[H (run - west)] *****command.txt*17[i Inventory list] *****command.txt*18[I Observe an item] *****command.txt*95[j (walk - south)] *****command.txt*95[J (run - south)] *****command.txt*95[k (walk - north)] *****command.txt*95[K (run - north)] *****command.txt*95[l (walk - east)] *****command.txt*95[L (run - east)] *****command.txt*24[m Spell casting / mental power] *****command.txt*25[M Full dungeon map] *****command.txt*95[n (walk - south east)] *****command.txt*95[N (run - south east)] *****command.txt*26[o Open a door or chest] *****command.txt*39[O Use bonus power (if any)] *****command.txt*28[p Pray to your god (if any)] *****command.txt*3[P Browse a book] *****command.txt*30[q Quaff a potion] *****command.txt*31[Q Quit (commit suicide)] *****command.txt*32[r Read a scroll] *****command.txt*33[R Rest for a period] *****command.txt*34[s Search for traps/doors] *****command.txt*97[S Record macros] *****command.txt*11[t Fire an item] *****command.txt*36[T Take off equipment] *****command.txt*95[u (walk - north east)] *****command.txt*95[U (run - north east)] *****command.txt*40[v Throw an item] *****command.txt*16[V Drink from a fountain] *****command.txt*42[w Wear/wield equipment] *****command.txt*23[W Locate player on map (Where)] *****command.txt*22[x Look around] *****command.txt*29[X Pet commands] *****command.txt*95[y (walk - north west)] *****command.txt*95[Y (run - north west)] *****command.txt*1[z Aim a wand (Zap)] *****command.txt*38[Z Use a staff (Zap)] *****command.txt*47[! Interact with system] ^A (special - debug command) *****command.txt*49[@ Interact with macros] *****command.txt*95[^B (tunnel - south west)] *****command.txt*35[# Toggle search mode] ^C (special - break) *****command.txt*15[$ Hack up a corpse] *****command.txt*20[^D Destroy item] *****command.txt*51[% Interact with visuals] *****command.txt*52[^E Toggle choice window] ^ (special - control key) *****command.txt*53[^F Repeat level feeling] *****command.txt*54[& Interact with colors] *****command.txt*27[^G Sacrifice at an altar] *****command.txt*55[* Target monster or location] *****command.txt*95[^H (tunnel - west)] *****command.txt*96[( Chat] ^I (special - tab) *****command.txt*89[) Begin extended command] *****command.txt*95[^J (tunnel - south)] *****command.txt*58[{ Inscribe an object] *****command.txt*95[^K (tunnel - north)] *****command.txt*59[} Uninscribe an object] *****command.txt*95[^L (tunnel - east)] [*****command.txt*46[ Steal] *****command.txt*95[^M (tunnel - south)] ]*****command.txt*43[ Engrave the floor] *****command.txt*95[^N (tunnel - south east)] *****command.txt*60[- Walk (flip pickup)] *****command.txt*21[^O Cure meat] *****command.txt*61[_ Enter store] *****command.txt*62[^P Show previous messages] *****command.txt*63[+ Alter grid] *****command.txt*64[^Q Quit to next midi song] *****command.txt*65[= Set options] *****command.txt*66[^R Redraw the screen] *****command.txt*67[; Walk (with pickup)] *****command.txt*68[^S Save and don't quit] *****command.txt*69[: Take notes] *****command.txt*37[^T Dig a Tunnel] *****command.txt*44[' Give object to monster] *****command.txt*95[^U (tunnel - north east)] *****command.txt*71[" Enter a user pref command] ^V (unused) *****command.txt*76[, Run] ^W (special - wizard mode) *****command.txt*74[< Go up staircase] *****command.txt*75[^X Save and quit] *****command.txt*72[. Stay still (with pickup)] *****command.txt*95[^Y (tunnel - north west)] *****command.txt*77[> Go down staircase] ^Z (special - borg command) *****command.txt*79[\ (special - bypass keymap)] *****command.txt*80[| Do cmovies] *****command.txt*81[ (special - escape)] *****command.txt*82[~ Display current knowledge] *****command.txt*83[/ Identify symbol] *****command.txt*84[? Help] ~~~~~102|Commands|Special keys #####R=== Special Keys === Certain special keys may be intercepted by the operating system or the host machine, causing unexpected results. In general, these special keys are control keys, and often, you can disable their special effects. If you are playing on a UNIX or similar system, then Ctrl-C will interrupt ToME. The second and third interrupt will induce a warning bell, and the fourth will induce both a warning bell and a special message, since the fifth will quit the game, after killing your character. Also, Ctrl-Z will suspend the game, and return you to the original command shell, until you resume the game with the "fg" command. There is now a compilation option to force the game to prevent the "double ctrl-z escape death trick". The Ctrl-\ and Ctrl-D and Ctrl-S keys should not be intercepted. It is often possible to specify "control-keys" without actually pressing the control key, by typing a caret ("^") followed by the key. This is useful for specifying control-key commands which might be caught by the operating system as explained above. ~~~~~79 Pressing [[[[[Gbackslash ("\\")] before a command will bypass all keymaps, and the next keypress will be interpreted as an "underlying command" key, unless it is a caret ("^"), in which case the keypress after that will be turned into a control-key and interpreted as a command in the underlying ToME keyset. The backslash key is useful for creating macro actions which are not affected by any keymap definitions that may be in force, for example, the sequence "\" + "." + "6" will always mean "run east", even if the "." key has been mapped to a different underlying command. The "0" and "^" and "\" keys all have special meaning when entered at the command prompt, and there is no "useful" way to specify any of them as an "underlying command", which is okay, since they would have no effect. ~~~~~81 For many input requests or queries, the [[[[[Gspecial character ESCAPE] will abort the command. The "[y/n]" prompts may be answered with "y" or "n", or escape. The "-more-" message prompts may be cleared (after reading the displayed message) by pressing ESCAPE, SPACE, RETURN, LINEFEED, or by any keypress, if the "quick_messages" option is turned on. ~~~~~103|Commands|Command counts ~~~~~104|Commands|Repeating a command #####R=== Command Counts === Some commands can be executed a fixed number of times by preceding them with a count. Counted commands will execute until the count expires, until you type any character, or until something significant happens, such as being attacked. Thus, a counted command doesn't work to attack another creature. While the command is being repeated, the number of times left to be repeated will flash by on the line at the bottom of the screen. [[[[[BTo give a count to a command, type 0, the repeat count, and then] [[[[[Bthe command.] If you want to give a movement command and you are using the original command set (where the movement commands are digits), press space after the count and you will be prompted for the command. Counted commands are very useful for searching or tunneling, as they automatically terminate on success, or if you are attacked. You may also terminate any counted command (or resting or running), by typing any character. This character is ignored, but it is safest to use a SPACE or ESCAPE which are always ignored as commands in case you type the command just after the count expires. You can tell ToME to automatically use a repeat count of 99 with commands you normally want to repeat (open, disarm, tunnel, bash, alter, etc) by setting the "always_repeat" option. #####R=== Selection of Objects === Many commands will also prompt for a particular object to be used. For example, the command to read a scroll will ask you which of the scrolls that you are carrying that you wish to read. In such cases, the selection is made by typing a letter of the alphabet. The prompt will indicate the possible letters, and will also allow you to type the key "*", which causes all of the available options to be described. The list of choices will also be shown in the Choice window, if you are using a windows environment and windows are turned on. Often you will be able to press "/" to select an object from your equipment instead of your inventory. Pressing space once will have the same effect as "*", and the second time will cancel the command and run the "i" or "e" command. [[[[[BThe particular object may be selected by an upper case or a lower] [[[[[Bcase letter. If lower case is used, the selection takes place] [[[[[Bimmediately. If upper case is used, then the particular option is] [[[[[Bdescribed, and you are given the option of confirming or retracting that] [[[[[Bchoice.] Upper case selection is thus safer, but requires an extra key stroke. Also see the "!*" and "!x" inscriptions, below. For many commands, [[[[[Byou can also use "-" to select an object on the] [[[[[Bfloor where you are standing.] This lets you read scrolls or quaff potions, for example, off the dungeon floor without picking them up. ~~~~~90 If you enter a number between 0 and 9, the first item engraved with "@#" where "#" is the number you entered will be selected. For example, if you have a shovel engraved with "@0" and you type "w" (for wield) and then 0, you will wield the shovel. This is very useful for macros (see below), since you can use this to select an object regardless of its location in your pack. Multiple numbers can be engraved on the same object; for example, if a sword is engraved with @1@0, then either "w1" or "w0" will wield it. Normally, you inscribe "@1@0" on your primary weapon, and "@2@0" on your secondary weapon. [[[[[BNote that an inscription containing] [[[[[B"@x#" will act like "@#" but only when the current "ToME command"] [[[[[Bis "x".] Thus you can put "@z4" on a rod and "@u4" on a staff, and then use both "z4" and "u4" as desired. Note that any object containing "!x" in its inscription, where "x" is the current "ToME command" (or containing "!*" ever) will induce "verification" whenever that object is "selected". Thus, inscribing, say, "!f!k!d" on an object will greatly reduce the odds of you "losing" it by accident, and [[[[[Binscribing "!*" on an object] will allow you to be very paranoid about the object. Note that "selling" and "dropping" both use the "d" command. ~~~~~105|Pref files #####R=== User Pref Files === ToME allows you to change various aspects of the game to suit your tastes. You may define keymaps (changing the way ToME maps your keypresses to underlying commands), create macros (allowing you to map a single keypress to a series of keypresses), modify the visuals (allowing you to change the appearance of monsters, objects, or terrain features), change the colors (allowing you to make a given color brighter, darker, or even completely different), or set options (turning them off or on). ToME stores your preferences in files called "user pref files", which contain comments and "user pref commands", which are simple strings describing one aspect of the system about which the user has a preference. There are many ways to load a user pref file, and in fact, some of these files are automatically loaded for you by the game. All of the files are kept in the "lib/user/" directory, though you may have to use one of the command line arguments to redirect this directory, especially on multiuser systems. You may also enter single user pref commands directly, using the special "Enter a user pref command" command, activated by "double quote". You may have to use the "redraw" command (^R) after changing certain of the aspects of the game, to allow ToME to adapt to your changes. When the game starts up, after you have loaded an old character, or created a new character, some user pref files are loaded automatically. First, the "pref.prf" file is loaded. This file contains some user pref commands which will work on all platforms. Then one of "font-xxx.prf" (for normal usage) or "graf-xxx.prf" (for bitmap usage) is loaded. These files contain attr/char changes to allow the monsters, objects, and/or terrain features to look "better" on your system. Then the "pref-xxx.prf" file is loaded. This file contains pre-defined system specific stuff (macros, color definitions, etc). Then, the "user-xxx.prf" file is loaded. This file contains user-defined system specific stuff. The "user-xxx.prf" file is used as the "default" user pref file in many places. The "xxx" is the "system suffix" for your system, taken from the "main-xxx.c" file which was used to generate your executable. Finally, the "Race.prf", "Class.prf", and "Name.prf" files are loaded, where "Race", "Class", and "Name" are replaced by the actual race, class, and name of the current character. Several commands allow you to both load existing user pref files, create new user pref files, append information to existing user pref files, and/or interact with various of the user preferences in a more intuitive way than the user pref commands allow. The commands include "Interact with macros" (@), "Interact with visuals" (%), and "Interact with colors" (&), described below. ~~~~~106|Pref files|Macros #####G--- User Pref Files (Macros) --- The "Interact with macros" command allows you to define or remove "macros", which are mappings from a single logical keypress to a sequence of keypresses, allowing you to use special keys on the keyboard, such as function keys or keypad keys, possibly in conjunction with modifier keys, to "automate" repetitive multi-keypress commands that you use a lot. Since macros represent keypress sequences, and not all keypresses have a printable representation, macro triggers and actions must often be "encoded" into a human readable form. This is done using several types of encoding, including "\xHH" for character number HH in hexidecimal, "\e" for the "escape" code, "\n" for the "newline" code, "\r" for the "return" code, "\s" for the "space" code, "\\" for backslash, "\^" for caret, and "^X" for the code for any "control" key "ctrl-X". Note that the "action" of a macro will not be checked against other macro triggers (unless the macro action contains a "control-backslash"), so you cannot make infinite loops. You may specify extremely long macros, but you are limited in length by the underlying input mechanisms, which in general limit you to about 1024 keys in both triggers and actions. The special "\" command (which must be encoded in macros as "\\") is very useful in macros, since it bypasses all keymaps and allows the next keystroke to be considered a command in the underlying ToME command set. For example, a macro which maps Shift-KP6 to "\" + "." + "6" will induce the "run east" behavior, regardless of what keyset the user has chosen, and regardless of what keymaps have been defined. Macros can be specified in user pref files as a pair of lines, one of the form "A:", which defines the encoded macro action, and one of the form "P:", which defines the encoded macro trigger. A [[[[[Bcommon example of a macro] to cast the first spell in your first spell book at the nearest monster would be: \e\e\em1a*t where \e is an escape (to make sure you are not still within another command), m1 selects the spell book that is inscribed ({) with @m1, a selects the first spell in that book, and *t targets the nearest monster. More detailed information about specific macros can be found in *****macrofaq.txt*0[macrofaq.txt], originally written by Jim Lyon (jplyon@attglobal.net), modified for ToME with Jim's permission by Dawnmist (angband@dawnmist.8m.com). ~~~~~107|Pref files|Keymaps #####G--- User Pref Files (Keymaps) --- The "Interact with macros" command also allows you to define "keymaps", which are vaguely related to macros. A keymap maps a single keypress to a series of keypresses, which bypass both other keymaps and any macros. ToME uses keymaps to map the original and the roguelike keysets to the underlying command set, and allows the user to modify or add keymaps of their own. Note that all keymap actions must be specified using underlying commands, not keypresses from the original or roguelike keysets. The original keyset is almost identical to the underlying keyset, except that "numbers" are mapped to ";" plus a direction, "5" is mapped to ",", and a few control-keys are mapped to various things. See "command.txt" for the full set of underlying commands. Some uses for keymaps include the ability to "disable" a command by mapping it to "\x00", Keymaps can be specified in user pref files as line of the form "M: ", where is the keyset (0/1 for original/roguelike), is the encoded trigger key, and is the encoded keymap action. ~~~~~108|Pref files|Visuals #####G--- User Pref Files (Visuals) --- You can use the "Interact with visuals" command to change various visual information, currently including the choice of what attr/char values are used to represent various monsters, objects, or terrain features. Note that in combination appropriate support in "main-xxx.c", and with the use of the "use_graphics" flag, you may be able to specify that "graphic bitmaps" should be used instead of normal "colored characters" for various things. When interactively modifying the attr/char values for monsters, objects, or terrain features, pressing "n" or "N" will change which entry you are changing, pressing "a" or "A" will rotate through the available attr values, and pressing "c" or "C" will rotate though the available char values. Note that attr/char values with the "high bit" set may induce the display of special "graphic" pictures if the "use_graphics" flag is set, and your system supports the "use_graphics" flag. Note that this command can be abused in various ways, and if you must do so, remember that you are only cheating yourself. Keymaps can be specified in user pref files as line of the form "R::/" or "K::/" or "F::/" or "U::/". ~~~~~109|Pref files|Colors #####G--- User Pref Files (Colors) --- The "Interact with colors" command allows you to change the actual internal values used to display various colors. This command may or may not have any effect on your machine. Advanced machines may allow you to change the actual RGB values used to represent each of the 16 colors used by ToME, and perhaps even allow you to define new colors which are not currently used by ToME. Colors can be specified in user pref files as line of the form "V:::::". ~~~~~110|Pref files|Options #####G--- User Pref Files (Options) --- The "Interact with options" command allows you to turn options on or off. You may turn options off or on using the user pref commands of the form "X: