Whois Plugin - Version 3.8 - Reference
Filename: plugin_blatt_whois
Offline Manual
You are reading this offline manual for this plugin. The links to the right
navigate through the offline information. The links above and to the left
link to www.ravenousbugblatterbeast.pwp.blueyonder.co.uk.
If you downloaded the plugin from somewhere else, or downloaded it some time ago,
I recomend you check for an updated plugin. Note that the on-line manual may have been updated
even if the plugin hasn't.
Player Usage
This plugin does not expose any functions for use by general players.
Administrator Usage
The following commands can be issued from the console by an admin with
ACCESS_WHOIS. This access level is set at 1024 by default, which is currently
unused by the rest of adminmod. You can change it at the top of the sma file
and recompile if you want:
- bbwhois <player>
- Displays a brief report on the specified player in the console of the calling user.
- For players currently connected to the server "player" can be a name, partial
name, session ID, WONID, ValveID, SteamID or a previous name or partial name
that they have used on this map.
- For players that have played on the current map and have left, "player" can be a
name, partial name, WONID, ValveID or SteamID.
- For all other players you must supply a WONID, ValveID or SteamID
- The report is displayed in 3 sections at 1 second intervals to prevent the report
from overflowing the client.
- bbwhois_full <player>
- Displays a more detailed report on the specified player in the console of the calling user.
This report is displayed in 5 sections at 1 second intervals to prevent the report
from overflowing the client.
- bbwhois_note <player> <message>
- Records a note about the player in their report. The rules for specifying the "player"
argument are the same as for bbwhois command above.
- bbwhois_watch
- Returns a list players that should be watched.
- bbwhois_watch <player> [<reason>]
- Adds a watch to the specified player and logs the reason in their report. The rules
for specifying the player argument are as for the bbwhois command, however, the player
must still be connected when you issue the command.
- bbwhois_unwatch <player> [<reason>]
- Removes a watch from the specified player and logs the reason in their report. The rules
for specifying the player argument are as for the bbwhois command, however, the player
must still be connected when you issue the command.
- bbwhois_admin
- Returns a list players that have non-default adminmod access levels.
- bbwhois_lan
- Returns a list players playing on the same IP address or subnet.
The following commands can be issued from the console by an admin with
ACCESS_KICK:
- admin_kick <player> [<reason>]
- Kicks player from the server. This command functions in the normal way, but the kick
along with the reason is added to the player's report.
The following commands can be issued from the console by an admin with
ACCESS_BAN:
- admin_ban <player> <time> [<reason>]
- Bans the player from the server. This command functions in the normal way, but the ban,
time and reason are added to the player's report. If you wish to specify a reason for
a permanent ban, specify a time of 0 - e.g.
admin_ban Player 0 This person cheats
- admin_banip <player> <time> [<reason>]
- Bans the player from the server by IP address. This command functions in the normal way, but the ban,
time and reason are added to the player's report. If you wish to specify a reason for
a permanent ban, specify a time of 0 - e.g.
admin_banip Player 0 This person cheats
- admin_unban <player> [<reason>]
- Removes a ban on a player. This command functions in the normal way, but the unban,
time and reason are added to the player's report. NOTE: You must use an IP address for
the player arugment if you banned a player by IP. If this is the case you will see an
error message "Player not found" because the plugin is unable to log the unban against
a player banned by IP address. However, they will be unbaned.
The following commands can be issued from the console by an admin with
ACCESS_CONFIG:
- bbwhois_requirereason "on" | "off"
- When switched on, admins must supply a reason when using the watch, unwatch, kick,
ban and unban commands. When switched off, the reason argument is optional. A side-effect
of enabling this is that you must also specify a time period for all bans including permanent
ones as described above.
- bbwhois_teamkill "on" | "off"
- When switched on, the plugin will monitor team kills and record a note against a
player if:
- They kill the same player twice on consecutive rounds.
- They kill a player that killed them on the previous round.
- They kill two players during the same round.
Team kill detection is obvioulsy only of use in team based mods, and should be
switched off for other games. It is also only of used in round based games.
- bbwhois_requirecd "on" | "off"
- When switched on, the plugin will mediate Cheating-Death. This means that if cheating
death is installed, enabled and is in "optional" mode, the plugin will require players to
use Cheating-Death if they meet the criteria specified below, or if the player is watched.
- bbwhois_requirecd n "maximum"
- Sets the maximum number of rounds a player can play on the server before they must
use Cheating-Death.
- bbwhois_requirecd n "ratio"
- Sets the ratio of kills:deaths at which a player is required to use Cheating-Death
to n:1.
- bbwhois_requirecd n "minimum"
- Sets the number of rounds a player can play before their ratio is tested against
the above rule. E.g. The following settings mean a player will be required to use
Cheating-Death if that have played 50 rounds, or have played 10 rounds and have a K:D
ratio of 4:1 or better:
bbwhois_requirecd 50 maximum
bbwhois_requirecd 4 ratio
bbwhois_requirecd 10 minimum
bbwhois_requirecd on
- bbwhois_report
- Displays the plugin configuration settings.
- bbwhois_reset
- Resets all configuration settings to the defaults.
|