Skip to content

Latest commit

 

History

History
114 lines (78 loc) · 3.61 KB

README.md

File metadata and controls

114 lines (78 loc) · 3.61 KB
Raw

psdoom-ng

psdoom-ng is a First Person Shooter operating system process killer based on psDooM and Chocolate Doom.

Compile and usage

Quick guide:

  1. Install all dependencies: gcc, make, libsdl, sdl_mixer, sdl_net, bash.
  2. cd trunk
  3. ./configure --help #review your prefix, other paths, and extra options
  4. make
  5. make install
  6. man psdoom-ng #read up on how to set it up the wrapper script psd
  7. Get a copy of Doom, to copy the file Doom2.wad.
  8. Action! psd or psdoom-ng

Find more information in:

Gentoo Linux

You can find the ebuild at https://github.com/orsonteodoro/oiledmachine-overlay

Mac OS X

Now with support for Mac OS X!

It is recommended use brew to install the depenedencies.

Support for external process source

You can use external commands as interface to retrieve, renice and kill process.

This makes it easy to adapt the tool to your needs, or even integrate it with external services (AWS, heroku, vmware, etc).

For that, you only need to override these environment variables:

  • PSDOOMPSCMD List the processes. The command must print one space separated line per process with the format: <user> <pid> <processname> <is_daemon=[1|0]>
    keymon 29 web4 1
    keymon 30 web3 1
    keymon 31 adis3 1
    keymon 32 core15 1
    keymon 20 core2 1

  • PSDOOMRENICECMD Command to renice the process. Will get the pid as argument

  • PSDOOMKILLCMD Command to kill the process. Will get the pid as argument

For example, in contrib you can find a script that interacts with cloudfoundry:

    cd trunk
    PSDOOMPSCMD="./contrib/psdoom-cf-ctl ps" \
    PSDOOMRENICECMD="true" \
    PSDOOMKILLCMD="./contrib/psdoom-cf-ctl kill" \
    ./src/psdoom

NOTE: psdoom does a synchronous call to the external commands (mono-thread). If your command takes too long, you will feel hipcuts in the game. Try to make your commands respond really fast!

The example script can be installed by adding --enable-cloudfoundry on configure and is installed in /usr/local/portage/psdoom-ng-cf-ctl

Custom map

The custom wads referred in psDooM readme can be found at contrib/psdoom-2000.05.03-data.tar.gz

Contributors

Dennis Chao came up with the original idea and wrote much of the mod.

David Koppenhofer was the previous maintainer of the mod psDooM.

Simon Howard wrote Chocolate Doom which is the current game engine used.

Hector Rivas Gandara added support for external sources and cloud services.

Jesse Speilman added support for Mac OS X.

Orson Teodoro was responsible for making psDooM mod work on Chocolate Doom.

Contributing

Fork it ( https://github.com/orsonteodoro/psdoom-ng1/fork )
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature') or (for multiline commit message: git commit -F- <<EOF \n blah blah blah \n EOF)
Push to the branch (git push origin my-new-feature)
Create new Pull Request

License

psDooM was based on GNU General Public License 2.0.

Chocolate Doom was based on GNU General Public License 2.0.

You can view more about the GPL-2 at http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html