-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
2473 lines (2019 loc) · 102 KB
/
README
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
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
Cabal README
------------------------------------------------------------------------
For more information, compatibility lists, the latest release, progress
reports and more, please visit the Cabal home page at: http://project-cabal.org/
Table of Contents:
------------------
1.0) Introduction
* 1.1 About Cabal
* 1.2 Quick start
2.0) Contact
* 2.1 Reporting Bugs
3.0) Supported Games
* 3.1 Copy Protection
* 3.2 Day of the Tentacle notes
* 3.3 Commodore64 games notes
* 3.4 Maniac Mansion NES notes
* 3.5 Macintosh games notes
* 3.6 Multi-CD games notes
* 3.7 The Curse of Monkey Island notes
* 3.8 Broken Sword games notes
* 3.9 Beneath a Steel Sky notes
* 3.10 Flight of the Amazon Queen notes
* 3.11 Gobliiins notes
* 3.12 Inherit the Earth: Quest for the Orb notes
* 3.13 Simon the Sorcerer notes
* 3.14 The Feeble Files notes
* 3.15 The Legend of Kyrandia notes
* 3.16 Sierra AGI games Predictive Input Dialog notes
* 3.17 Mickey's Space Adventure notes
* 3.18 Winnie the Pooh notes
* 3.19 Troll's Tale notes
* 3.20 Dragon History notes
* 3.21 Simultaneous speech and subtitles in Sierra SCI games
* 3.22 Known Problems
4.0) Supported Platforms
5.0) Running Cabal
* 5.1 Command Line Options
* 5.2 Language Options
* 5.3 Graphics Filters
* 5.4 Global Menu
* 5.5 Hotkeys
6.0) Saved Games
* 6.1 Autosaves
* 6.2 Converting saved games
* 6.3 Viewing/Loading saved games from the command line
7.0) Music and Sound
* 7.1 AdLib emulation
* 7.2 FluidSynth MIDI emulation
* 7.3 MT-32 emulation
* 7.4 MIDI emulation
* 7.5 Native MIDI support
* 7.6 UNIX native, ALSA and dmedia sequencer support
* 7.7 TiMidity++ MIDI server support
* 7.8 Using compressed audio files (MP3, Ogg Vorbis, Flac)
* 7.9 Output sample rate
8.0) Configuration file
* 8.1 Recognized configuration keywords
* 8.2 Custom game options that can be toggled via the GUI
9.0) Compiling
1.0) Introduction:
---- -------------
1.1) About Cabal:
---- --------------
Cabal is a program which allows you to run certain classic games,
provided you already have their data files. Cabal is intended to be a
drop-in replacement for the original executables for the games,
allowing you to play them on systems for which they were never designed!
This was originally based on the ScummVM codebase, but has since forked.
Originally, that project was designed to run LucasArts' SCUMM games, such
as Maniac Mansion, Monkey Island, Day of the Tentacle or Sam and Max. SCUMM
stands for 'Script Creation Utility for Maniac Mansion', which was the first
game for which LucasArts designed this system. And much later it gave
its name to ScummVM ('VM' meaning Virtual Machine).
Over time support for a lot of non-SCUMM games has been added, and
Cabal now also supports many of Sierra's AGI and SCI games (such as King's
Quest 1-6, Space Quest 1-5, ...), Discworld 1 and 2, Simon the Sorcerer 1 and
2, Beneath A Steel Sky, Lure of the Temptress, Broken Sword I and II, Flight of
the Amazon Queen, Gobliiins 1-3, The Legend of Kyrandia series, many of
Humongous Entertainment's children's SCUMM games (including Freddi Fish and
Putt Putt games) and many more. You can find a full list with details on which
adventures are supported and how well on the compatibility page.
Among the systems on which you can play those games are regular desktop
computers (running Windows, Linux, Mac OS X, ...), game consoles
(Dreamcast, Nintendo DS & Wii, PS2, PSP, ...), smartphones (Android,
iPhone, PocketPC, Symbian ...) and more.
1.2) Quick start:
---- ------------
For the impatient among you, here is how to get Cabal running in five
simple steps.
1. Download Cabal from <http://project-cabal.org/downloads> and
install it.
2. Create a directory on your hard drive and copy the game datafiles
from the original media to this directory. Repeat this for every game
you want to play.
3. Start Cabal, choose 'Add game', select the directory with the game
datafiles (do not try to select the datafiles themselves!) and press
'Choose'.
4. A dialog should popup allowing you to configure various settings if
you wish to (it should be just fine to leave everything at its default,
though). Confirm the dialog.
5. Select the game you want to play in the list, and press 'Start'.
In the future, you should be able to directly skip to step 5, unless you
want to add more games.
Hint: If you want to add multiple games in one go, try pressing and
holding the shift key before clicking 'Add game' -- its label will
change to 'Mass Add' and if you press it, you are again asked to select
a directory, only this time Cabal will search through all
subdirectories for supported games.
2.0) Contact:
---- --------
The easiest way to contact the Cabal team is by submitting bug reports
(see section 2.1) or joining us on IRC (#project-cabal on irc.freenode.net).
Please do not ask us to support an unsupported game -- doing that is an immense
amount of work.
2.1) Reporting Bugs:
---- ---------------
To report a bug, please create an issue on the GitHub page:
https://github.com/project-cabal/cabal/issues
Please make sure the bug is reproducible, and still occurs in the latest
git/Daily build version. Also check the known problems list (below) and
the compatibility list on our website for that game, to ensure the issue is
not already known:
http://project-cabal.org/compatibility/
Please do not report bugs on games that are not listed as being
completable in the 'Supported Games' section, or compatibility list. We
-know- those games have bugs.
Please include the following information:
- Cabal version (PLEASE test the latest git/Daily build)
- Bug details, including instructions on reproducing
- Language of game (English, German, ...)
- Version of game (talkie, floppy, ...)
- Platform and Compiler (Win32, Linux, FreeBSD, ...)
- Attach a saved game if possible
- If this bug only occurred recently, please note the last version
without the bug, and the first version including the bug. That way
we can fix it quicker by looking at the changes made.
Finally, please report each issue separately; do not file multiple issues
on the same ticket. (Otherwise, it gets difficult to track the status of
each individual bug).
3.0) Supported Games:
---- ----------------
At the moment the following games have been reported to work, and should
be playable to the end:
SCUMM Games by LucasArts:
Maniac Mansion [maniac]
Zak McKracken and the Alien Mindbenders [zak]
Indiana Jones and the Last Crusade [indy3]
Loom [loom]
The Secret of Monkey Island [monkey]
Monkey Island 2: LeChuck's Revenge [monkey2]
Indiana Jones and the Fate of Atlantis [atlantis]
Day of the Tentacle [tentacle]
Sam & Max Hit the Road [samnmax]
Full Throttle [ft]
The Dig [dig]
The Curse of Monkey Island [comi]
AGI and preAGI Games by Sierra:
The Black Cauldron [bc]
Gold Rush! [goldrush]
King's Quest I [kq1]
King's Quest II [kq2]
King's Quest III [kq3]
King's Quest IV [kq4]
Leisure Suit Larry in the Land of the
Lounge Lizards [lsl1]
Mixed-Up Mother Goose [mixedup]
Manhunter 1: New York [mh1]
Manhunter 2: San Francisco [mh2]
Police Quest I: In Pursuit of the Death
Angel [pq1]
Space Quest I: The Sarien Encounter [sq1]
Space Quest II: Vohaul's Revenge [sq2]
Fanmade Games [agi-fanmade]
Mickey's Space Adventure [mickey]
Troll's Tale [troll]
Winnie the Pooh in the Hundred Acre Wood [winnie]
AGOS Games by Adventuresoft/Horrorsoft:
Elvira - Mistress of the Dark [elvira1]
Elvira II - The Jaws of Cerberus [elvira2]
Personal Nightmare [pn]
Waxworks [waxworks]
Simon the Sorcerer 1 [simon1]
Simon the Sorcerer 2 [simon2]
Simon the Sorcerer's Puzzle Pack
- Demon In My Pocket [dimp]
Simon the Sorcerer's Puzzle Pack
- Jumble [jumble]
Simon the Sorcerer's Puzzle Pack
- NoPatience [puzzle]
Simon the Sorcerer's Puzzle Pack
- Swampy Adventures [swampy]
The Feeble Files [feeble]
Composer Games by Animation Magic:
Darby the Dragon [darby]
Gregory and the Hot Air Balloon [gregory]
Magic Tales: Liam Finds a Story [liam]
The Princess and the Crab [princess]
Sleeping Cub's Test of Courage [sleepingcub]
GOB Games by Coktel Vision:
Bambou le sauveur de la jungle [bambou]
Bargon Attack [bargon]
Fascination [fascination]
Geisha [geisha]
Gobliiins [gob1]
Gobliins 2 [gob2]
Goblins 3 [gob3]
Lost in Time [lostintime]
Once Upon A Time: Little Red Riding Hood [littlered]
The Bizarre Adventures of Woodruff
and the Schnibble [woodruff]
Urban Runner [urban]
Ween: The Prophecy [ween]
Living Books Games:
Aesop's Fables: The Tortoise and the Hare [tortoise]
Arthur's Birthday [arthurbday]
Arthur's Teacher Trouble [arthur]
Dr. Seuss's ABC [seussabc]
Green Eggs and Ham [greeneggs]
Harry and the Haunted House [harryhh]
Just Grandma and Me [grandma]
Little Monster at School [lilmonster]
Ruff's Bone [ruff]
Sheila Rae, the Brave [sheila]
Stellaluna [stellaluna]
The Berenstain Bears Get in a Fight [bearfight]
The Berenstain Bears in the Dark [beardark]
The New Kid on the Block [newkid]
MADE Games by Activision:
Leather Goddesses of Phobos 2 [lgop2]
Return to Zork [rtz]
Rodney's Funscreen [rodney]
The Manhole [manhole]
Other Games:
3 Skulls of the Toltecs [toltecs]
Blue Force [blueforce]
Beneath a Steel Sky [sky]
Broken Sword: The Shadow of the Templars [sword1]
Broken Sword II: The Smoking Mirror [sword2]
Bud Tucker in Double Trouble [tucker]
Cruise for a Corpse [cruise]
Discworld [dw]
Discworld 2: Missing Presumed ...!? [dw2]
Dragon History [draci]
Drascula: The Vampire Strikes Back [drascula]
DreamWeb [dreamweb]
Eye of the Beholder [eob]
Eye of the Beholder II: The Legend of
Darkmoon [eob2]
Flight of the Amazon Queen [queen]
Future Wars [fw]
Hopkins FBI [hopkins]
Hugo's House of Horrors [hugo1]
Hugo 2: Whodunit? [hugo2]
Hugo 3: Jungle of Doom [hugo3]
I Have No Mouth, and I Must Scream [ihnm]
Inherit the Earth: Quest for the Orb [ite]
Nippon Safes Inc. [nippon]
Lands of Lore: The Throne of Chaos [lol]
Lure of the Temptress [lure]
Mortville Manor [mortevielle]
Nippon Safes Inc. [nippon]
Ringworld: Revenge Of The Patriarch [ringworld]
Return to Ringworld [ringworld2]
Sfinx [sfinx]
Soltys [soltys]
TeenAgent [teenagent]
The Journeyman Project: Pegasus Prime [pegasus]
The Legend of Kyrandia [kyra1]
The Legend of Kyrandia: The Hand of Fate [kyra2]
The Legend of Kyrandia: Malcolm's Revenge [kyra3]
The 7th Guest [t7g]
The Neverhood [neverhood]
Tony Tough and the Night of Roasted Moths [tony]
Toonstruck [toon]
Touche: The Adventures of the Fifth
Musketeer [touche]
Voyeur [voyeur]
SCI Games by Sierra Entertainment:
Castle of Dr. Brain [castlebrain]
Codename: ICEMAN [iceman]
Conquests of Camelot [camelot]
Conquests of the Longbow [longbow]
EcoQuest: The Search for Cetus [ecoquest]
EcoQuest 2: Lost Secret of the Rainforest [ecoquest2]
Freddy Pharkas: Frontier Pharmacist [freddypharkas]
Hoyle's Book of Games 1 [hoyle1]
Hoyle's Book of Games 2 [hoyle2]
Hoyle's Book of Games 3 [hoyle3]
Hoyle Classic Card Games [hoyle4]
Jones in the Fast Lane [jones]
King's Quest I [kq1sci]
King's Quest IV [kq4sci]
King's Quest V [kq5]
King's Quest VI [kq6]
Laura Bow: The Colonel's Bequest [laurabow]
Laura Bow 2: The Dagger of Amon Ra [laurabow2]
Leisure Suit Larry 1 [lsl1sci]
Leisure Suit Larry 2 [lsl2]
Leisure Suit Larry 3 [lsl3]
Leisure Suit Larry 5 [lsl5]
Leisure Suit Larry 6 [lsl6]
Mixed-up Fairy Tales [fairytales]
Mixed-up Mother Goose [mothergoose]
Pepper's Adventures in Time [pepper]
Police Quest 1 [pq1sci]
Police Quest 2 [pq2]
Police Quest 3 [pq3]
Quest for Glory 1/Hero's Quest [qfg1]
Quest for Glory 1 [qfg1vga]
Quest for Glory 2 [qfg2]
Quest for Glory 3 [qfg3]
Slater & Charlie Go Camping [slater]
Space Quest I [sq1sci]
Space Quest III [sq3]
Space Quest IV [sq4]
Space Quest V [sq5]
The Island of Dr. Brain [islandbrain]
Wintermute Games:
Chivalry is Not Dead [chivalry]
Z-Vision Games by Activision:
Zork Nemesis: The Forbidden Lands [znemesis]
Zork: Grand Inquisitor [zgi]
SCUMM Games by Humongous Entertainment:
Backyard Baseball [baseball]
Backyard Baseball 2001 [baseball2001]
Backyard Baseball 2003 [baseball2003]
Backyard Football [football]
Backyard Football 2002 [football2002]
Bear Stormin' [brstorm]
Big Thinkers First Grade [thinker1]
Big Thinkers Kindergarten [thinkerk]
Blue's 123 Time Activities [Blues123Time]
Blue's ABC Time Activities [BluesABCTime]
Blue's Art Time Activities [arttime]
Blue's Birthday Adventure [BluesBirthday]
Blue's Reading Time Activities [readtime]
Fatty Bear's Birthday Surprise [fbear]
Fatty Bear's Fun Pack [fbpack]
Freddi Fish 1: The Case of the Missing
Kelp Seeds [freddi]
Freddi Fish 2: The Case of the Haunted
Schoolhouse [freddi2]
Freddi Fish 3: The Case of the Stolen
Conch Shell [freddi3]
Freddi Fish 4: The Case of the Hogfish
Rustlers of Briny Gulch [freddi4]
Freddi Fish 5: The Case of the Creature
of Coral Cove [freddicove]
Freddi Fish and Luther's Maze Madness [maze]
Freddi Fish and Luther's Water Worries [water]
Let's Explore the Airport with Buzzy [airport]
Let's Explore the Farm with Buzzy [farm]
Let's Explore the Jungle with Buzzy [jungle]
Pajama Sam: Games to Play on Any Day [pjgames]
Pajama Sam 1: No Need to Hide When It's
Dark Outside [pajama]
Pajama Sam 2: Thunder and Lightning
Aren't so Frightening [pajama2]
Pajama Sam 3: You Are What You Eat
From Your Head to Your Feet [pajama3]
Pajama Sam's Lost & Found [lost]
Pajama Sam's Sock Works [socks]
Putt-Putt Joins the Parade [puttputt]
Putt-Putt Goes to the Moon [puttmoon]
Putt-Putt Saves the Zoo [puttzoo]
Putt-Putt Travels Through Time [putttime]
Putt-Putt Enters the Race [puttrace]
Putt-Putt Joins the Circus [puttcircus]
Putt-Putt and Pep's Balloon-O-Rama [balloon]
Putt-Putt and Pep's Dog on a Stick [dog]
Putt-Putt & Fatty Bear's Activity Pack [activity]
Putt-Putt's Fun Pack [funpack]
SPY Fox 1: Dry Cereal [spyfox]
SPY Fox 2: Some Assembly Required [spyfox2]
SPY Fox 3: Operation Ozone [spyozon]
SPY Fox in Cheese Chase [chase]
SPY Fox in Hold the Mustard [mustard]
The following games should load, but are not yet fully playable. Play
these at your own risk, and please do not file bug reports about them.
If you want the latest updates on game compatibility, visit our web site
and view the compatibility chart.
Backyard Soccer [soccer]
Backyard Soccer MLS [soccermls]
Backyard Soccer 2004 [soccer2004]
Blue's Treasure Hunt [BluesTreasureHunt]
The following games are based on the SCUMM engine, but NOT supported
by Cabal (yet):
Moonbase Commander
Please be aware that the engines may contain bugs and unimplemented
features that sometimes make it impossible to finish the game. Save
often, and please file a bug report (instructions on submitting bug
reports are above) if you encounter such a bug in a 'supported' game.
3.1) Copy Protection:
---- ----------------
The Cabal team does not condone piracy. However, there are cases where
the game companies (such as LucasArts) themselves bundled 'cracked'
executables with their games -- in these cases the data files still
contain the copy protection scripts, but the interpreter bypasses them
(similar to what an illegally cracked version might do, only that here
the producer of the game did it). There is no way for us to tell the
difference between legitimate and pirated data files, so for the games
where we know that a cracked version of the original interpreter was
sold at some point, Cabal will always have to bypass the copy
protection.
In some cases Cabal will still show the copy protection screen. Try
entering any answer. Chances are that it will work.
Cabal will skip copy protection in the following games:
* Beneath a Steel Sky
-- bypassed with kind permission from Revolution Software.
* Dreamweb
-- a list of available commands in the in-game terminals is now shown
when the player uses the 'help' command
* Inherit the Earth: Quest for the Orb (Floppy version)
-- bypassed with kind permission from Wyrmkeep Entertainment,
since it was bypassed in all CD releases of the game.
* Loom (EGA DOS)
* Maniac Mansion
* Monkey Island 2: LeChuck's Revenge
* Simon the Sorcerer 1 (Floppy version)
* Simon the Sorcerer 2 (Floppy version)
-- bypassed with kind permission from Adventure Soft,
since it was bypassed in all CD releases of the game.
* The Secret of Monkey Island (VGA)
* Waxworks
* Zak McKracken and the Alien Mindbenders
3.2) Day of the Tentacle notes:
---- --------------------------
At one point in the game, you come across a computer that allows you
to play the original Maniac Mansion as an easter egg. Cabal supports
this, with a few caveats:
Cabal will scan your configuration file for a game that's in a
'Maniac' sub-folder of your Day of the Tentacle folder. If you've
copied the data files from the CD version, this should already be the
case but you have to add the game to Cabal as well.
To return to Day of the Tentacle, press F5 and select "Return to
Launcher".
This means that you could in theory use any game as the easter egg.
Indeed, there is a "secret" configuration setting, "easter_egg", to
override the ID of the game to run. Be aware, though, that not all
games support returning to the launcher, and setting it up to use Day
of the Tentacle itself as the easter egg game is not recommended.
3.3) Commodore64 games notes:
---- ------------------------
Both Maniac Mansion and Zak McKracken run but Maniac Mansion is not yet
playable. Simply name the D64 disks "maniac1.d64" and "maniac2.d64"
respectively "zak1.d64" and "zak2.d64", then Cabal should be able to
automatically detect the game if you point it at the right directory.
Alternatively, you can use 'extract_mm_c64' from the tools package to
extract the data files. But then the game will not be properly
autodetected by Cabal, and you must make sure that the platform is set
to Commodore64. We recommend using the much simpler approach described
in the previous paragraph.
3.4) Maniac Mansion NES notes:
---- -------------------------
Supported versions are English GB (E), French (F), German (G), Italian (I),
Swedish (SW) and English US (U). Cabal requires just the PRG section
to run and not the whole ROM.
In order to get the game working, you will have to strip out the first
16 bytes from the ROM you are trying to work with. Any hex editor will
work as long as you are able to copy/paste. After you open the ROM with
the hex editor, copy everything from the second row (17th byte) to the
end. After you do this, paste it to a new hex file. Name the new file
"Maniac Mansion (XX).prg" while XX stands for the version you are
working with (E, F, G, I, SW, or U). The final size should be exactly
262144 bytes.
If you add the game manually make sure that the platform is set to NES.
Most common mistakes which prevents the game from running:
* Bad file
* ROM extracted with the 0.7.0 tools
* You try to feed Cabal with the FULL ROM and not just the PRG
section.
It is also possible to extract the separate LFL files from the PRG
section. To do so use the 'extract_mm_nes' utility from the tools
package.
3.5) Macintosh games notes:
---- ----------------------
All LucasArts SCUMM based adventures, except COMI, also exist in versions
for the Macintosh. Cabal can use most (all?) of them, however, in some
cases some additional work is required. First off, if you are not using
a Macintosh for this, accessing the CD/floppy data might be tricky. The
reason for this is that the mac uses a special disk format called HFS
which other systems usually do not support. However, there are various
free tools which allow reading such HFS volumes. For example
"HFVExplorer" for Windows and "hfsutils" for Linux and other Unix-like
operating systems.
Most of the newer games on the Macintosh shipped with only a single data
file (note that in some cases this data file was made invisible, so you
may need extra tools in order to copy it). Cabal is able to directly
use such a data file; simply point Cabal at the directory containing
it, and it should work (just like with every other supported game).
We also provide a tool called 'extract_scumm_mac' in the tools package
to extract the data from these data files, but this is neither required
nor recommended.
For further information on copying Macintosh game files to your hard
disk see:
http://wiki.scummvm.org/index.php/HOWTO-Mac_Games
3.6) Multi-CD games notes:
---- ---------------------
In general, Cabal does not deal very well with Multi-CD games. This is
because Cabal assumes everything about a game can be found in one
directory. Even if Cabal does make some provisions for asking the user
to change CD, the original game executables usually installed a small
number of files to the hard disk. Unless these files can be found on all
the CDs, Cabal will be in trouble.
Fortunately, Cabal has no problems running the games entirely from
hard disk, if you create a directory with the correct combination of
files. Usually, when a file appears on more than one CD you can pick
either of them.
3.7) The Curse of Monkey Island notes:
---- ---------------------------------
For this game, you will need the comi.la0, comi.la1 and comi.la2 files.
The comi.la0 file can be found on either CD, but since they are
identical it doesn't matter which one of them you use.
In addition, you will need to create a "resource" subdirectory
containing all of the files from -both- "resource" subdirectories on the
two CDs. Some of the files appear on both CDs, but again they're
identical.
3.8) Broken Sword games notes:
---- -------------------------
The instructions for the Broken Sword games are for the Sold-Out
Software versions, with each game on two CDs, since these were the
versions most easily available at the time Cabal gained support for
them. Hopefully they are general enough to be useful to other releases
as well.
3.8.1) Broken Sword games cutscenes:
------ -----------------------------
The cutscenes for the Broken Sword games have a bit of a history (see
the next section, if you are interested), but in general all you need to
do is to copy the .SMK files from the "SMACKS" or "SMACKSHI" directories
on the CDs to the same directory as the other game data files. (Broken
Sword has a "SMACKSLO" directory with the same cutscenes, but these are
of lower quality.) You can put them in a subdirectory called "video" if
you find that neater.
For the PlayStation versions, you can dump the original videos off the
disc. For each of the files ending in an "STR" extension, you should
dump them as *raw* sectors off the disc (all 2352 bytes per sector). You
may also use the re-encoded cutscenes mentioned below instead, but this
will not work for all videos in Broken Sword II. For more information,
see:
http://wiki.scummvm.org/index.php/HOWTO-PlayStation_Videos
Some re-releases of the games, as well as the PlayStation version, do
not have Smacker videos. Revolution Software has kindly allowed us to
provide re-encoded cutscenes for download on our website:
http://www.scummvm.org/downloads.php
These cutscenes are provided in DXA format with FLAC audio. Their
quality is equal to the original games due to the use of lossless
compression. Viewing these cutscenes requires a version of Cabal
compiled with both FLAC and zlib support.
For systems that are too slow to handle the decoding of FLAC audio, the
audio for these cutscenes is also provided separately as OGG Vorbis
audio. Viewing these cutscenes with OGG Vorbis audio requires a version
of Cabal compiled with both libVorbis and zlib support.
For Broken Sword, we also provide a subtitles add-on. Simply unpack it
and follow the instructions in its readme.txt file. The subtitle pack
currently does not work when running PlayStation videos. (Broken Sword
II already has subtitles; no extra work is needed for them.)
3.8.2) Broken Sword games cutscenes, in retrospect:
------ --------------------------------------------
The original releases of the Broken Sword games used RAD Game Tools's
Smacker(tm) format. As RAD was unwilling to open the older legacy
versions of this format to us, and had requested we not reverse engineer
it, an alternative solution had to be found.
In Broken Sword II, it was possible to play back the voice-over without
playing the video itself. This remained a fallback until ScummVM 1.0.0,
but was never the only solution for any stable release.
In ScummVM 0.6.0 we used MPEG, which provided a reasonable trade-off
between size and quality. In ScummVM 0.10.0 this was superseded by DXA
(originally added for AdventureSoft's "The Feeble Files"). This gave us
a way of providing the cutscenes in the exact same quality as the
originals, at the cost of being larger.
Finally, in early 2006, the Smacker format was reverse engineered for
the FFmpeg project. Thanks to their hard work, ScummVM 1.0.0 now
supports the original cutscenes.
3.8.3) Broken Sword:
------ -------------
For this game, you will need all of the files from the clusters
directories on both CDs. For the Windows and Macintosh versions, you
will also need the speech.clu files from the speech directories, but
since they are not identical you will need to rename them speech1.clu
and speech2.clu for CD 1 and 2 respectively. The PlayStation version
requires the speech.tab, speech.dat, speech.lis, and speech.inf.
In addition, the Windows and Macintosh versions require a music
subdirectory with all of the files from the music subdirectories on
both CDs. Some of these files appear on both CDs, but in these cases
they are either identical or, in one case, so nearly identical that it
makes little difference. The PlayStation version requires tunes.dat and
tunes.tab.
3.8.4) Broken Sword II:
------ ----------------
For this game, you will need all of the files from the clusters
directories on both CDs. (Actually, a few of them may not be strictly
necessary, but the ones that I'm uncertain about are all fairly small.)
You will need to rename the speech.clu and music.clu files speech1.clu,
speech2.clu, music1.clu and music2.clu so that Cabal can tell which
ones are from CD 1 and which ones are from CD 2. Any other files that
appear in both cluster directories are identical. Use whichever you
like.
In addition, you will need the cd.inf and, optionally, the startup.inf
files from the sword2 directory on CD 1.
3.9) Beneath a Steel Sky notes:
---- --------------------------
Starting with ScummVM 0.8.0 you need the additional 'SKY.CPT' file to
run Beneath a Steel Sky.
This file is available on the 'Downloads' page of the ScummVM website.
You can place it in either the directory containing the other game data
files (SKY.DNR, SKY.DSK), in your extrapath, or in the directory where
your Cabal executable resides.
3.10) Flight of the Amazon Queen notes:
---- ---------------------------------
In order to use a non-freeware version of Flight of the Amazon Queen
(from original CD), you will need to place the 'queen.tbl' file
(available from the 'Downloads' page on our website) in either the
directory containing the 'queen.1' game data file, in your extrapath, or
in the directory where your Cabal executable resides.
Alternatively, you can use the 'compress_queen' tool from the tools
package to 'rebuild' your FOTAQ data file to include the table for that
specific version, and thus removing the run-time dependency on the
'queen.tbl' file. This tool also allows you to compress the speech and
sound effects with MP3, OGG or FLAC.
3.11) Gobliiins notes:
----- ----------------
The CD versions of the Gobliiins series contain one big audio track
which you need to rip (see the section on using compressed audio files)
and copy into the game directory if you want to have in-game music
without the CD in the drive all the time. The speech is also in that
track and its volume is therefore changed with the music volume control
as well.
3.12) Inherit the Earth: Quest for the Orb notes:
----- -------------------------------------------
In order to run the Mac OS X Wyrmkeep re-release of the game you will
need to copy over data from the CD to your hard disk. If you're on a PC
then consult:
http://wiki.scummvm.org/index.php/HOWTO-Mac_Games
Although it primarily talks about SCUMM games, it mentions the
"HFVExplorer" utility which you need to extract the files. Note that you
have to put the speech data "Inherit the Earth Voices" in the same
directory as the game data which is stored in:
Inherit the Earth.app/Contents/Resources
For the old Mac OS 9 release you need to copy the files in MacBinary
format, as they should include both resource and data forks. Copy all
'ITE *' files.
3.13) Simon the Sorcerer 1 and 2 notes:
----- ---------------------------------
If you have the dual version of Simon the Sorcerer 1 or 2 on CD, you
will find the Windows version in the main directory of the CD and the
DOS version in the DOS directory of the CD.
3.14) The Feeble Files notes:
----- -----------------------
To use the speech files with Cabal, they need to be renamed as follows:
Rename voices.wav on CD1 to voices1.wav
Rename voices.wav on CD2 to voices2.wav
Rename voices.wav on CD3 to voices3.wav
Rename voices.wav on CD4 to voices4.wav
3.15) The Legend of Kyrandia notes:
----- -----------------------------
To run The Legend of Kyrandia under Cabal you need the 'kyra.dat'
file. The file should always be included in official Cabal packages.
In case Cabal complains that the file is missing you can find it on the
'Downloads' page of the Cabal website. Note that the current Windows
release of Cabal should contain the file embedded into the executable,
thus you only need to grab it in case Cabal complains about the file
being missing.
3.16) Sierra AGI games Predictive Input Dialog notes:
----- -----------------------------------------------
The Predictive Input Dialog is a Cabal aid for running AGI engine
games (which notoriously require command line input) on devices with
limited keyboard support. In these situations, since typing with emulated
keyboards is quite tedious, commands can be entered quickly and easily
via the Predictive Input Dialog.
In order to enable predictive input in AGI games, you need to copy the
pred.dic file in the Cabal extras directory or the directory of the
game you wish to play. This dictionary has been created by parsing
through all known AGI games and contains the maximum set of common
words.
If the dictionary is detected, the Predictive Input Dialog is displayed
either when you click on the command line area (wherever keyboard input
is required, even in dialog boxes), or in some ports by pressing a
designated hot key.
The predictive input dialog operates in three modes, switchable by the
(*)Pre/123/Abc button. The primary input method is the predictive mode
(Pre) which resembles the way "fast typing" is performed at phones. The
alphabet is divided into 9 sets which naturally map to the 9 number keys
of the numeric keypad (0 is space). To type in a word, you press once
the number of the set which contains the letter of the word you intend
to type, then move on to the next. For example, to type the command
'look', you should press 5665. As you gradually type the intended word's
numeric code, the dictionary is accessed for known words matching your
input up to that point. As you press more keys, the prediction converges
to the correct word. This is why the printed word may change
dramatically between key presses. There exist situations though where
more than one words share the same numeric representation. For example
the words 'quit' and 'suit' map to the same number, namely 7848. In
these cases the (#)next button lights up. By pressing it, you can cycle
through the list of words sharing the same code and finally accept the
correct one by pressing (0)space or the Ok button.
The second input method (123) is the numeric input: Each key you press
is entered verbatim as a number.
The third input method (Abc) is the Multi-tap Alpha input mode. This
mode is intended for entering free text, without assistance from the
dictionary scheme of predictive (Pre) mode. The text is entered one
letter at the time. For each letter first press the number of the set
which contains the letter you want, then use the (#)next button to cycle
through the letters and repeat with another number. For example, to
enter the word 'look' you must press the following: 5##6##6##5#
The dialog is fully usable with the mouse, but a few provisions have
been made in some Cabal ports to make its use more comfortable by
naturally mapping the functionality to the numeric keypad. Also, the
dialog's buttons can be navigated with the arrow and the enter keys.
3.17) Mickey's Space Adventure notes:
----- -------------------------------
To run Mickey's Space Adventure under Cabal, the original executable
of the game (mickey.exe) is needed together with the game's data files.
There is extensive mouse support for the game under Cabal, even though
there wasn't any mouse support in the original game. Menu items can be
selected using the mouse, and it is possible to move to other locations
using the mouse as well. When the mouse cursor is hovered on the edges
of the screen, it changes color to red if it is possible to walk towards
that direction. The player can then simply click on the edges of the
game's screen to change location, similar to many adventure games, which
is simpler and more straightforward than moving around using the menu.
3.18) Winnie the Pooh notes:
----- ----------------------
It is possible to import saved games from the original interpreter of the
game into Cabal.
There is extensive mouse support for the game under Cabal, even though
there wasn't any mouse support in the original game. Menu items can be
selected using the mouse, and it is possible to move to other locations
using the mouse as well. When the mouse cursor is hovered on the edges
of the screen, it changes color to red if it is possible to walk towards
that direction. The player can then simply click on the edges of the
game's screen to change location, similar to many adventure games, which
is simpler and more straightforward than moving around using the menu.
3.19) Troll's Tale notes:
----- -------------------
The original game came in a PC booter disk, therefore it is necessary to
dump the contents of that disk in an image file and name it "troll.img"
to be able to play the game under Cabal.
3.20) Dragon History notes:
----- ---------------------
There are 4 language variants of the game: Czech, English, Polish and
German. Each of them is distributed in a separate archive. The only
official version is the Czech one, and the English, Polish and German
ports have always been work in progress and never officially released.
Although all texts are fully translated, it is known that some of them
contain typos.
There exists an optional Czech dubbing for the game. For bandwidth
reasons, you can download it separately and then unpack it to the
directory of the game. You can listen to the Czech dubbing with all
language variants of the game, while reading the subtitles.
All game files and the walkthrough can be downloaded from
http://www.ucw.cz/draci-historie/index-en.html
3.21) Simultaneous speech and subtitles in Sierra SCI games:
----- ------------------------------------------------------
Certain CD versions of Sierra SCI games had both speech and text
resources. Some have an option to toggle between the two, but there are
some cases where there wasn't any option to enable both simultaneously.
In Cabal, it is possible to enjoy a combined mode, where both speech
and text are shown at the same time. This mode can be toggled in the
Cabal audio options, but each game has different behavior in-game
regarding speech and text toggling.
The CD games where speech and subtitles can be shown simultaneously
are:
EcoQuest 1 CD
Freddy Pharkas CD
King's Quest 6 CD
Laura Bow 2 CD
Leisure Suit Larry 6 CD
Space Quest 4 CD
EcoQuest 1 CD:
Speech and text can be toggled via the game's "Mode" option in the
options dialog, or via Cabal's audio options.
Freddy Pharkas CD:
There is no in-game option to toggle speech and text. Only Cabal's
audio options can be used to toggle this feature. Note that some
spoken dialog is missing from the game texts.
King's Quest 6 CD:
Speech and text can be toggled via the "Mode" button in the options
dialog (with an extra "Dual" setting added in Cabal), or via
Cabal's audio options.
Laura Bow 2 CD:
Speech and text can be toggled via the "Mode" button in the options
dialog (with an extra "Dual" setting added in Cabal), or via
Cabal's audio options.
Leisure Suit Larry 6 CD:
Either speech only or speech and text can be selected. There is no
in-game option to toggle text only. Only Cabal's audio options can
be used to enable the text only mode.
Space Quest 4 CD:
Speech and text can be toggled via the "Display Mode" button in the
options dialog, or via Cabal's audio options.
3.22) Known Problems:
----- ---------------
This release has the following known problems. There is no need to
report them, although patches to fix them are welcome. If you discover a
bug that is not listed here, nor in the compatibility list on the web
site, please see the section on reporting bugs.
CD Audio Games:
- When playing games that use CD Audio (FM-TOWNS games, Loom CD, etc)
users of Microsoft Windows 2000/XP may experience random crashes.
This is due to a long-standing Windows bug, resulting in corrupt
game files being read from the CD. Please copy the game data to
your hard disk to avoid this.
FM-TOWNS versions:
- The Kanji versions require the FM-TOWNS Font ROM
Loom:
- Turning off the subtitles via the config file does not work reliably
as the Loom scripts automatically turn them on again
- MIDI support in the EGA version requires the Roland update from
LucasArts
- The PC-Engine Kanji version requires the system card rom
The Secret of Monkey Island:
- MIDI support in the EGA version requires the Roland update from
LucasArts
Beneath a Steel Sky:
- Amiga versions aren't supported
- Floppy demos aren't supported
- Not a bug: CD version is missing speech for some dialogs, this is
normal.
Elvira - Mistress of the Dark
- No music in the Atari ST version
Elvira II - The Jaws of Cerberus
- No music in the Atari ST version
- No sound effects in the PC version
- Palette issues in the Atari ST version
Inherit the Earth: Quest for the Orb
- Amiga versions aren't supported
Lure of the Temptress
- No Roland MT-32 support
- Sound support is incomplete and doesn't sound like original
Simon the Sorcerer 1:
- Subtitles aren't available in the English and German CD versions
as they are missing the majority of subtitles.
Simon the Sorcerer 2:
- Combined speech and subtitles will often cause speech to be
cut off early, this is a limitation of the original game.
- Only default language (English) of data files is supported
in Amiga and Macintosh versions.