67 lines
2.4 KiB
Markdown
67 lines
2.4 KiB
Markdown
# Notes for Package Maintainers
|
|
|
|
This guide shows how Yamagi Quake II should be packaged and what
|
|
assumptions the games makes regarding binary and game data locations.
|
|
|
|
This guide uses the notation for unixoid platforms. Executables have no
|
|
file extensions and libraries are given with the *.so* extension. MacOS
|
|
and Windows behave exactly the same way, but with the platform specific
|
|
file extensions.
|
|
|
|
|
|
## The Executables
|
|
|
|
Yamagi Quake II expects all binaries (executables and libraries) to be
|
|
in the same directory or, in the case of *game.so*, in the mod-specific
|
|
subdirectory.
|
|
|
|
So the binary directory should look somehow like this:
|
|
|
|
* /path/to/yamagi-quake2/
|
|
* quake2
|
|
* q2ded
|
|
* ref_gl1.so
|
|
* ref_gl3.so
|
|
* baseq2/
|
|
* game.so
|
|
* xatrix/
|
|
* game.so
|
|
* ... (the same for other addons)
|
|
|
|
Yamagi Quake2 will get the directory the `quake2` executable is in from
|
|
the system and then look in that directory (and nowhere else!) for the
|
|
`ref_*.so` renderer libraries. It will look for `game.so` there first,
|
|
but if it's not found in the binary directory, it will look for it in
|
|
all directories that are also searched for game data. This is for
|
|
better compatibility with mods that might ship their own game.so.
|
|
|
|
You can **just symlink the executables to a directory in the $PATH**,
|
|
like */usr/bin/*. There's one exception to this rule: OpenBSD does not
|
|
provide a way to get the executable path, so a wrapper script is needed.
|
|
|
|
We want all binaries to be in the same directory to ensure that people
|
|
don't accidentally update only parts of their Yamagi Quake II
|
|
installation, so they'd end up with a new quake2 executable and old
|
|
renderer libraries (`ref_*.so`) and report weird bugs.
|
|
|
|
|
|
## The SYSTEMWIDE and SYSTEMDIR options
|
|
|
|
The Makefile allows to enable the *SYSTEMWIDE* feature to force Yamagi
|
|
Quake II to search the game data in an system specific directory. That
|
|
directory can be given in the Makefile. If no directory is given the
|
|
game defaults to */usr/share/games/quake2/* which should be correct for
|
|
most Linux distributions.
|
|
|
|
The `SYSTEMDIR` is meant to contain only the game data and *not* the
|
|
binaries. It allows several Quake2 source ports to share the same game
|
|
data.
|
|
|
|
|
|
## Alternative startup config
|
|
|
|
Yamagi Quake II has support for an alternative startup config. That
|
|
config overrides some global values with sane defaults. It may be a good
|
|
idea to install it. Copy yq2.cfg to the baseq2/ subdirectory in the
|
|
gamedata directory.
|