-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME.TXT
277 lines (210 loc) · 11.1 KB
/
README.TXT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
Oolite Binary Release
=====================
Here are some things that you need to know, which will get you out of possible
mishaps.
Keyboard shortcut F12 toggles full screen/windowed mode.
Full screen or windowed mode as well as full screen mode resolutions may be
selected in "Game Options..." from the main game menu (F2 key). The settings
you select will be saved to your user defaults.
Some older (much older) OpenGL cards can't cope with Oolite in higher
resolutions and graphics rendering modes. This may result in textures not
properly rendered, text rendered as blocks, visual artifacts to be displayed
or low perfomance and frame rate. You may try various settings in the
"Game Options..." menu, to check if any of these issues are addressed.
Most newer cards work just fine in all supported resolutions and graphics
detail settings. In any case we invite you to visit the Oolite bulletin board
at http://aegidian.org/bb/index.php and post any issue, concern or suggestion.
Our community is known as being "The friendliest board this side of Riedquat".
Troubleshooting audio issues
============================
If you encounter sound issues with Oolite, it could be that the prepackaged
libraries that come with Oolite are not fully compatible with your system.
A workaround is to force Oolite to use your system's libraries instead of
the prepackaged ones.
The prepackaged Oolite libraries are located under the
<Oolite installation folder>/oolite-deps/lib/ folder.
If any of the following suggestions do not resolve the issue then join us at
our Oolite-Linux community at http://aegidian.org/bb/viewforum.php?f=9
and share your case with us. We have a thing for helping out fellow Commanders
in distress.
1. Oolite speech synthesis troubleshooting
------------------------------------------
To correct issues with Oolite speech synthesis go to the oolite-deps/lib
folder and try the following:
Workaround A: Use the alternative PulseAudio speech synthesis library.
$ cp -p libespeak.so.1 libespeak.so.1.portaudio
$ cp -p libespeak.so.1.pulseaudio libespeak.so.1
Now execute Oolite. If this doesn't work try the following:
Workaround B: Force Oolite to use your system's libespeak library.
First make sure that you have libespeak.so.1 installed in your system. Then
"hide" the Oolite libespeak prepackaged library by going into the
oolite-deps/lib folder and executing the following:
$ mv libespeak.so.1 libespeak.so.1.oolite
Now execute Oolite.
2. No Audio or Oolite fails to execute
--------------------------------------
2a. First make sure that you have libSDL-1.2.so.0 installed in your system. Then
"hide" the Oolite libSDL prepackaged library by going into the oolite-deps/lib
folder and executing the following:
$ mv libSDL-1.2.so.0 libSDL-1.2.so.0.oolite
Now execute Oolite. If this doesn't work then restore Oolite prepackaged libSDL:
$ mv libSDL-1.2.so.0.oolite libSDL-1.2.so.0
and try the following:
2b. First make sure that you have libopenal.so.1 installed in your system. Then
"hide" the Oolite libopenal prepackaged library by going into the
oolite-deps/lib folder and executing the following:
$ mv libopenal.so.1 libopenal.so.1.oolite
Now execute Oolite.
If this doesn't work either, try hiding both libSDL and libopenal Oolite
prepackaged libraries and execute Oolite again.
Updating to new versions
========================
Once installed, Oolite can be updated to the latest release, by executing
the oolite-update script.
This resides in either /usr/local/bin/ for system-wide Oolite installations
or in ~/GNUstep/Applications/Oolite/ for home-folder installations.
Running this updater will be considerably faster than downloading the full
new package. "oolite-update" uses the rsync utility software and network
protocol, and will update your Oolite installation from any version >= 1.75.2
to the latest release.
Folders that get created during execution
=========================================
Note: Please note that the folders described in this paragraph are not
removed when you uninstall Oolite. They are considered as user folders
(e.g. AddOns, screenshots, savegames with player's in-game status, game
settings, etc.) since they contain files generated with the Commander's own
pain and blood. You will have to manually remove them, if you believe that
you do not need them and that you will not need them even if you reinstall
Oolite in the future.
When you run Oolite for the first time a ~/GNUstep/ (~ stands for your home
folder path) folder will be created into your home folder. The GNUstep
backend needs this.
If you decide to use the "Manage Expansion Packs" functionality the
~/GNUstep/Library/ApplicationSupport/Oolite/ManagedAddOns/ folder will be
created to store the AddOns that you install from within the game itself.
This is the only folder (from the folders described in this section) that
the uninstaller will remove in case it finds it empty.
A ~/.Oolite/Logs/ folder is created to store the application Logs folder.
When Oolite is installed as a system-wide application, the .Oolite folder
may also be used to store OXPs visible only by the specific user
(~/.Oolite/AddOns.); see the "Adding AddOns" section below for more details.
A ~/.Oolite/.oolite-run file is also created at first run and its existence
supresses the display of this README.
A ~/oolite-saves/ folder is created when you save your game status as a
Commander.
Finally a ~/oolite-saves/snapshots/ folder is created when you grab an
in-game screenshot (* key) for the first time.
Saved games
===========
Saved games are all saved in ~/oolite-saves/ in your home folder. You can
copy all the existing .oolite-save files (for example, from a Macintosh)
into this folder, and they will appear in the 'Load Commander' menu screen
in the game.
However, if you decide to install add-ons, make sure that if you buy an
add-on ship you don't remove it, because your save game will stop working
if the ship it's based-on doesn't exist!
Adding AddOns
=============
There are over 500 game add ons available - missions, ships etc.
To find out what is currently available, we recommend you start by looking
at the OXP section of the Oolite wiki: http://wiki.alioth.net/index.php/OXP
To install an OXP, just copy the .oxp folder into the Oolite "AddOns" folder.
Next time you run Oolite, the OXP will be loaded.
If Oolite is installed system-wide then you have the following options:
A. OXPs visible by all users:
Copy the .oxp folder in the <Oolite installation folder>/AddOns/
B. OXPs visible only to a user:
Copy the .oxp folder in the ~/.Oolite/AddOns/
Options A and B can be combined. Oolite will look for add-ons in both
folders.
If Oolite is installed in your home-folder you may either copy the .oxp folder
into ~/GNUstep/Applications/Oolite/AddOns/ or into ~/.Oolite/AddOns/ . In this
case putting some add-ons in one folder and some add-ons in another does not
have any obvious use.
It is suggested that you keep your OXPs in one AddOns folder.
Caution: if you save a game after buying a ship that was in an OXP, then if you
subsequently remove the OXP, that commander file will be rendered useless!
What are the dependencies that are packaged?
============================================
Since Oolite for Linux 1.75.2-beta release, a new distribution-neutral
self-extractable package format has been introduced. The library dependencies
are packaged within the installer. They are installed under the Oolite/ tree
structure and are only visible by Oolite, thus not messing at all with your
system's own libaries.
So far, we've tested the pre-packaged dependencies on vanilla installations of
Ubuntu, Mint, Debian, Mandriva, Fedora, OpenSuse and on LinpusLite (!!!) with
just the normal beginner's installation (i.e. accepting all the defaults for
the GNU/Linux distro installed). It should work on any Linux distribution,
however for vintage distros, an old libc can scupper you; it won't run on
RedHat 8 for instance because libc is just too old.
It will also run on Knoppix (if you have somewhere writeable to install it).
Please let us know what distro you're using and whether it worked or not via
the Oolite-Linux forum (see the link below under 'If it's borked').
The pre-packaged dependencies that come with Oolite are:
libespeak.so.1
(compiled to use libportaudio.so.2 also pre-packaged)
libespeak.so.1.pulseaudio
(compiled to use PulseAudio as an alternative if libespeak.so.1 fails)
libffi.so.4
libgcrypt.so.20
libgmp.so.10
libgnustep-base.so.1.20 (gnustep-base-1.20.1 built with TLS support)
libgnutls.so.30
libgpg-error.so.0
libhogweed.so.4
libnettle.so.6
libnspr4.so.0d
libobjc.so.2
libogg.so.0
libopenal.so.1 (openal-soft-1.15.1)
libplc4.so.0d
libplds4.so.0d
libpng14.so.14 (libpng-1.4.7)
libportaudio.so.2 (PortAudio stable v19 released 2011-03-26)
libSDL-1.2.so.0 (SDL-1.2.14)
libvorbisfile.so.3
libvorbis.so.0
libz.so.1
Backward compatibility with GLIBC_2.7 Linux systems is achieved using a
vanilla installation of Ubuntu 8.04.4. The following source tarballs have
been used to build the additional libraries:
http://ftpmain.gnustep.org/pub/gnustep/core/gnustep-make-2.0.8.tar.gz
http://ftpmain.gnustep.org/pub/gnustep/core/gnustep-base-1.20.1.tar.gz
http://www.libsdl.org/release/SDL-1.2.14.tar.gz
http://kcat.strangesoft.net/openal-releases/openal-soft-1.15.1.tar.bz2
http://prdownloads.sourceforge.net/libpng/libpng-1.4.7.tar.gz?download
https://sourceforge.net/projects/libpng/files/zlib/1.2.8/zlib-1.2.8.tar.gz/download
http://www.portaudio.com/archives/pa_stable_v19_20110326.tgz
http://downloads.sourceforge.net/project/espeak/espeak/espeak-1.43/espeak-1.43.03-source.zip?use_mirror=kent
https://gmplib.org/download/gmp/gmp-6.1.0.tar.lz
ftp://ftp.gnutls.org/gcrypt/gnutls/v3.4/gnutls-3.4.15.tar.xz
https://gnupg.org/ftp/gcrypt/libgcrypt/libgcrypt-1.7.3.tar.bz2
https://gnupg.org/ftp/gcrypt/libgpg-error/libgpg-error-1.24.tar.bz2
https://ftp.gnu.org/gnu/nettle/nettle-3.2.tar.gz
All of these dependencies are pretty straightforward to compile.
If you're constructing a package for a non-x86 or non-Linux platform,
take a look in https://github.com/OoliteProject/oolite-linux-dependencies
for the libraries (dynamic and static) and headers you'll need to copy there.
Call for maintainers
====================
If you're willing to maintain any non-x86 arch and any non-Linux OS (Oolite
is at least known to run on FreeBSD) please let us know at:
http://aegidian.org/bb/viewforum.php?f=5
If it's borked
==============
Please report it in the Oolite-Linux forum. Please include screen snapshots
for graphics weirdness, and clear descriptions of sound weirdness.
Include any logs in the terminal window. If you launched Oolite from an
icon, you may need to start a terminal and run Oolite from there in order
to see any further O/S error messages. The Oolite-Linux forum is here:
http://aegidian.org/bb/viewforum.php?f=9
Talking about it, reporting bugs etc.
=====================================
The Oolite bulletins board can be found here:
http://aegidian.org/bb
Credits
=======
Original OS X game: Giles Williams
Linux port: David Taylor, Giles Williams and Dylan Smith
...and of course the GNUstep project and the SDL, OpenAL people, without
which the Linux and Win32 ports would not have been possible.