FreeSCI is a portable interpreter for SCI games, such as the Space Quest series (starting with SQ3) or Leisure Suit Larry (2 and sequels).

This man page describes the tools that come with FreeSCI. The main executable (which you're probably interesed in if you want to play SCI games) is described in sciv(6).

The sciconsole program provides a command console for inspection of SCI data. It reads the SCI resource files from the current directory. There are no command line options.

The scidisasm program disassembles all script resources in SCI resource files in the current directory into .script files.

It takes five optional command line switches: --version prints the version number and exists; --help displays a short help message and exists; --hexdump hex dumps all script resources; --verbose prints additional disassembly information; --opcode-size prints opcode size postfixes.

sciunpack is a tool for unpacking, printing, and converting SCI resource data

Usage: sciunpack [operation] [options] <resource.number>

Alternatively, the resource type and number can be specified as two seperate options.

Available resources are: view, pic, script, text, sound, memory, vocab, font, cursor, patch, bitmap, palette, cdaudio, audio, sync, sync, message, map, heap.

If * is specified instead of <number>, all resources of given type will be unpacked.

sciunpack supports the following operations:

--unpack, -U

This is the default action; it unpacks the specified resource.

--list, -L

Lists all available resources.

--words, -W

Prints all vocabulary words understood by the parser. See

--objects, -O

Outputs the full object hierarchy

--said-specs, -S

Displays all 'said specs' used in the game in question; these are relevant in parser-based games, as input is matched against them to determine semantics of user input.

--vocab, -V

This operation goes through several relevant 'vocab' resources, interprets their contents, and prints them sequentially. First, all selector (variable/function) names are print, then all opcodes, followed by the names of all kernel functions, and finally the class ID/script lookup table.

--version

Prints the version number.

--help, -h

Displays a short help message.

Also, there are several options available:

--verbose, -v

Enables additional output.

--convert, -c

Forces sound resources to be converted to General MIDI on some platforms, and script resources to be dissected.

--output-file <file>, -o<file>

Selects output file file.

--gamedir <dir>, -d<dir>

Read game resources from dir.

--with-header

Forces the SCI header to be written (default).

--without-header

Prevents the two SCI header bytes from being. written

--sort-alpha

Sorts in alphabetical order when listing words (-W)

--sort-group

Sorts by group IDs when listing words (-W)

As a default, 'resource.number' is the output filename, unless conversion is enabled (-c). With conversion, a few resource types are treated specially:

-

sound resources: will be converted to General MIDI, stored in <number>.midi (this only works on GNU libc systems)

-

script resources: will be dissected and stored in <number>.script

scipack is a tool for packing SCI resource data from seperate files into a resource.000 and a resource.map file.

Usage: scipack <file1.nnn> [ <file2.nnn> [ <file3.nnn> [ ... ] ] ]

It reads the resource files specified on the command line and writes them to resource.000. It also generates the resource.map file to go with it.

The scriptdump tool can be used to disassemble all selector methods into SCI assembly. It takes no command line options and reads the resource files from the current directory.

This tool can be used to display kernel function and selector names. It is obsolete. You should rather use sciconsole.

freesci(6).

This software is copyright (c) 1999,2000,2001 by Christoph Reichenbach <creichen@rbg.informatik.tu-darmstadt.de>, Carl Muckenhoupt <carl@wurb.com>, Dmitry Jemerov <yole@exch.nnz.spb.su>, Magnus Reftel <d96reftl@dtek.chalmers.se>, Sergey Lapin <slapin@karelia.ru>, Lars Skovlund <lskovlun@image.dk>, Matt Hargett <matt@use.net>, Solomon Peachy <pizza@shaftnet.org>, Rickard Lind <rpl@dd.chalmers.se> and Rink Springer <rink@springer.cx>.

This man page was written by Bas Zoetekouw <bas@debian.org> and Christoph Reichenbach.