home | help
3OMNS(6)								3OMNS(6)

NAME
     3omns - simple tile-based bomb-dropping deathmatch game

SYNOPSIS
     3omns [OPTIONS...]

DESCRIPTION
     3omns  is	an  old-school	arcade-style tile-based bomb-dropping deathmatch
     game. The name is a bastardization of the word Bombs (and you  should  pro-
     nounce it however you want).

     The  red  player  uses the arrow keys to move and R-Ctrl to drop bombs. The
     blue player uses WASD to move and L-Ctrl to drop bombs. Damage players (and
     destroy crates) by catching them in a bomb  blast	or  "punching"	them  by
     walking  into  them.  You can disarm opponent bombs by walking over them. A
     few crates contain powerups that briefly make you invulnerable.

     3omns supports play over a LAN using the --serve or --connect options  (see
     Network Play Options below).

OPTIONS
     -g, --game=MOD
	 Normally,  3omns  looks for game logic Lua code in RES/base. Specify an
	 alternative to base in MOD to run different game logic (a mod,  if  you
	 will). The mod must provide the file RES/MOD/init.lua.

     -r, --resources=RES
	 Normally, 3omns looks for its resources somewhere like /usr/share/3omns
	 (see 3omns --default-resources for the actual location). Specify an al-
	 ternative in RES.

   Network Play Options
     -c, --connect=SERVER
	 Run as a client and connect to the hosting SERVER.

     -p, --port=PORT
	 Port  to  use	when serving or connecting. Unless specified, 3omns uses
	 port 30325 (which looks kind of like 3OMNS if you tilt your head).

     -s, --serve[=LISTEN]
	 Run as a host and listen on the given LISTEN address. If not specified,
	 LISTEN defaults to the wildcard address.

   Debug Options
     -d, --debug
	 Some useful diagnostic information is printed as 3omns runs, and  if  a
	 Lua error is encountered, you are dropped into a Lua debug session. You
	 can also enter a Lua debug session at any time by pressing the ` (grave
	 accent/tilde) key.

     -n, --debug-network
	 Print all network communication as it happens.

   Informational Options
     -R, --default-resources
	 Print the default value of RES, the path where 3omns normally looks for
	 its  resources, and exit. This just provides an unambiguous way to find
	 the path without parsing the help text.

     -?, --help
	 Print a brief command line help listing and exit.

     --usage
	 Print a terse command line usage summary and exit.

     -V, --version
	 Print 3omns version and exit.

BUGS
     3omns is still in alpha. These are some of the major  deficiencies  in  the
     current version:

     *	 Limited to 2 human players and 2 bots

     *	 Bot AI isn't very good

     *	 In LAN play, all connected computers can control both human players

     *	 Sometimes in LAN play clients won't see bomb explosions

RESOURCES
     See https://chazomaticus.github.io/3omns/ for more information.

COPYRIGHT
     Copyright 2014-2015 Charles Lindsay <chaz@chazomatic.us>

     3omns  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 3 of the License, or (at your option) any later
     version.

     3omns 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  de-
     tails.

     You  should  have	received  a copy of the GNU General Public License along
     with 3omns. If not, see http://www.gnu.org/licenses/.

AUTHOR
     Charles Lindsay <chaz@chazomatic.us>
	 Author.

  0.2				   2014-06-07				3OMNS(6)

home | help