File: README

package info (click to toggle)
exult 0.98rc1-2
  • links: PTS
  • area: contrib
  • in suites: woody
  • size: 6,924 kB
  • ctags: 8,928
  • sloc: cpp: 83,768; sh: 7,643; ansic: 4,328; makefile: 890; yacc: 618; lex: 255; xml: 19
file content (648 lines) | stat: -rw-r--r-- 27,493 bytes parent folder | download
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
ExultDocumentation
last changed: 07 March 2002(GMT)

The latest version of this document can be found at http://exult.sourceforge.net/docs.php


0. Changes to the Documentation
0.1. - 07 March 2002
0.2. - 07 January 2002
0.3. - 25 November 2001

1. Introduction
1.1. What is Exult?

2. Configurations
2.1. Installation
2.2. Settings in exult.cfg
2.3. Path-Settings
2.4. Command line options

3. Audio
3.1. Music
3.2. Abilities and limitations of the music engine
3.3. Windows MIDI Mapper
3.4. Digital Wave Sound Effects
3.5. Speech
3.6. Turn off Audio

4. Video
4.1. Resolution
4.2. Scaler

5. Movement and Keys
5.1. Movement
5.2. Keyboard commands
5.3. Cheat keys

6. Game Menu
6.1. Access to the Game menu
6.2. Load/Save Game
6.3. Video Options
6.4. Audio Options
6.5. Gameplay Options
6.6. Quit to Menu
6.7. Quit

7. OS specific notes
7.1. Error Log

8. Credits and Contact
8.1. Thanks
8.2. Contacting us


--------------------------------------------------------------------------------

0. Changes to the Documentation
0.1. - 07 March 2002
* 2.2. Settings in exult.cfg added <combat><difficulty> and <right_click_closes_gumps>.
* 2.4. Command line options buildmap requires Exult to run in windowed mode.
* 4.2. Scaler BillinearPlus.
* 6.5. Gameplay Options Right click closes Gump added.



0.2. - 07 January 2002
* 2.2. Settings in exult.cfg added <force_wavout> and <looping>.
* 2.4. Command line options Some parameters for whoever dares to use them.
* 6.4. Audio Options looping added.
* 6.6. Quit to Menu removed in snapshots.



0.3. - 25 November 2001
* 2.2. Settings in exult.cfg added <save_compression_level> to zip up savegames, <waves> no longer needs path set if in data dir.
* 3.4. Digital Wave Sound Effects no longer needs paths for sfx pack (if in data dir).
* 4.2. Scaler updated link To Derek Liauw's scaler page.




--------------------------------------------------------------------------------

1. Introduction
1.1. What is Exult?
Ultima 7, an RPG from the early 1990's, still has a huge following. But, being a DOS game with a very nonstandard memory manager, it is difficult to run it on the latest computers. Exult is a project to create an Ultima 7 game engine that runs on modern operating systems, capable of using the data and graphics files that come with the game.
Exult is being developed in C++ under Linux, MacOS and Windows using the SDL library to make porting to other platforms relatively easy. The current version supports much of the game's plot, allowing you to talk to NPCs, use items, solve quests, and even fight monsters. Music, speech, and the full introduction are also implemented. This, and further development, is only possible due to the work done by other fans who have decoded the various Ultima 7 data files, especially Gary Thompson, Maxim Shatskih, Jakob Shonberg, and Wouter Dijkslag.
Exult aims to let those people who own Ultima 7 (copyright 1993) play the game on modern hardware, in as close to (or perhaps even surpassing) its original splendor as is possible. You need to own "Ultima 7: The Black Gate" in order to use Exult, and we encourage you to buy a legal copy.



--------------------------------------------------------------------------------

2. Configurations
2.1. Installation
* First you need to get Ultima 7. Either you own it already, or you buy it somewhere. Then you must install it on a DOS/Windows machine to get the data files. Alternatively you can use a PC emulator to install it. The Ultima Collection already contains a pre-installed version of U7 (in the directory /ultima7 on the CD).
* From the Ultima7 folder on your PC, copy the STATIC sub folder to an appropriate folder - see 2.3. what those could be.
* Now run exult (exult.exe in Windows) and quit it immediately.
* Edit the configuration file with the correct paths for the game folders and sfx files - see 2.2.
* Run exult and enjoy the game :-)

Word of advice: Don't mix the files from BG and SI.
Important: Do not run Exult on an original Ultima7 game which you're actually in the middle of playing, as Exult's saved files have a different format. There is no way to convert those original savegames and they will just crash Exult.


2.2. Settings in exult.cfg
Exult keeps a configuration file. You can specify where your Ultima 7 installation is, whether you want fullscreen graphics, or windowed, and midi devices and midi settings. Some of these options can be set from the Setup menu when you run Exult or via the Game menu.
If you do not already have a configuration file, Exult will make one for you filling in sensible defaults by itself. The location of this file varies slightly. On UNIX systems you can expect to find it in $HOME/.exult.cfg while other operating systems will probably locate it as 'exult.cfg' in the same directory as the Exult binary. However it is recommended that you edit this file by hand to achieve optimal results for your system.
The file uses a simple hierarchical XML-like syntax, which should be simple to understand and modify. Take care though. Handling of syntax errors in this file is not well tested.
Okay, the default file looks like this (do not copy the **and following - these are my remarks).
Note: yes means enabled, no means disabled
<config>
<disk>
<save_compression_level>
1
						**Savegames are now compressed as zip files. 1 enables compression,
						2 disables it.
						
</save_compression_level>
<data_path>
data
						**see  for pathsettings
						
</data_path>
<game>
<blackgate>
<path>
./blackgate
</path>
<title>
blackgate
</title>
<keys>
(default)
						**configure custom keybindings or leave the (default)
						- see 
</keys>
<waves>
jmsfx.flx
						**optional setting see  for configuration
						
</waves>
</blackgate>
<serpentisle>
<path>
./serpentisle
</path>
<keys>
(default)
</keys>
<waves>
jmsisfx.flx
						**optional setting see  for configuration
						
</waves>
</serpentisle>
</game>
</disk>
<debug>
<trace>
<usecode>
no
						**options are yes/no/verbose. This is used to trace the 
						executed Usecode (you shouldn't need this unless you are a programmer).
						
</usecode>
</trace>
</debug>
<gameplay>
<double_click_closes_gumps>
no
						**doesn't need an explanation, right?
						
<double_click_closes_gumps>
<right_click_closes_gumps>
no
						**same as above
						
<right_click_closes_gumps>
<cheat>
yes
						**enable/disable cheats for that
						
</cheat>
<skip_intro>
no
						**this skips the intro in BG when you started a new game; Iolo talks to
						Peter, the Avatar appears, Iolo talks to you, the mayor talks to you and so on.
						
</skip_intro>
<skip_splash>
no
						**this skips the splash screen, the intro before you get to the
						game menu, disabling it brings you straight to the game menu
						
</skip_splash>
<facestats>
0
						**activates the status faces and the position on the screen.
						-1 disable,0 right, 1 middle, 2 right.
						
</facestats>
<mouse3rd>
no
						**yes enables using of the middle mouse button.
						
</mouse3rd>
<fastmouse>
no
						**yes enables faster cursor movement in fullscreen mode.
						
</fastmouse>
<bg_paperdolls>
no
						**yes enables SI style paperdolls in BG.
						
</bg_paperdolls>
<walk_after_teleport>
no
						**when set to no you stop after walking onto a teleporter.
						
</walk_after_teleport>
<combat>
<difficulty>
0
						**0 is default, negative values make combat easier, positive makes it 
						harder. It affects the chance of a hit, and the HP's lost if a hit occurs.
						
</difficulty>
</combat>
</gameplay>
<audio>
<enabled>
yes
						**enable/disable all audio - this takes precedence over the 
						other audio settings (you can change this in game via
						Esc - the setting is saved)
						
</enabled>
<force_waveout>
no
						**yes forces Exult to use waveout instead of directsound. This may
						fix problems some people have with Exult and sound in Windows 
						(it's a Windows-only option)
						
</enabled>
<effects>
<enabled>
yes
						**enable/disable sound effects (you can change this in game via
						Esc - the setting is saved)
						
</enabled>
</effects>
<midi>
<enabled>
yes
						**enable/disable MIDI effects (you can change this in game via
						Esc - the setting is saved)
						
</enabled>
<convert>
gm
						**see 
</convert>
<volume_curve>
1.000000
   						**set volume (kind of at least, best don't change)
   						
</volume_curve>
<win32_device>
-1
   						**choose the Windows MIDI Device. See 
</win32_device>
<looping>
Yes
   						**No disables muisc looping. See 
</looping>
</midi>
<speech>
<enabled>
yes
						**enable/disable speech (you can change this in game via
						Esc - the setting is saved)
						
</enabled>
</speech>
</audio>
<video>
<width>
320
						**here you choose your resolution, it can be as big as your
						monitor allows. 320x200 is the resolution of the original.
						
</width>
<height>
200
</height>
<scale>
2
						**2 enables / 1 disables scaling, some scalers support higher values.
						See .
						
</scale>
<fullscreen>
yes
						**do you want to play fullscreen?
						
</fullscreen>
<disable_fades>
no
						**"no" enables fading between different menu points
						
</disable_fades>
<scale_method>
SuperEagle
						**choose different scalers here - see 
</scale_method>
<gamma>
						**set gamma levels to adjust brightness, same as +/- in game
						
<red>
1
</red>
<green>
1
</green>
<blue>
1
</blue>
</gamma>
<fps>
10
   						**Speed setting. Might help when the game seems too slow or too fast.
   						
</fps>
</video>
</config>


2.3. Path-Settings
You have two choices on how to setup Exult.
The first one is very easy, just extract all the files from the compiled snapshot archive to the directory where you have The Black Gate or Serpent Isle installed. Concerning the paths you don't have to configure anything.
The other is a little more complicated but appeals to control freaks like me: Make a directory c:\ultima7 make two subfolders named "blackgate" and "serpentisle" (without the quotes of course) Extract or install the two Ultima 7 games into the appropriate folder ("The Black Gate" to c:\ultima7\blackgate and "Serpent Isle" to c:\ultima7\serpentisle) Extract the compiled Exult to c:\ultima7 Now you have to edit the exult.cfg file like this:
<disk>
<data_path>
data
</data_path>
<game>
<blackgate>
<path>
./blackgate
</path>
<title>
blackgate
</title>
</blackgate>
<serpentisle>
<path>
./serpentisle
</path>
</serpentisle>
</game>
</disk>
You can either use the relative (./blackgate) or absolute (c:\ultima\blackgate) path to point to the correct directory.


2.4. Command line options
Exult offers some "hidden" command line options:
* -h or --help Shows all the command line parameters in stderr (stderr.txt on Windows systems)
* -v or --version Shows version information in stderr
* --bg Starts the game with the Black Gate menu
* --si Starts the game with the Serpent Isle menu
* --nocrc Recently we added a crc check that Exult doesn't start when the exult*.flx files in the data dir aren't the same it got compiled with. This parameter lets the game start nethertheless. Don't try this if you don't know what you are doing.
* --buildmap x x = 0 shows all roofs, x = 2 pops them all. You have to specify the game first (Example: exult --bg buildmap 0). Builds the map of the game specified.The map is huge and in pcx format, you will need a lot of ram to even look at this map once it is build (and even that requires a lot of patience) Exult is required to be run in windowed mode and you get the best map if you started a new game before you build the map.
* --game gamename Unused yet. Loads a game specified in exult.cfg when there are other games made with Exult Studio.




--------------------------------------------------------------------------------

3. Audio
3.1. Music
Midi in Exult is played by firstly loading a file and passing it to the XMIDI class for instrument mapping conversion. This is so the MT32 mapped music files from the original Ultima 7 and Serpent Isle will be playable on modern General Midi and General Midi/GS supporting sound cards. You can change the way the music sounds via the setup or ingame menu or the exult.cfg file.
Exult gives users various option for converting Music and Midi Sound Effects. Currently the only way to set the options is via manually editing the config file. Note, the options are case sensitive and all options must be lowercase. Below is a description of all the modes:
* gm This will convert the MT32 patches to standard General Midi patches. Conversion is fairly accurate but some instruments may be different.
* gs This will convert the MT32 patches to their equivalent GS patches. This will be a more accurate conversion that straight gm since more of the MT32 patches are in the GS set. However, not all midi devices will support this mode.
* gs127 This option is for midi devices that have a MT32 patch bank installed in Bank 127. Some GS implementation have this, some don't. Only use this if you know that you have a MT32 implementation on Bank 127.
* none This option will output the music with nothing changed. Because the mapping will be for MT32s you should only use this option if you have a MT32 compatible device or you have replaced the music.

The order of music conversion quality is:
1. none (shouldn't really be used, though)
2. gs127
3. gs
4. gm

NOTE: Currently the conversion to GS and GS127 is not finished and the notes are only mapped to General Midi.


3.2. Abilities and limitations of the music engine
Due to the way the class was constructed input can be in either .mid, .rmi or the Miles Sound System .xmi format. There are no limitations to they types of .mid and .rmi supported. They can be Type 0, 1 and the rarely seen type 2. The loading routine is also fairly lenient of erroneous XMIDI files that do not have correct XMIDI headers.
During the development of the XMIDI class it was found that certain .xmi files in Serpent Isle had the first patch changes after the first note. The converter will attempt to correct these errors. However it may cause problems with some midi files. Currently this can not be disabled and may change in the future.


3.3. Windows MIDI Mapper
You can now tell Exult which MIDI device it should use. Useful if you want Exult to use a different MIDI device than the default Windows device (like an MT-32).
To do this start Exult, on the menu choose "Exit". Now open the file stdout.txt in the folder where exult.exe is located. You will see a listing of the midi devices. For example with an SB Live! in Win2k it will look like this:
4 Midi Devices Detected Listing midi devices: -1: Microsoft MIDI-Mapper 0: A: SB Live! MIDI Synth 1: B: SB Live! MIDI Synth 2: SB Live! MIDI UART
By default Exult uses the Microsoft MIDI-Mapper (which uses the device you choose in the Windows Multimedia Properties). To change the MIDI Device open exult.cfg and change
<win32_device>
-1
</win32_device>
with the device you want to use.


3.4. Digital Wave Sound Effects
Exult needs the so called sfx packs to enable sound effects for Ultima 7. You have to download separate packs for each game as order of the sfx in BG and SI varies a bit and otherwise will sound odd. However there is a little issue with sfx playback in SI: In combat the sfx may be a little wrong as we still haven't figured out all the data in the 'weapons.dat'. Also Exult doesn't yet playback all the sfx that the orignal did.
Note that configuring your soundfonts is not needed for digital wave sfx.
The sfx pack made by Joseph Morris can be found at http://prdownloads.sourceforge.net/exult/jmsfx.zip (~4.55 MB) for "The Black Gate" and http://prdownloads.sourceforge.net/exult/jmsfxsi.zip (~6.01 MB) for "Serpent Isle". J.Morris recorded the original sfx used in BG and SI which meant a lot of work. Don't complain that the sfx sounds strange, instead load up the original and you will find that it sounds the same. Enjoy!
Extract the zip files into your Exult data directory and write down the name of the pack in your exult.cfg file (see 2.2.). You don't need to set correct paths anymore if the pack is in the data directory. An example of how the relevant part of exult.cfg looks with these packs:
<blackgate>
<waves>
jmsfx.flx
</waves>
</blackgate>
<serpentisle>
<waves>
jmsisfx.flx
</waves>
</serpentisle>


3.5. Speech
Exult can play the Ultima VII's speech through SDL, and its own internal mixer. Configuration is managed through Exult's configuration file.


3.6. Turn off Audio
Press 'Esc' to turn on/off Music, Speech and SoundFX or change the settings in exult.cfg - see 2.2..



--------------------------------------------------------------------------------

4. Video
4.1. Resolution
By default Exult runs at 320x200 (which is the resolution the original Ultima VII used). Exult can use different scaling engines to double the size to 640x400 and increase the quality of the graphics.
Using higher resolutions is considered cheating as you can see too much of the surrounding area. Since the game was designed to be played at a specific size, this can actually lead to plot-stopping problems; hence we will not fix any problem caused by your cheating! Don't say we didn't warn you :-) Actually being able to play in higher resolutions is one of the big advantages of Exult but as mentioned above it comes with a price.
Within the game you can use the 'Alt +' and 'Alt -' to switch resolution..


4.2. Scaler
The scalers also work with higher resolutions than 320x200. To change the scaling method either use the Exult menu or change your exult.cfg - see 2.2..
* SuperEagle by Derek Liauw. Only 2x.
* Super2xSai by Derek Liauw. Only 2x.
* 2xSaI by Derek Liauw. Only 2x.
* BilinearPlus same as Bilinear and it may even be a bit faster..
* Bilinear bilinear interpolation to smooth the result. Slower, but looks better. Only 2x.
* Point simple but very fast scaler. Only duplicates pixels, no fancy interpolation. Can be used for arbitrary integer scales (2x, 3x, 4x...).
* Interlaced identical to point except that it skips every other line to be even faster

The scalers by Derek Liauw are slower but look much better. Try out yourself which one you like most.
More information on the excellent scaling engines by Derek Liauw is available at http://elektron.its.tudelft.nl/~dalikifa/.



--------------------------------------------------------------------------------

5. Movement and Keys
5.1. Movement
* Hold right mouse button down to move Avatar.
* Double-click with the right mouse button will make the Avatar find a path to the selected spot.
* Click on objects with left button to identify them.
* Double-click on characters to hold conversations.
* Double-click on doors, shutters with left button to open or close them.

Note that on MacOS you have to hold down the 'Cmd' key and the mouse button to have the functionality of a right mouse button.


5.2. Keyboard commands
Starting with V0.91 Alpha2 all key commands can be changed. However, there is a default setting which closely follows the original with the addition of some improvements.
To change your key bindings first edit the file defaultkeys.txt in your Exult directory, change the bindings and save the file (e.g. as my_keys.txt). Now you have to change exult.cfg to use that file. You can even choose if you want to change your key bindings for BG or SI. See the keys settings at 2.2.. Change (default) to my_keys.txt.
During the game press 'h' to see a help screen with all the keys (for MacOS change Alt for Cmd - the in-game help screen shows the correct key combination for MacOS).

Default keyboard commands
+/- : Change brightness (you may have to use the keypad)
F4 : Toggle fullscreen
b : Use spellbook
c : Combat mode
f : Use food
g : Use Abacus
h : Show list of keyboard commands
i : Show inventory
j : SI: Show jawbone
k : BG: Try all keys to unlock a lock
k : SI: Use keyring
Alt-k : SI: Try all keys to unlock a lock
l : SI: Show combat stats
m : Show map
p : Use lockpicks
Alt-q : Exit game
r : Brings up status bars. First three strokes change the location of the bar. The fourth disables it again.
Ctrl-r : Quick restore
Ctrl-Alt-s : Screenshot
Ctrl-s : Quick save
s : Show save/load box
Esc : Show Game menu box and closes all open boxes
t : Target, instead of double clicking, shows a cursor and pauses the game until you click on something
v : About screen
w : Use watch, shows the time if you got a watch
Alt-x : Exit game
z : Show stats
1 : Show inventory for Avatar
2 : Show inventory for character 2
3 : Show inventory for character 3
4 : Show inventory for character 4
5 : Show inventory for character 5
6 : Show inventory for character 6
7 : Show inventory for character 7
8 : Show inventory for character 8
In conversations you now have the ability not just click on the answer with the mouse but also to use the numeric keys. The response options aren't numbered visually but logically with the dots. Also press 'Esc' to select "bye" if possible.


5.3. Cheat keys
Press 'ctrl-h' during the game to see a help screen with all the cheat keys.

Cheat commands
Alt-+/- : Switch resolution( you may have to use the keypad)
Arrow keys : Scroll map
Home : Recenter map
F2 : Cheat screen similar to the originals'. Allows for some level of NPC editing and other cheat options
F3 : Map teleport
F10 : Show endgame
F11 : SI: Play alternate intro
Ctrl-b : Shape browser
Ctrl-c : Create object
Ctrl-d : Delete object
e : Toggle egg display
Alt-g : Toggle God mode
Ctrl-g : Change avatar gender
Ctrl-Alt-h : Resurrect, heal party, cure poison and still hunger
Alt-i : Toggle infravision
Ctrl-l : Level up party
l : Decrement skiplift
Alt-h : Hackmover (you can move all objects around and it disables weight check
Ctrl-Alt-m : Toggle Map editor (useful for Exult Studio)
Ctrl-m : Get 100 gold coins
Alt-Shift-m : Play previous song
Alt-m : Play next song
Alt-n : SI: Toggle naked flag
Alt-p : SI: Toggle Petra mode
Alt-s : SI: Change skin color
Ctrl-Alt-t : Map teleport
Ctrl-t : Advance to next time period
Alt-t : Teleport (to current cursor position)
Alt-w : Toggle archwizard mode (all spells etc.)
Alt-1 : Test music, sfx, speech
Ctrl-Alt-g : Grab NPC for cheat screen
Ctrl-Alt-p : Pick pocket cheat, when enabled double-clicking on a NPC displays the actors inventory
Ctrl-n : NPC number, When enabled, clicking an a NPC will display their number instead of their name. Useful for the cheat screen.



--------------------------------------------------------------------------------

6. Game Menu
6.1. Access to the Game menu
You can access the Game menu either by pressing the disk icon in the Avatar's inventory screen or by pressing 'Esc' . You then have the following options.


6.2. Load/Save Game
This on is pretty straightforward. You can load and save a game, delete a game and view some information of a savegame on the right side (a screenshot and some stats). If you have a wheelmouse you can scroll one line up/down by using the wheel. Pressing 'Alt' while using the wheel scrolls by pages. Pressing Cancel exits the Load/Save options.


6.3. Video Options
In this option screen you are able to determine how Exult displays the game.
* Resolution lets you choose between various resolutions. You can choose between 320x200, 320x240, 400x300, 512x384 and 640x480. If you want higher resolutions edit the exult.cfg file as outlined in 2.2. Settings in exult.cfg.
* Scaling choose between 1x and 2x. What it does is explained in 4.2. Scaler.
* Scaler lets you choose your favorite scaling engine. Also look at 4.2. Scaler for an explanation.
* Full Screen enable or disable running Exult in full screen.
* OK/Cancel Ok accepts your changes, Cancel discards your changes.



6.4. Audio Options
Look at 3. Audio to see explanation on the settings.
* Audio Enable or disable all Audio in Exult.
* Music Enable or disable music.
* Conversion choose between None, GM, GS, GS127.
* Reverb alters the way the midi is played. Enable or disable to hear if you like it.
* Chorus the same as Reverb
* Looping Disable restores the (broken) way the original handeled the music looping flag.
* SFX Enable or disable digital sound effects.
* Speech Options Enable or disable the speech in the games.
* OK/Cancel Ok accepts your changes, Cancel discards your changes.



6.5. Gameplay Options
* Status Bars You can either disable the status bars or choose its position on the bottom of the screen (left, middle, right).
* Text Background shows a tinted background behind text in conversations to make it easier to read. Either disable it or choose between the colours purple, orange, light gray, green, yellow,pale blue, dark green, red, bright white, dark gray and white.
* Paperdolls only available in Black Gate. Enables or disable Paperdolls (inventory screen) in the style of Serpent Isle.
* Walk after teleport only available in Serpent Isle. The normal behavior is that you stop walking after you have been teleported. This enables walking on.
* Fast Mouse makes the mouse cursor move faster in fullscreen modes. Enable or disable it.
* Use middle mouse button In the normal game, the middle mouse button activates the target-function (which could also be accomplished by pressing 't' ). For modal gumps, the middle mouse acts as 'return', the right button as 'escape', so you can now for example accept the default slider value by just pressing the middle button. The escape function is also available during most other actions like selecting a target or conversations. Enable or disable it.
* Doubleclick closes gumps pretty straightforward, right?
* Right click closes gumps the same but different.
* Cheats Enables or disables all the cheats that we implemented in Exult. See 5.3. Cheat keys what those cheats are.
* Speed if Exult seems too fast lower this setting. If it seems to sluggish raising this setting may help.
* OK/Cancel Ok accepts your changes, Cancel discards your changes.



6.6. Quit to Menu
This is not implemented yet and just quits Exult. When it eventually works you will be back to the Exult menu where you choose which game you want to play. It is actually more difficult to implement than it sounds so don't expect it too soon.
In snapshots after the Beta 1 release this option is no longer availlable.


6.7. Quit
Exits Exult.



--------------------------------------------------------------------------------

7. OS specific notes
7.1. Error Log
* MacOS/Win32: Exult generates the files 'stdout.txt' and 'stderr.txt'. These may give you some idea of what is going on under the hood. When Exult suddenly quits, sometimes these files can help.
* UNIX/UNIX clones: the above mentioned logs are shown in the console from which Exult is started. ./exult >&log will send both stderr and stdout to the file named "log".




--------------------------------------------------------------------------------

8. Credits and Contact
8.1. Thanks
* The paper by Gary Thompson on the structure of the U7 data files was crucial to the early development of Exult.
* Work by Maxim Shatskih, Jakob Shonberg, and Wouter Dijkslag made the "usecode" interpreter possible.
* Olivier Marcoux's technical document was also crucial in understanding some data files.
* Thanks also go to the person who wrote u7items.txt and the contributor of the "avatar.ttf" font.



8.2. Contacting us
You can contact the Exult team and/or get more information from: http://exult.sourceforge.net/ or http://sourceforge.net/projects/exult/