The Ravenous Bugblatter Beast of Traal
Stupid, but extremely ravenous!

Monster Plugin - Version 3.5 - Reference

Filename: plugin_blatt_monster

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

Erm, shooting any monsters nearby would be a good idea ;)

Administrator Usage

The following administrator level commands are supported. All require ACCESS_CONFIG (512) except for a bbmonster_spawn which requires ACCESS_KICK (128):

bbmonster_report [ "on" | "off" ]
If called with no arguments, displays the current configuration. If an argument is supplied, it switches on/off the automatic display of the report after every other command is issued.
bbmonster_reset
Changes all settings back to their default values as described on this page.
bbmonster_enabled "on" | "off"
Enables or disables the monster plugin. Disabling the plugin will kill any active monsters in the game.
bbmonster_spawn <monster name>
Spawns a monster on the player in the callers cross-hair. See the Configuration Guide for details on how to bind this command to a key.
bbmonster_spawn <monster name> <player name>
Spawns a monster on a player specified.
bbmonster_spawn <monster name> @<x> <y> <z>
Spawns a monster at the co-ordinates specified.
bbmonster_mania "on" | "off"
Enables or disables monster mania mode. In monster mania mode, two monsters are spawned every 50 to 70 seconds - one on a player from each team. (NOTE: Currently assumes there are only 2 teams)
bbmonster_maxmonsters <n>
Sets the maximum number of monsters a single player can spawn with the bbmonster_spawn command in a given time period.
bbmonster_timeout <n>
Sets the length of the time period for bbmonster_maxmonsters.
bbmonster_score <n>
Sets the number of frags a player receives for killing a monster spawned by a player or added to a map as a static spawn using the Botman metamod plugin.
bbmonster_maniascore <n>
Sets the number of frags a player receives for killing a monster spawned by monster mania.

Server console commands

The modified monster metamod plugin implements two commands. You should not need to use these however - they will be executed by plugin_blatt_monster as and when required.

monster model <model name> [tag <tag name>] [score <score>] [player <player name>] [origin <x> <y> <z>] [targetteam <team number>] [targetplayer <player name>]
Spawns a monster. The arguments can be provided in any order. The model argument and either the player or origin must be provided; the others are optional.
  • "model" is the name of the monster type to spawn, as defined in the precache.ini file or map specific precache file.
  • "tag" is an alphanumeric string you make up to identify this monster when it makes a kill or is killed.
  • "score" is the number of frags to award to the player that kills the monster.
  • "player" is the name of the player to spawn the monster near. You can specify their index number instead of their name by preceding it with a #. NOTE: Index number is the slot from 1 - 32 that the player occupies, or the WONID, SteamID or SessionID or a partial player name (as with any Admin Mod command). You can force it to match on name and any id be preceding it with a \ character./
  • "origin" is the x/y/z co-ordinates of where to spawn the monster.
  • "targetteam" is the team number the monster is allowed to target.
  • "targetplayer" is the player the monster is allowed to target.
NOTE: If you specify a player, but not targetplayer, it will spawn near the selected player, but may attack anyone. If specify a targetteam or targetplayer it will only *intentionally* attack that team/player. However, if hits anyone else, it will still cause damage.
slaymonsters "true" | "false"
Kills all monsters currently in the game. If the argument "true" is supplied, the monsters will be removed instantly. If the argument "false" is supplied, or no argument, the monster AI will be given the goal to die. This means the monster's death animation is played and you will see a body, but isn't 100% reliable; they sometimes survive.
respawnmonsters
Respawns any monsters configured in the map configuration file immediately, ignoring any delay that has been configured. This is useful in games such as counter-strike to ensure all monsters are in play at the start of around.