New NKIs!
[rfk-inform.git] / README.md
1 # robotfindskitten: A Zen Simulation
2 **Release 8 / Serial number 220120 / Inform v6.35**
3
4      [-]       |\_/|        http://www.robotfindskitten.org
5      (+)=C     |o o|__      Leonard Richardson (C) 1997, 2000
6      | |       --*--__\     David Griffith (C) 2002-2022  (Inform Edition)
7      OOO       C_C(____)
8
9 This Zen simulation is based on the C version v1600003.248b
10 by Leonard Richardson (C) 1997, 2000.
11 Written originally for the Nerth Pork robotfindskitten contest.
12 Reimplemented in Inform by David Griffith (C) 2002.
13
14 Lots more information on robotfindskitten is available at
15 http://www.robotfindskitten.org.
16
17 In this game, you are Robot (#).  Your job is to find Kitten.  This
18 task is complicated by the existance of various things which are not
19 kitten.  Robot must touch items to determine if they are Kitten or
20 not.  Move Robot with the cursor keys, the numeric keypad, or
21 using the vi/rogue movement keys. The game ends when robotfindskitten.
22 Alternatively, you may end the game by hitting the Esc or Q keys.
23
24 ## Build
25 Just type `make`.  This automates what is described in the next paragraph.
26
27 The NKI files need to be converted into a form that can be included in 
28 an Inform6 program.  A Perl script, nki2inf.pl, is provided for this 
29 purpose.  Invoke it like this: ````nki2inf.pl *.nki > nki.inf````.  Now you 
30 can invoke Inform6 on kitten.inf.
31
32 ## Notes
33 1. Most of the code is taken up by non kitten items (NKIs).  When I
34    compiled the code with just five messages and no debugging code, the
35    resulting binary was less than 10k bytes.
36
37 2. If it wasn't already abundantly obvious, this program won't compile
38    to Glulx because of copious use of Z-machine assembly instructions.
39
40 3. Compiling for V5 or higher is required due to "style" calls. Is there
41    a reason why someone would want to compile this for V4 or previous?
42
43 ## License
44 The Inform6 edition of robotfindskitten is distributed under the
45 Artistic License 2.0 (https://opensource.org/licenses/Artistic-2.0).