This wiki is archived and useful information is being migrated to the main bzflag.org website

Difference between revisions of "BZAdmin"

From BZFlagWiki
Jump to: navigation, search
(ws)
(Command Line Options: added wiki table)
 
(13 intermediate revisions by 6 users not shown)
Line 1: Line 1:
BZAdmin is a text-only client for BZFlag. It is primarily meant to be a tool for server administrators, but it can also be used for other things. Read the man page for more details.
+
[[BZAdmin]] is a text-only client for [[BZFlag]]. It is primarily meant to be a tool for server administrators, but it can also be used for other things. Read the man page for more details.
  
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 termi- nal), the target window, and the input window. the server has sent you that players IP address (as a response to a /playerlist command).
+
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 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.  
+
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.
  
== Mac ==
+
== Running BZAdmin ==  
Open up a terminal (Terminal.app) and type:
+
  
/Applications/BZFlag*/Contents/MacOS/bzadmin callsign[:password]@server[:port]
+
BZAdmin is run from the command line with its required arguments, a callsign and a server:
  
Example:
+
Please note: fields surrounded by brackets e.g. "[field]" are optional''
  
  /Applications/BZFlag2.0.8/Contents/MacOS/bzadmin brad:imanidiot@tankwar.gamesunited.de:5158
+
{|
 +
|
 +
  bzadmin callsign[:password]@server[:port]
 +
|}
  
NOTE: The password and/or port are optional. The default port is 5154.
+
=== Examples ===
  
== Windows ==
+
On specific platforms for the callsign "example" with a password of "password" accessing the viper.pimpi.org server at port 5158:
 +
 
 +
==== Windows ====
 
Open up a command prompt (start -> run -> "cmd") and type:
 
Open up a command prompt (start -> run -> "cmd") and type:
  
  "C:\Program Files\BZFlag*\bzadmin.exe" callsign[:password]@server[:port]
+
{|
 +
|
 +
  "C:\Program Files\BZFlag2.4.0_32Bit\bzadmin.exe" example:password@viper.pimpi.org:5158"
 +
|}
  
Example:
+
==== Mac OS X ====
  
"C:\Program Files\BZFlag2.0.8\bzadmin.exe" brad:imanidiot@tankwar.gamesunited.de:5158
+
Open up a terminal (/Applications/Utilities/Terminal.app) and type:
  
NOTE: The password and/or port are optional. The default port is 5154.
+
{|
 +
|
 +
/Applications/BZFlag2.4.0.app/Contents/MacOS/bzadmin example:password@viper.pimpi.org:5158
 +
|}
  
== Unix ==
+
==== Linux ====
 
Open up a terminal and type:
 
Open up a terminal and type:
  
  /usr/local/bin/bzadmin callsign[:password]@server[:port]
+
{|
 +
|
 +
  /usr/local/bin/bzadmin example:password@viper.pimpi.org:5158
 +
|}
  
Example:
+
== Command Line Options ==
 
+
{|{{Prettytable}}
/usr/local/bin/bzadmin brad:imanidiot@tankwar.gamesunited.de:5158
+
|-
 
+
| {{Hl3}} |'''Command'''  
NOTE: The password and/or port are optional. The default port is 5154.
+
| {{Hl3}} |'''Description'''
 
+
|-
== Other Command Line Options ==
+
| '''-help''' || This will display a help message including a list of command line options.
 
+
|-
'''-help'''
+
| '''-hide msgtype{,msgtype}*''' || Tell bzadmin not to show these message types. The available message types are: chat, join, kill, leave, pause, ping, rabbit, and spawn. By default chat, join, kill, leave, pause, and rabbit are shown.
 
+
|-
This will display a help message including a list of command line options.
+
| '''-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 <nowiki>{curses | stdboth | stdin | stdout}</nowiki>''' || 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.
'''-hide msgtype{,msgtype}*'''
+
|-
 
+
|}
Tell bzadmin not to show these message types. The available message types are: chat, join, kill, leave, pause, ping, rabbit, and spawn. By default chat, join, kill, leave, pause, and rabbit are shown.
+
 
+
'''-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.
+
  
 
== Other Examples ==
 
== Other Examples ==
 
Join the game on localhost, port 5154, using the callsign 'admin'.  
 
Join the game on localhost, port 5154, using the callsign 'admin'.  
 +
{|
 +
|
 
  bzadmin admin@localhost:5154
 
  bzadmin admin@localhost:5154
 
+
|}
 
Connect to the server at localhost and ban the IP 192.168.0.2 for 2 hours.
 
Connect to the server at localhost and ban the IP 192.168.0.2 for 2 hours.
 +
{|
 +
|
 
  bzadmin admin@localhost "/password secretpass" "/ban 192.168.0.2 2h test"
 
  bzadmin admin@localhost "/password secretpass" "/ban 192.168.0.2 2h test"
 
+
|}
 
Connect to bzserver.org and print all server messages that contain 'magicword'.
 
Connect to bzserver.org and print all server messages that contain 'magicword'.
 +
{|
 +
|
 
  bzadmin -ui stdout spy@bzserver.org | grep magicword
 
  bzadmin -ui stdout spy@bzserver.org | grep magicword
 +
|}
 +
[[Category:Client]]

Latest revision as of 22:31, 15 February 2017

BZAdmin is a text-only client for BZFlag. It is primarily meant to be a tool for server administrators, but it can also be used for other things. Read the man page for more details.

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 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.

Running BZAdmin[edit]

BZAdmin is run from the command line with its required arguments, a callsign and a server:

Please note: fields surrounded by brackets e.g. "[field]" are optional

bzadmin callsign[:password]@server[:port]

Examples[edit]

On specific platforms for the callsign "example" with a password of "password" accessing the viper.pimpi.org server at port 5158:

Windows[edit]

Open up a command prompt (start -> run -> "cmd") and type:

"C:\Program Files\BZFlag2.4.0_32Bit\bzadmin.exe" example:password@viper.pimpi.org:5158"

Mac OS X[edit]

Open up a terminal (/Applications/Utilities/Terminal.app) and type:

/Applications/BZFlag2.4.0.app/Contents/MacOS/bzadmin example:password@viper.pimpi.org:5158

Linux[edit]

Open up a terminal and type:

/usr/local/bin/bzadmin example:password@viper.pimpi.org:5158

Command Line Options[edit]

Command Description
-help This will display a help message including a list of command line options.
-hide msgtype{,msgtype}* Tell bzadmin not to show these message types. The available message types are: chat, join, kill, leave, pause, ping, rabbit, and spawn. By default chat, join, kill, leave, pause, and rabbit are shown.
-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.

Other Examples[edit]

Join the game on localhost, port 5154, using the callsign 'admin'.

bzadmin admin@localhost:5154

Connect to the server at localhost and ban the IP 192.168.0.2 for 2 hours.

bzadmin admin@localhost "/password secretpass" "/ban 192.168.0.2 2h test"

Connect to bzserver.org and print all server messages that contain 'magicword'.

bzadmin -ui stdout spy@bzserver.org | grep magicword