NetHack for GP32! 05/14/2006 The user interface for this GP32 port is based on my Palm OS roguelike ports, which in turn are based on the excellent Sony PSP Angband port by abszero and Gendal. There is a full on-screen-keyboard and macro "star" interface. The Stick can be used to select items from inventory/equipment lists or other menus as well as selecting quantities of items. With a good set of macros it is efficient and very fun to play. The file GPMM\NetHack\macro\default.txt is the active macro file. Please email me your favorite macro sets if you edit/create new ones and I will include them in future releases. Note that there are some SlashEM macros in default.txt that don't make sense to NetHack (since SlashEM has some extra commands). Options for NetHack (including the name of your character or pet) are modified by editing the defaults.nh in the GPMM\NetHack directory of your memory card. Read the NetHack/SlashEM Guidebook for more details on the available options. Let me know (on the GP32x.com boards) about bugs you encounter and try to include a .sav file if possible with instructions to reproduce the problem. enjoy! -Dan Vernon (retrobits) HARDWARE REQUIREMENTS: GP32 * BLU+ support should be auto-detected at startup * if for some reason, this process is not working, holding the Right- trigger at startup will force BLU+ mode. Otherwise Left-Trigger will force NLU/FLU/BLU. (thanks to Mr. Mirko!) FEATURES: "whiz-bang" colorized, pure ASCII, tty interface Intelligent "screen-clipping" to fit within 320x240 pixels using a 6x8 font Extended & colorized status line, adapted to GP32 display Mini console for viewing recent "pager" messages and system events. Level checkpointing (insurance files for recovering from crashes) User definable macros, including editor On-screen keyboard High score list (Top Ten Scores!) INSTALLATION: Extract zip archive, keeping directory structure intact. Copy the "GPMM" directory to the root of your memory card using a card reader or GPLink. HOW TO PLAY: GP32 controls: Stick: Move character (8 way), pick from lists, macro & onscreen keyboard navigation A: Confirm / 'Enter' (Modify macros in macro interface) B: Space bar (Shift / Control toggle in onscreen keyboard) Right Trigger: Cancel / 'Escape' Start: Onscreen keyboard (press again to select) Select: Macro interface (press again to select) Left-Trigger + A: Run mode toggle (also '.' indicating here for direction query) Left-Trigger + B: Enter numeric value (Stick Up/Down, Left/Right to change) Left-Trigger + Select: Look at object using cursor (press A to select) Left-Trigger + Right-Trigger: Save and Exit KNOWN ISSUES: * File writing to SMC card is fairly slow. Not sure if there is a fix since I'm using Mr. Mirko's fine sdk and the I/O routines are nicely buffered already. * Some text wraps a little funny on the GP32's reduced size screen (i.e. when reading help texts). MINI-TUTORIAL: Fire up NetHack, press A (Enter) at the initial prompt asking to create a character for you. Pressing A (Enter) at any prompt takes the default or "Yes". Pressing the Right-Trigger would choose Cancel or "No". You should end up looking at a newly generated dungeon (only one room will be visible), a status line at the bottom, and a brief indroductory paragraph (which may be actually hiding the new dungeon room), with "--More--" printed at the bottom. Whenever you see a "--More--" prompt it means to press B (Space bar) to either dismiss the window, or move to the next page. The cursor should be now blinking over an '@' symbol, which represents you. Near you should be an inverse 'd' or 'f' (or possibly something else if you are playing SlashEM) which indicates your pet (either dog or cat respectively). Your pet is your friend, be careful not to loose it. Lets try a macro. Press Select, then briefly move the analog stick Left, and Left again, then Down. The macro selector should read "Help Menu". If you make a mistake, pressing Right-Trig will move back up the macro tree. Pressing Select again will execute the macro. Now you should be looking at a number of choices for help topics. Moving the stick up and down and pressing enter will select a choice. Press space (B) to page forward (at this point there is no paging back, sorry), and Escape (Right-Trig) to return to the game. As you are moving around, you may encounter a brown '+' symbol. This indicates a closed door. Use the Open macro to attempt to open it. Press Select, followed by Select again. You will be prompted for a direction. Use the stick to select the direction. In some cases, you may wish the direction to indicate the space in which you are currently standing -- you would use the Left-Trigger + A Buttons together ('.') to indicate this at a direction prompt. Maybe the door is locked? Try the Force (Select,Right,Right,Select) Macro. Maybe that didn't work? Try the Kick (Select,Down,Right,Select) Macro. A dead-end corridor might reveal secrets if you Search. You need to learn where the commands are located in the macro interface and what they mean. The NetHack Guidebook will help. Sometimes you will encounter a "Multi-Select" menu. These work just like the "Single-Select" menu that you encountered in the Help System, except that pressing A does not dismiss the menu. Instead the '-' symbol in front of the choice is changed to a '+' sign. To move to the next page of the menu, press B or Stick Right. Stick Left will go to the previous page. Pressing the Select button at this point will bring up a custom macro interface for more multi-select choices such as selecting/deselecting/inverting the page or the entire menu. In some multi-select menus, you can enter a count. This is done by pressing the Left-Trig+B, and using the Stick to enter a number (left/right changes the value by 1, up/down changes the vaule by 20). Pressing A or Left-Trig+B will send the number to NetHack. The next item in the menu you select by pressing A will have a '#' symbol next to it. This indicates that it is selected with a count. When you are ready B or Stick-Right will commit your menu choices. To cancel out of the menu use the Right-Trig. Give this menu process a try by experimenting with the "Multi Drop" (Select,Down,Down,Select) macro. At times when you enter a command, such as Throw, you will be prompted with a list of reasonable choices to Throw (such as a Spear or Stone). To throw something unexpected, move the stick right or left to toggle between a filtered & unfiltered inventory choices. This type of thing applies to many commands, such as Eat, Drink, Read, etc. Sometimes there are things on the floor that you would like to Eat or Drink, or even the spot you are standing on could be "Drinkable" (such as a fountain). In these cases, moving the stick right or left will toggle between all the possibilities. To exit & save the game in progress press the Left- and Right-Triggers together. I suggest reading the NetHack Guidebook to find out more about this game and how to play. Have fun!