Space Time Quest
-----------------
This is a strategy game in which the player has to use a limited
budget to design a gravitational wave detector. Copyright by
Daniel Brown, Paul Fulda, Ludovico Carbone and Andreas Freise,
2010 onwards.
The game webpage: http://www.gwoptics.org/processing/space_time_quest/
Ebook with related science information: http://www.gwoptics.org/ebook/
Online high score: http://www.gwoptics.org/stq_highscore
Version 1.2 released 01.08.2012
Installation
-----------------
Mac OS X:
The zip file for the OS X version includes and application bundle
`SpaceTimeQuest.app', just double-click the file to start the game.
Important note for users of Mountain Lion (OS X 10.8):
You will very likely receive the error message:
"SpaceTimeQeust.app is damaged and can't be opened. You should move
it to the Trash". The file is actually not damaged, instead this
error is due to the new security protections in Mountain Lion.
To allow the program (any program that does not come from Apple's
app store!) to run, go to:
System Preferences->Personal->Security & Privacy
Go to the `Security and Privacy' section, click the General tab to
highlight it. Click on the lock icon to allow changes. Under the
heading "Allow applications downloaded from:" click on the "Anywhere"
radio button. Now double click on the SpaceTimeQuest.app to start the
game. Afterwards you can change the Security & Privacy setting back
to the previous setting.
Windows:
The Windows version comes as a zip file, unzipping it will create
a new folder called `SpaceTimeQuest': double-clicking the file
`spacetimequest-setup.exe' will install the game.
To play the game from the start menu goto:
gwoptics.org > Space-Time Quest 1.2
and select your language choice
Linux:
You can try to run the Windows version on Linux through Wine
(http://www.winehq.org/). Apparently this works quite well.
We also provide a Linux version, however, in our experience
that does not run on many machines which is probably related
to our use of OpenGL. The Linux version is provided in case you
want to try but we cannot support it at the moment. For
installation, unzip the downloaded file and start e.g. the file
SpaceTimeQuest-English from the command line. If it starts, but
no window appears, you might want to try again several times.
In order to run the game you must have a 32bit version of Java 1.5
(or higher) installed and an OpenGL capable computer.
Advanced Usage
----------------
Space Time Quest allows a few parameters so be set via command line
arguments. For this you must start the game in a terminal window,
going into the game folder and typing:
Mac OS X: open -a "SpaceTimeQuest.app" --args parameter1=value parameter2=value ...
Windows: spacetimequest.exe parameter1=value parameter2=value ...
Linux: ./SpaceTimeQuest parameter1=value parameter2=value ...
Currently the following settings are possible:
1. parameter: language, possible values: English, Spanish, Catalan
and Chinese
This parameter overwrites the default language settings
(yes, in fact, you can download the default version and switch
to a different language using this parameter). More versions
in different languages are being prepared.
2. parameter: present, possible values: 0,1
When started with present=1 the game will start in full screen
mode (this is in fact Processing's `present mode), hiding the
background and other applications. We recommend to manually
set the screen resolution to a appropriate value (i.e. 800x600
or slightly higher) before starting the game.
On Mac OS X this mode often leaves the dock and the menu bar
visible. It is possible to auto-hide those whenever SpaceTimeQuest
is started, however you need to edit one file with a text editor:
Control-click on the SpaceTimeQuest.app, choose `Show Package
Contents' from the pop-up menu, and then navigate into the Contents
folder. Then open the file Info.plist with a text editor and add
the following key-value pair to the list:
LSUIPresentationMode
4
The value 4 suppresses menu bar and dock, however, they become
visible when the mouse hovers over them. Alternatively you might
want to set the value to 3 which completely hides dock and menu
bar while Space Time Quest is running (this might be best when
running the game at a fair or exhibition).
Alternatively open the file with the Property Editor (default for
this file type) and add the key `Application UI Presentation mode'
and type in `4' or '3' in the value field. This is just an
alternative editing method to achieve the same as above.
3. parameter: tag, values: user-defined word
This parameter allows to set a so-called `event tag'. This tag
will be transmitted to the online high score page. It is
then possible to only show the score with the same tag, for example
http://www.gwoptics.org/stq_highscore?tag=UIBfrikis shows only
the scores from a science event hosted by our Spanish
colleagues at the Universidad de las Islas Baleares.
Copyright notice
----------------
Space Time Quest Copyright (C) 2010 onwards by Daniel Brown, Paul
Fulda, Ludovico Carbone and Andreas Freise.
- The binary version for Windows (the SOFTWARE) has been created with
Excelsior JET http://www.ExcelsiorJET.com/.
The SOFTWARE is provided free of charge, You may make copies of
the SOFTWARE as you wish; give exact copies of the original
SOFTWARE to anyone; and distribute the SOFTWARE in its unmodified
form via electronic means.
You may not charge any fees for the copy or use of the SOFTWARE
itself. You must not represent in any way that you are selling the
SOFTWARE itself. Your distribution of the SOFTWARE will not entitle
you to any compensation. You must distribute a copy of this
Copyright Notice with any copy of the SOFTWARE and anyone to whom
you distribute the SOFTWARE is subject this Copyright Notice.
THE SOFTWARE AND ANY RELATED DOCUMENTATION IS PROVIDED "AS IS"
WITHOUT WARRANTY OF ANY KIND; without even the implied warranty
of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
THE ENTIRE RISK ARISING OUT OF USE OR PERFORMANCE OF THE SOFTWARE
REMAINS WITH YOU.
- The source code of Space Time Quest is covered by a GPL 2
license:
The program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
MA 02110-1301, USA.
Acknowledgement and further Copyright statements
------------------------------------------------
The code of this game is available under the GPL open source
license, see above, but the included graphics and other
media as well as used libraries libraries are covered by
separate copyright licenses.
The Spanish translation has been provided by
Sara Gil Casanova, the Catalan version is by
Alex Vaņķ Viņuales and the Chinese translation
was performed by Mengyao Wang.
Space Time Quest has been build with Processing
and includes the Processing core libraries.
http://www.processing.org/
It uses a number of contributed Processing libraries:
- `GUI for Processing' by Peter Lager
http://www.lagers.org.uk/g4p/index.html
http://gui4processing.googlecode.com/svn/trunk/
covered by a LGPL license:
---
Copyright (c) 2008-09 Peter Lager
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General
Public License along with this library; if not, write to the
Free Software Foundation, Inc., 59 Temple Place, Suite 330,
Boston, MA 02111-1307 USA
---
- Scientific plotting library `gwoptics' by Daniel Brown and Andreas Freise
http://www.gwoptics.org/processing/gwoptics_p5lib/
file: gwoptics.jar
covered by a LGPL license:
---
Copyright notice
This file is part of the Processing library `gwoptics'
http://www.gwoptics.org/processing/gwoptics_p5lib/
Copyright (C) 2009 onwards Daniel Brown and Andreas Freise
This library is free software; you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License version 2.1 as published
by the Free Software Foundation.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with
this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
Suite 330, Boston, MA 02111-1307 USA