NAME

       bzadmin - a text based client for BZFlag

SYNOPSIS

       bzadmin [-help] [-hide msgtype[,msgtype]...]  [-show msgtype[,msgtype]...]  [-ui {curses |
       stdboth | stdin | stdout}] callsign[:password]@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)