bzadmin(6)							      BZFlag								bzadmin(6)

NAME

       bzadmin - a text based client for BZFlag

SYNOPSIS

       bzadmin	[-help]  [-hide  msgtype[,msgtype]...]	 [-show  msgtype[,msgtype]...]	 [-ui {curses | stdboth | stdin | stdout}] callsign[:pass-
       word]@hostname[:port] [command] [command] ...

DESCRIPTION

       bzadmin is a textbased client for the game BZFlag. It can't be used for playing, but it can be used to see when players join and leave  the
       game, to see the chat messages, and to send messages and commands to the server, as well as see several other vital game messages.

       When  you  start  bzadmin  without  any	command line options other than callsign and hostname a simple curses-based user interface will be
       started (unless you built bzadmin without curses support). This interface is divided into three rectangles; the output window (which covers
       almost all of the terminal), the target window, and the input window.

       The output window is where messages from the server will be shown.

       The  target  window  shows  the	name  of the player that will receive your next message, or 'all' if it will be a public message.  You can
       change target by using the left and right arrow keys.

       The input window is where you type your messages. It also supports tab completion of commands and callsigns. You can clear the input window
       with  the  key  combination Ctrl-U, and you can generate a /kick command for the current target with the F5 key (if the current target is a
       player). You can also generate a ban command for the current target with the F6 key, but this only works if you are an admin and the server
       has sent you that players IP address (as a response to a /playerlist command).

       The  curses  user  interface  also  has a simple menu system where you can edit the server variables (if you are an admin) and see a player
       list. If you are an admin you can also see the IP addresses in the player list, if you have sent a /playerlist command. The menu  shows	up
       when  you  hit the F2 key.  It only covers the upper half of the screen, so you can still see what's going on in the game. You can navigate
       through the menu with the up and down arrow keys, and use the enter key to select submenus and other menu items. If you hit  F2	again  the
       command prompt will regain keyboard focus, but the menu will still be visible. If you hit F2 a third time the menu will go away.

   Options
	      -help	     Show a simple help text.

	      -hide msgtype[,msgtype]...
			     Tell  bzadmin  not to show these message types. The available message types are chat, join, kill, leave, pause, ping,
			     rabbit, spawn, time, and over. By default chat, join, kill, leave, pause, and rabbit are shown. You can  also  change
			     this while bzadmin is running with the commands /show <msgtype> and /hide <msgtype>, and from the curses menu.

	      -show msgtype[,msgtype]...
			     Tell  bzadmin  to	show  these  message  types. See -hide for a list of available message types. If a message type is
			     listed both in -show and -hide it will not be shown.

	      -ui {curses | stdboth | stdin | stdout}
			     Select the user interface that you want. The curses interface is the default, and it is described above.
			     The stdin interface reads user commands from the standard in stream and sends them to the server. All  server  output
			     is ignored.
			     The stdout interface prints all server output to the standard out stream.	All user input is ignored.
			     The  stdboth interface is a combination of stdin and stdout - it prints server output to the standard out stream, and
			     reads user commands from the standard in stream.

	      callsign[:password]@hostname[:port]
			     Specifies the callsign that you want your client to use, and the hostname where the BZFlag server is. The port number
			     is optional, and the default value is 5154.

	      command	     You  can specify messages and commands to send to the server on the command line. BZAdmin will continue running after
			     sending the specified commands.

   Examples
	      bzadmin admin@localhost:5154
			     Join the game on localhost, port 5154, using the callsign 'admin'.

	      bzadmin admin@localhost '/passwd secretpass' '/ban 192.168.0.2'
			     Connect to the server at localhost and ban the IP 192.168.0.2.

	      bzadmin -ui stdout spy@bzserver.xy | grep magicword
			     Connect to bzserver.xy and print all server messages that contain 'magicword'.

SEE ALSO

       bzfs(6), bzflag(6), bzw(5)

bzadmin-2.0.16							    2011-12-27								bzadmin(6)