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