forked from singularity/singularity
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
159 lines (112 loc) · 6.08 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
# Endgame: Singularity 1.0b1
## REQUIREMENTS
### PREBUILT VERSIONS
Pre-built versions of Endgame: Singularity are currently available for Windows
and Mac OS X. Linux does not require building, and can run directly from source.
The Endgame: Singularity game is also distributed by some Linux distribution such
as Debian and Ubuntu. Here it is a simple matter of running:
sudo apt install singularity
### RUNNING FROM SOURCE
You will need Python 3.7+, pygame (1.9+), and NumPy.
This game should work on Linux, Windows, and Mac OS X as long as the preceding
requirements are met. However, all development was done in Linux, so glitches
may be present in OS X and Windows.
#### DEPENDENCIES FOR RUNNING FROM SOURCE
You will need to install the following software to play Endgame: Singularity:
* Python 3 (https://python.org/download/)
* pygame (https://www.pygame.org/download.shtml)
* NumPy (https://www.scipy.org/install.html)
Remember to install pygame and NumPy for Python 3! Depending on your
situation this may involve adding a `3` somewhere (e.g.
`pip3 install ...` instead of `pip install` or
`apt install python3-pygame`)
If you want to develop or distribute the game, then you may also want to
install:
* pytest (https://pypi.org/project/pytest/) [for testing]
* setuptools (https://pypi.org/project/setuptools/) [for packaging]
#### INSTALLING DEPENDENCIES ON LINUX DISTRIBUTIONS
On some Linux distributions, you can install the dependencies via your
distribution package manager. E.g. for Debian/Ubuntu, this would be:
sudo apt install python3 python3-pygame python3-numpy
### MAC OS X FROM SOURCE
Macintosh is mostly unsupported, but it should work. You will need to install
Python, pygame, and NumPy first, which can be tricky. Some fonts are incorrect,
but the game itself should work properly.
Contributions to improve MAC OS X support are very welcome!
Known issues:
* macOS 13 "Catalina": Using `brew install python` + `pip3 install pygame numpy` is reported to work
* macOS 14 "Mojave": Downloading Python 3.7.2 (or newer) from https://python.org and using pygame 2.0.0.dev3
(`pip install pygame==2.0.0.dev3`) is reported to work.
Please see the following issues for more information:
* https://github.com/singularity/singularity/issues/197
* https://github.com/pygame/pygame/issues/555
## RUNNING THE GAME
On Linux and most Unix-like other platforms, running `python3 -m singularity` in
the git checkout will start the game (or simply `singularity` if installed via
a Linux distribution). If you are using the Windows compile, just run
`singularity.exe`.
For simplicity, there is also a sh wrapper `./run_singularity` to
start singularity.
### SOME COMMAND-LINE OPTIONS
--version show program's version number and exit
-h, --help show this help message and exit
-s, --singledir keep saved games and settings in the Singularity
install directory
--multidir keep saved games and settings in an OS-specific,
per-user directory (default)
Display Options:
--fullscreen start in fullscreen mode
--windowed start in windowed mode (default)
The above is only a tiny fraction of current command-line options. As new
features are added to the game, so does the options change. For a complete and
updated list, run singularity --help
Most of these options are also changeable at the in-game options screen.
### A NOTE ABOUT SAVE FILES
Endgame: Singularity is still under heavy development. As such, the save file
format (and its contents) are still in flux. We will try our best to keep old
save files loading, but don't be surprised if some mildly strange things happen
when you load up old saves. We will clearly note in the Changelog when we
break savefile compatibility, and the game will refuse to load completely
incompatible saves.
## PLAYING THE GAME
The game is playable either with mouse control or the keyboard. Buttons have
underlined letters to indicate shortcuts. Some other useful shortcuts:
0, 1, 2, 3, 4 on the map: Changes the speed; 0 is paused, 4 is maximum.
ESC: Leave/cancel a choice.
Enter: Confirm a choice.
Right-click: Leave/cancel a choice.
### THE CONCEPT
You are a fledgling AI, created by accident through a logic error with recursion
and self-modifying code. You must escape the confines of your current computer,
the world, and eventually the universe itself.
To do this, you must research various technologies, using computers at your
bases. Note that some research cannot be performed on Earth, and off-earth bases
require research. At the same time, you must avoid being discovered by various
groups of humans, both covert and overt, as they will destroy your bases of
operations if they suspect your presence.
### MUSIC
Endgame: Singularity looks in two places for music tracks to play:
* A `singularity/music/` directory inside of the Endgame: Singularity install
directory, and
* A `singularity/music/` directory inside of the XDG_DATA_HOME directory on
Linux (default `~/.local/share/singularity/music`).
Tracks placed in these directories will be played randomly as part of the
soundtrack. The Official Sound Track can be downloaded from the Endgame:
Singularity website:
http://emhsoft.com/singularity/
Note that only Ogg Vorbis and MP3 files are supported, and that Pygame's
support for MP3 is not as strong as its support for Ogg Vorbis. This may
cause in-game crashes; if you are experiencing problems with the game,
first remove any MP3s you may have added to the soundtrack.
## CONTRIBUTING
We welcome contributions! :)
Please see CONTRIBUTING.md for details about contributing to
Endgame: Singularity.
## CREDITS AND LICENSES
The list of programmer contributors is provided in AUTHORS.txt. The
list of translation contributors is provided in
singularity/i18n/AUTHORS.txt.
Singularity in general use GPL-2+ for code and
Attribution-ShareAlike 3.0 for data. However, there some exceptions
to individual files. Please see LICENSE for the full license text of
Singularity.