Updated readme, added helper launcher script. 2.0 release.
This commit is contained in:
parent
b4ccaf61ab
commit
83a67fe3f7
|
@ -6,7 +6,7 @@
|
||||||
SUBDIRS = src misc
|
SUBDIRS = src misc
|
||||||
|
|
||||||
dist_doc_DATA = README.txt COPYING LICENSES
|
dist_doc_DATA = README.txt COPYING LICENSES
|
||||||
dist_data_DATA = win32build.sh data gfx music sound locale misc
|
dist_data_DATA = starfighter.sh win32build.sh data gfx music sound locale misc
|
||||||
|
|
||||||
if !RUN_IN_PLACE
|
if !RUN_IN_PLACE
|
||||||
|
|
||||||
|
|
124
README.txt
124
README.txt
|
@ -26,9 +26,7 @@ compared to the original:
|
||||||
|
|
||||||
* There are several gameplay changes. These changes were mostly done to
|
* There are several gameplay changes. These changes were mostly done to
|
||||||
balance the game better. However, if you want the original experience,
|
balance the game better. However, if you want the original experience,
|
||||||
"Classic" difficulty emulates it as closely as possible (see the
|
"Classic" difficulty emulates it as closely as possible.
|
||||||
CLASSIC DIFFICULTY DIFFERENCES section to read about the few
|
|
||||||
differences that exist).
|
|
||||||
|
|
||||||
* Much of the dialog has been changed. There are various reasons for
|
* Much of the dialog has been changed. There are various reasons for
|
||||||
this; some of these include fixing bad writing, making the dialog
|
this; some of these include fixing bad writing, making the dialog
|
||||||
|
@ -38,6 +36,8 @@ compared to the original:
|
||||||
example, the simplistic target arrow of the original has been replaced
|
example, the simplistic target arrow of the original has been replaced
|
||||||
with a system of several arrows, one for each ship.
|
with a system of several arrows, one for each ship.
|
||||||
|
|
||||||
|
* Unicode and gettext translation support have been added.
|
||||||
|
|
||||||
* Typing "humansdoitbetter" in the title screen no longer enables
|
* Typing "humansdoitbetter" in the title screen no longer enables
|
||||||
cheats. This is actually because the switch to SDL2 broke the original
|
cheats. This is actually because the switch to SDL2 broke the original
|
||||||
feature, and rather than fixing it, I just replaced it with something
|
feature, and rather than fixing it, I just replaced it with something
|
||||||
|
@ -46,13 +46,74 @@ compared to the original:
|
||||||
|
|
||||||
------------------------------------------------------------------------
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
PLAYING THE GAME
|
||||||
|
|
||||||
|
The basic controls are the arrow keys, Ctrl, Space, Shift, and Escape.
|
||||||
|
Other keys on they keyboard can also be used in case of keyjamming or if
|
||||||
|
you simply prefer other controls; alternative keys include the keypad,
|
||||||
|
ZXC, ASD, <>?, and 123. A gamepad or joystick can also be used.
|
||||||
|
|
||||||
|
The basic objective of Project: Starfighter is simply to complete all
|
||||||
|
missions. Exactly what entails completing a mission varies and is
|
||||||
|
explained in-game.
|
||||||
|
|
||||||
|
In the system overview screen, various sections can be accessed by
|
||||||
|
clicking the icons on the bottom of the screen. You can also use the
|
||||||
|
keyboard or a gamepad if you prefer (use the arrows to move the cursor
|
||||||
|
and the fire button to "click" on things).
|
||||||
|
|
||||||
|
Other than that, have fun, and good luck!
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
COMPILING FROM SOURCE
|
||||||
|
|
||||||
|
If you are an end-user, it is easiest to use an existing binary
|
||||||
|
distribution if possible. If you want or need to compile yourself,
|
||||||
|
however, instructions follow.
|
||||||
|
|
||||||
|
Note: Developers compiling the source code from the Git repository,
|
||||||
|
please first see the GENERATING CONFIGURE SCRIPT section below.
|
||||||
|
|
||||||
|
Project: Starfighter depends on the following libraries to build:
|
||||||
|
|
||||||
|
* SDL2 <http://libsdl.org>
|
||||||
|
* SDL2_image <http://www.libsdl.org/projects/SDL_image/>
|
||||||
|
* SDL2_mixer <http://www.libsdl.org/projects/SDL_mixer/>
|
||||||
|
* SDL2_ttf <http://www.libsdl.org/projects/SDL_ttf/>
|
||||||
|
* Pango <https://www.pango.org/>
|
||||||
|
|
||||||
|
Once you have all dependencies installed, do the following from the
|
||||||
|
Project: Starfighter base directory:
|
||||||
|
|
||||||
|
./configure
|
||||||
|
make
|
||||||
|
make install
|
||||||
|
|
||||||
|
This will perform a system-wide installation, which is recommended for
|
||||||
|
most users. For most Linux systems, an icon should be added to your
|
||||||
|
menu which you can then use to run Starfighter; if not, you can use the
|
||||||
|
launcher found in the "misc" directory or run the "starfighter" command
|
||||||
|
manually.
|
||||||
|
|
||||||
|
If you would prefer a "run in place" build, you should instead do the
|
||||||
|
following from the Project: Starfighter base directory:
|
||||||
|
|
||||||
|
export SF_RUN_IN_PLACE=1
|
||||||
|
./configure
|
||||||
|
make
|
||||||
|
mv src/starfighter .
|
||||||
|
|
||||||
|
Run "./configure --help" to see all options for compiling.
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
GENERATING CONFIGURE SCRIPT
|
GENERATING CONFIGURE SCRIPT
|
||||||
|
|
||||||
If you contribute to Project: Starfighter's source code, you will need
|
If you contribute to Project: Starfighter's source code, you will need
|
||||||
to know how to generate a configure script for compiling the program.
|
to know how to generate a configure script for compiling the program.
|
||||||
NOTE: This is for developers only. End-users simply compiling releases
|
NOTE: This is for developers only. End-users simply compiling releases
|
||||||
of Starfighter from source can ignore this section and skip straight to
|
of Starfighter from source can ignore this section.
|
||||||
the COMPILING FROM SOURCE section.
|
|
||||||
|
|
||||||
The following components are required to generate the configure script:
|
The following components are required to generate the configure script:
|
||||||
|
|
||||||
|
@ -75,56 +136,3 @@ directory, you can do so via the following command (requires Git):
|
||||||
Note: automatically generated files are listed in .gitignore, so you
|
Note: automatically generated files are listed in .gitignore, so you
|
||||||
generally don't actually have to do this.
|
generally don't actually have to do this.
|
||||||
|
|
||||||
------------------------------------------------------------------------
|
|
||||||
|
|
||||||
COMPILING FROM SOURCE
|
|
||||||
|
|
||||||
Project: Starfighter depends on the following libraries to build:
|
|
||||||
|
|
||||||
* SDL2 <http://libsdl.org>
|
|
||||||
* SDL2_image <http://www.libsdl.org/projects/SDL_image/>
|
|
||||||
* SDL2_mixer <http://www.libsdl.org/projects/SDL_mixer/>
|
|
||||||
* SDL2_ttf <http://www.libsdl.org/projects/SDL_ttf/>
|
|
||||||
* Pango <https://www.pango.org/>
|
|
||||||
|
|
||||||
Once you have all dependencies installed, you can do the following from
|
|
||||||
a terminal window:
|
|
||||||
|
|
||||||
./configure
|
|
||||||
make
|
|
||||||
make install
|
|
||||||
|
|
||||||
Run "./configure --help" to see more options.
|
|
||||||
|
|
||||||
The third step ("make install") is technically optional, but highly
|
|
||||||
recommended.
|
|
||||||
|
|
||||||
For most Linux systems, an icon should be added to your menu when you
|
|
||||||
run "make install". You can click on this icon to start up the game.
|
|
||||||
Otherwise, you can manually install or use the launcher found in the
|
|
||||||
"misc" directory, or you can run the "starfighter" command to start up
|
|
||||||
the game.
|
|
||||||
|
|
||||||
If you choose not to use the "make install" command, you can find the
|
|
||||||
"starfighter" binary in the "src" directory.
|
|
||||||
|
|
||||||
------------------------------------------------------------------------
|
|
||||||
|
|
||||||
PLAYING THE GAME
|
|
||||||
|
|
||||||
The basic controls are the arrow keys, Ctrl, Space, Shift, and Escape.
|
|
||||||
Other keys on they keyboard can also be used in case of keyjamming or if
|
|
||||||
you simply prefer other controls; alternative keys include the keypad,
|
|
||||||
ZXC, ASD, <>?, and 123. A gamepad or joystick can also be used.
|
|
||||||
|
|
||||||
The basic objective of Project: Starfighter is simply to complete all
|
|
||||||
missions. Exactly what entails completing a mission varies and is
|
|
||||||
explained in-game.
|
|
||||||
|
|
||||||
In the system overview screen, various sections can be accessed by
|
|
||||||
clicking the icons on the bottom of the screen. You can also use the
|
|
||||||
keyboard or a gamepad if you prefer (use the arrows to move the cursor
|
|
||||||
and the fire button to "click" on things).
|
|
||||||
|
|
||||||
Other than that, have fun, and good luck! 🙂
|
|
||||||
|
|
||||||
|
|
|
@ -7,7 +7,7 @@
|
||||||
# information. This file is offered as-is, without any warranty.
|
# information. This file is offered as-is, without any warranty.
|
||||||
|
|
||||||
AC_PREREQ([2.69])
|
AC_PREREQ([2.69])
|
||||||
AC_INIT([Project: Starfighter], [1.8-dev], [onpon4@riseup.net], [starfighter])
|
AC_INIT([Project: Starfighter], [2.0], [onpon4@riseup.net], [starfighter])
|
||||||
AM_INIT_AUTOMAKE([foreign -Wall -Werror])
|
AM_INIT_AUTOMAKE([foreign -Wall -Werror])
|
||||||
AC_CONFIG_SRCDIR([src/Starfighter.c])
|
AC_CONFIG_SRCDIR([src/Starfighter.c])
|
||||||
AC_CONFIG_HEADERS([config.h])
|
AC_CONFIG_HEADERS([config.h])
|
||||||
|
|
|
@ -0,0 +1,7 @@
|
||||||
|
#!/bin/sh
|
||||||
|
# This file has been dedicated to the public domain, to the extent
|
||||||
|
# possible under applicable law, via CC0. See
|
||||||
|
# http://creativecommons.org/publicdomain/zero/1.0/ for more
|
||||||
|
# information. This file is offered as-is, without any warranty.
|
||||||
|
|
||||||
|
./src/starfighter $@
|
|
@ -1,5 +1,11 @@
|
||||||
#!/bin/sh
|
#!/bin/sh
|
||||||
# Note: Before running, be sure to add the MXE usr/bin location to PATH
|
# This file has been dedicated to the public domain, to the extent
|
||||||
|
# possible under applicable law, via CC0. See
|
||||||
|
# http://creativecommons.org/publicdomain/zero/1.0/ for more
|
||||||
|
# information. This file is offered as-is, without any warranty.
|
||||||
|
#
|
||||||
|
# Helper script to cross-compile for Windows with MXE.
|
||||||
|
# Note: Before running, be sure to add the MXE usr/bin location to PATH.
|
||||||
|
|
||||||
export SF_RUN_IN_PLACE=1
|
export SF_RUN_IN_PLACE=1
|
||||||
./configure --host=i686-w64-mingw32.static
|
./configure --host=i686-w64-mingw32.static
|
||||||
|
|
Loading…
Reference in New Issue