OSDN Git Service

Merge branch 'develop' into macos-develop
authorEric Branlund <ebranlund@fastmail.com>
Fri, 26 Feb 2021 19:28:01 +0000 (11:28 -0800)
committerEric Branlund <ebranlund@fastmail.com>
Fri, 26 Feb 2021 19:28:01 +0000 (11:28 -0800)
1  2 
readme-eng.md

diff --cc readme-eng.md
index 0000000,f23b549..89b78f6
mode 000000,100644..100644
--- /dev/null
@@@ -1,0 -1,212 +1,251 @@@
+ # Caution
+ This readme is very old, so I will update it later.
+ # How to install
+ ##  UNIX
+ Download source archive and try...
+ > tar -zxvf hengband-x.x.x.tar.gz
+ > cd hengband-x.x.x
+ > ./configure --disable-japanese
+ > make install
+ Substitute the version number to x.x.x.
+ You need --disable-japanese option of the configure for English version.
+ If you are a super user, --with-setgid=games option works.
+ then try
+ > ./hengband -- -n<number of windows>  ## for normal ASCII graphics
+   or
+ > ./hengband -g -- -n<# of windows>    ## for 8x8 tile graphics 
+ > ./hengband -g -- -b -n<# of windows> ## for Bigtile graphics
+ > ./hengband -g -- -a -n<# of windows> ## for 16x16 tile (need heng_graf.tar.gz)
+   to play.
+ You can change game windows' font, location, and size, by environment 
+ variables.
+ Ex.
+ > setenv ANGBAND_X11_FONT '-*-*-medium-r-normal--24-*-*-*-*-*-iso8859-1'
+ > hengband -- -n
+ Then font size will be changed.
+ You can set ANGBAND_X11_FONT_n for specific window which have window number n.
+ Location of windows are ANGBAND_X11_AT_X_n, and ANGBAND_X11_AT_Y_n.
+ Size of windows are ANGBAND_X11_COLS_n, and ANGBAND_X11_ROWS_n.
+ ## Windows
+ Download the binary archive for Windows.
+ Unzip it, and click hengband to play.
+ The makefile.bcc was changed again.
+ If you want to compile from the source with borland compiler (BCC),
+ Comment out options for japanese; 'JP_OPT = ...' and 'ANGBAND_RC = ...' 
+ in makefile.bcc, and un-comment the line 'ANGBAND_RC = ang_eng.rc'.
++## Macintosh
++
++Download the dmg file for Macintosh, double click on it to open the disk
++image, and then drag the hengband application inside it to where you want
++to store it.  Double clicking on the application will run it.  Since the
++application has not been signed, you'll likely have to make an exception
++for it to use the application.  Apple's instructions for how to do that
++are at
++
++    https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac
++
++In short, one way to grant the exception is:
++
++1. Control click (i.e. click while holding the control button down) on the
++application in the finder.
++2. Select "Open" in the menu that comes up.
++3. That will bring up a confirmation dialog about allowing the application to
++open on the system.
++4. If your account does not have administrator privileges, there'll be an
++additional dialog asking you to authenticate as an administrator to apply
++the exception to the security settings.
++
++For Mac OS X with Xcode installed, the Unix instructions can work to build a
++version usable from a terminal.  If XQuartz, https://www.xquartz.org , is
++installed, X11 will be used for dsiaply.
++
++For Mac OS X 10.8 or later with Xcode installed, a native version can be
++built by downloading the source archive and running
++
++> tar -zxvt hengband-x.x.x.tar.gz
++> cd hengband-x.x.x
++> ./configure --disable-japanese --enable-cocoa
++> make install
++
++from a terminal where you subsitute x.x.x with the version number you
++downloaded.  That will build hengband.app in the hengband-x.x.x directory:
++you can then move hengband.app to where you want it to be.
++
++
+ # Basic for Playing
+  We recommend that you go to the Yeek cave next to your starting position 
+ in the town of Outpost.  Although the King of Yeeks at the lowest level is a 
+ fierce enemy, the rest of the cave should be fairly safe.  Once you complete 
+ this dungeon, you will be strong enough to leave Outpost in search of greater 
+ adventures.  Carry lots of food and fuel, for the journey can be a long one.  
+ Since this world is very large, it is convenient to go into global map mode by 
+ pressing the '<' key, and then return to local map mode by '>' key when you are 
+ at the destination.  When in the wilderness, stay in safe grids such as roads 
+ or plains; seas and lava fields are best avoided for a while.
+       Many towns and dungeons await you; good ones to explore early on include 
+ the orc caves and the Labyrinth.  To the northeast of the town of Morivant, 
+ near the center of the map, is the dread dungeon of Angband.  It is home to the 
+ Serpent of Chaos, whom you must kill in order to win the game.
+ ## Commands
+  Please read on-line help (Press the ? key in the game) for full
+ information of the game.  Here are only descriptions of basic commands.
+  The following section lists most commands, and the less frequently used 
+ ones may be accessed by pressing the return key, or (if using the original 
+ keyset) the 'x' key, to bring up the command menu.  Almost any command may be 
+ chosen from the main menu.  "(R) Rest" can be performed by pushing 'R' (in 
+ uppercase).  "Look around (l/x)" can be performed by pushing 'l' in the Original 
+ keyset, and by pushing 'x' in the Rogue-like keyset.
+ * [Movement]
+ >     Original Keyset Directions
+ >
+ >              7  8  9
+ >              4     6
+ >              1  2  3
+ >
+ >     Roguelike Keyset Directions
+ >
+ >              y  k  u
+ >              h     l
+ >              b  j  n
+    *  5/, Stay still
+    *  <   Go up staircase or Enter global map mode in the wilderness.
+    *  \>   Go down staircase or return from global map mode in the wilderness
+    *  Shift+direction   run
+    *  Ctrl+direction   attack, open, close, or dig
+ * [Tools]
+    * r  Read a scroll
+    * q  Quaff a potion 
+    * u/Z  Use a staff
+    * a/z  Aim a wand
+    * z/a  Zap a rod
+    * E  Eat some food
+    * A  Activate an equipment
+    * F  Fuel your lantern/torch
+    * f/t  Fire a missile
+ * [Action]
+    * d  Drop an item
+    * g  Pick up items
+    * R  Rest for a period
+    * o  Open a door or chest
+    * s  Search for traps/doors
+    * k/Ctrl+d  Destroy an item
+ * [Magic]
+    * m  Cast a spell / use mental power
+    * G  Gain new spells/prayers
+    * U/O  Use bonus power
+    * b/P  Examine spells (choose each spell to get a description)
+ * [Equipment] 
+    * w  Wear/wield equipment
+    * t  Take off equipment
+    * F  Fuel your lantern/torch
+ * [Info] 
+    * x  Examine items in a store
+    * C  Character description
+    * I  Examine an *identified* item
+    * i  Inventory list
+    * l/x  Look around
+    * M  Full dungeon map
+    * ~  Display various information
+ *  [Other]
+    * p  Command pets
+    * =  Set options
+    * $  Reload auto-picker preference file
+    * _  Edit auto-picker preference
+    * n/[  Repeat previous command
+    * @  Interact with macros
+ *  [Help]
+    * ?  View the on-line help (Press a-z to choose a section,  space key to go next page.)
+ ## Inscriptions
+ Below, only the new features in Hengband are explained.
+ * You can inscribe on objects with "@ma" or '@'+<any command letter>+<any tag>. Then, type these alphabet letter in 'm' command to cast from the spellbook.
+ * The inscriptions "@1" or '@'+<any tag number> make the objects able to be used by pressing <tag number> key in any command.  Any alphabet key cannot be used as a tag in this form.
+ * You can inscribe on *identified* items with "%" or "%all". Then, "%" or "%all" is automatically replaced by strings which describe the item's abilities. 
+ ** Example:  You inscribe with "%all" on a pair of gauntlets of power which provide resistance to fire. The description will look like {St;Fi} which means bonus to Strength and resistance to fire. If you inscribe it with "%", its description will look like {Fi} which means its random added ability is resistance to fire.
+ ## Auto pickup/destroy
+ Hengband offers two different methods of auto-pickup/destroy.
+ ### Powerful method
+ * Hengband offers a very powerful auto-pickup/auto-destroy system which you may customize.  Press   *  '_' key to enter edit mode.  Please read the file "autopick_eng.txt" about the syntax.
+ ### Easy method
+ * Since the powerful method is slightly difficult to use effectively, there is another very easy option. you can turn on 
+ * the destroy_items option and/or the always_pickup option to use this method.  These options are located in (6) Easy Auto-Destroyer Options and (1) Input Options in the Set options ('=') command.
+ ## Tile graphics, Big tile, and Big screen
+ ### Tile graphics
+   To use graphics mode, choose it from menu for Windows and Mac, or
+   use -g option for Linux.  There are 8x8 size old tile and 16x16 size
+   Adam bolt tile, and you can change from menu for Windows and Mac, or
+   use -- -a option to use 16x16 tile for Linux.  Since source archive
+   doesn't include 16x16 size tile, you need to download the
+   heng_graf.tar.gz.
+ ### Big tile (Double-width tile)
+   In the Big tile mode, graphic tile have double width, and become
+   square.  You can choose Bigtile from menu for Windows and Mac, or
+   use -- -b option for Linux.
+ ### Big screen
+   You can resize each window using mouse, which allow you to have
+   terminal windows larger than 80x24.  On linux, it's convenience to
+   use environment variables: ANGBAND_X11_COLS_0 and
+   ANGBAND_X11_ROWS_0.
+ ## Play Record
+ Play record will be written to a file named 'playrec-<character's name>.txt' 
+ in the same directory as your user preference file.  It is in ~/.angband/
+ Hengband/ for UNIX, or hengband/lib/user/ for other OS.
+ '|' command displays play record in the game.
+ ## World score
+ When You die, or retire, you can register a score to the world 
+ score sever through the Internet. 
+ However, please do not register a score, if you have cheated 
+ by modifying data or source files, or by restoring from a backed 
+ up savefile.
+ The score server is here:
+   http://hengband.sourceforge.jp/en/score.html