-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
137 lines (108 loc) · 6.6 KB
/
README.txt
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
Java Fabled Lands (JaFL)
v1.0.6
--------------------------------
The most current version of this software (and the source code) can be downloaded from
http://sourceforge.net/projects/flapp/
Installation
------------
- Installing Java
---------------
This program requires Java 5.0 (or better) to run.
This is available at:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
There should be a link there to the current Java SE; any version from 5.0 on will do,
although the most recent version is probably the best.
As of this writing, Java Standard Edition (Java SE) 9 is the most recent version.
If you're not sure which version of Java you have installed, you can try running JaFL
as described below. Earlier versions will either show a popup message with the message
"Could not find the main class. Program will exit."
or will briefly show a Command Prompt window with a message like
Exception in thread "main" java.lang.UnsupportedClassVersionError
(Unsupported major.minor version 49.0)
etc.
Either of these means you'll need to download a newer version of Java to run FLOS.
- Installing JaFL
----------------
Once Java is installed, you should be able to run JaFL by extracting JaFL.zip
into a new folder and running JaFL.bat. Windows users may be able to simply
double-click on flands.jar to run it. Alternatively, you can create a
command prompt window, change to the directory you unzipped the files to, and type:
java -jar flands.jar
If you have a previous installation of JaFL, you can simply extract the zip to
overwrite the old installation. This will leave any saved game unaffected
(though see the note below about saved games).
- Adding the illustrations
------------------------
The illustrations for the books are available at the same website as JaFL, and
will work with version 0.96 and later. You will need to copy these files
('illus1.zip', 'illus2.zip' and so on) into your installation directory. DO NOT
unzip these files! Once there, the program will find and display them in the
'book' window. Note that the illustrations are scaled to fit in the window, and
will only be displayed at their full size (and best quality) if the window is
wide enough.
How to use
----------
The aim of this project has been to present an experience as close as possible to reading
the original gamebooks, while automating all the game rules. The main interface ended up
looking a lot like a browser window, with executable elements underlined. Greyed-out text
is disabled; either it will become enabled as you progress through the section, or it
depends on conditions that haven't been met. Hopefully this is intuitive to use
(if not to explain). If you're not sure what an underlined 'action' will do, you can
right-click on it to bring up a tool-tip, which may or may not clarify the situation.
The rules of the original books can be read in the 'Help' menu. Given that the rules are
implemented for you, the 'Quick Rules' are probably sufficient.
The Adventure Sheet is largely non-interactive. The elements that _are_ interactive
(the item list, money box, blessings, and curses) can be used via the mouse.
Double-clicking will 'use' an item or blessing (wielding a weapon, wearing armour,
using a special item, or using a luck blessing). The items also have popup menus
(activated by right-clicking on an item), through which they can be dropped, sold,
or transferred to a cache. Occasionally you can select multiple items in a list
via a Ctrl + Click, when appropriate.
Abilities are shown in their 'affected' state: that is, their value after all bonuses and
penalties are applied. Each of the six abilities has a tooltip showing how the score has
been calculated; you can see this by bringing the Adventure Sheet to the front (by clicking
the window title-bar) and letting the mouse linger over an ability.
Some book locations contain a 'cache' - a place you can leave items or money.
Double-clicking on an item or money will allow you to transfer stuff between these caches
and your Adventure Sheet. There are also popup context menus which will list
all the options available.
Games are saved to files with the extension '.dat'. The 'Quicksave' and 'Quickload' options
save to and from the file 'savegame.dat'. You can select a saved game in the file browser
to see the character's name, rank, and profession, their location, and the date at which that
game was saved. If this information doesn't come up, that game can't be loaded in
this version.
This version introduces a new 'Hardcore' mode, which deletes a saved game after you've
loaded it and continued on. In this mode, you can also only save the game when you
stop playing. This is an easy system to get around, but I thought some players might
relish the thrill of playing without a safety net.
Each book came with a map of the region it covered; this is the 'local map' displayed in
the bottom right corner of the screen. A 'global map' is available from the menu; most of
the published books are concentrated near the top and center of this map.
The 'Extra Choice' menu usually lists only one option: Death. This will take you to the
section that handles the character's death, and is available because occasionally your
character is killed without an option of what to do next. This may sound nonsensical,
but death is not necessarily an end in this series...
If you survive long enough to own a ship or two, you can transfer crew and cargo between
them by using the 'Ship Transfer' menu item. Note that ships have to be in the same location
before this is enabled. A ship's name can be changed at any time by clicking on the name
and typing. You can also bring up another popup menu for each ship, allowing you to
dump cargo.
The main 'book' font can be changed via the 'Windows->Choose Font...' menu item.
Credits
-------
All source code is by Jonathan Mann.
Book text copyright Dave Morris & Jamie Thomson, 1996.
Illustrations copyright Russ Nicholson.
Thanks to Andy for creating PDFs of the books. Book 5 was typed up personally, but the
others could be converted far more quickly via cut and paste.
Thanks to Andy and Simon for scanning the book illustrations (I lack scanner-fu).
Thanks to all the bug-finders for improving the game and keeping me honest!
Bugs
----
Many, probably. If you discover some, please email me at the address below
or ask for help in the project forums (https://sourceforge.net/projects/flapp/forums)
Changes in the code to deal with newly added books may break books that were previously
working; to find these problems I need to either a) be psychic, or b) have good testers.
A very happy Holy Day of the Recantation of the Soul to all.
--jonathan mann (jemann75@yahoo.com)
--November '17