FS2_open
========

Installation
------------

If you don't have FreeSpace 2, get it from
    http://www.gog.com/gamecard/freespace_2

Instructions:
    http://www.hard-light.net/forums/index.php?topic=79545.0

screen resolution
-----------------

Odds are, you'll want to run fs2_open in a higher resolution than the
default 640x480. This requires use of launcher such as "wxlauncher"
provided by "freespace2-launcher-wxlauncher" package or couple line changes
to a config file. You will need to run fs2_open once before you can make
the necessary changes, otherwise you won't have a configuration directory
to work with.

Open up ~/.fs2_open/fs2_open.ini with the text editor of your choice
(vi, EMACS, kwrite, gedit). You'll see something like the following:

    [Default]
    VideocardFs2open=OGL -(640x480)x16 bit
    LastPlayer=MonkeyboyS
    GammaD3D=1.0

To set fs2_open to use the highest setting possible on retail Freespace
2, change the VideocardFs2open to:

    VideocardFs2open=OGL -(1024x768)x32 bit

You can set this to pretty much anything you want as long as your
monitor supports it.


Starting game
-------------

    cd /usr/games/freespace2-open
    ../fs2_open -spec -glow -mipmap -jpgtga -orbradar -mod Media_VP

# http://www.hard-light.net/wiki/index.php/Command-Line_Reference


Joystick calibration
--------------------

Use "jscal" (/usr/bin/jscal) binary provided by "joystick" package to
calibrate joystick.


Game data
---------

Debian source packages are provided for some game data. As very minimum you
will need to build one -data package, either "freespace2-data-gog"
or "freespace2-data-volition". All -mod packages are optional.

Typical build instructions are

 1. Copy source packages to temporary directory where at least ~10 GiB
    of free space is available:

    cp -rv /usr/share/games/freespace2-open/packages/* .

 2. For -data package copy game data to the build directory (where "debian
    directory is"). "freespace2-data-volition" package will need files
    as listed in its "debian/files_sha1.txt" file; "freespace2-data-gog"
    needs only original "setup_freespace2_2.0.0.8.exe" file.

    For every -mod package fetch the data using the following command:

    debian/rules get-orig-source

 3. Build the package(s) using `dpkg-buildpackage -b -uc`,
    (install build-dependencies if prompted).
    Typical build-dependencies can be installed as follows:

    sudo apt install dpkg-dev wget p7zip-full unzip diffutils innoextract

