Difference between revisions of "HostingBuddy"

Revision as of 10:00, 28 June 2009

HostingBuddy is a WormNET bot developed by Glide, CyberShadow, Byte and madewokherd. It can be found in #AnythingGoes, and it will host games for you when asked. When you join your game, you will be able to control and customize it using text commands.

HostingBuddy was created in late 2006, however due to a memory corruption bug it was very unstable, and crashed every few hours (and disconnecting players in all games it was hosting). It wasn't until June 2009 that the bug was finally fixed, and HostingBuddy could be considered stable.

Maps

Custom maps exist for each game scheme type and are randomly chosen. Maps can also be loaded directly from WMDB using their map number.

Private Games

All players must provide a password. When the host joins, any players using a different password will be kicked.

Commands

All commands are prefixed with !.
Use help <command> to get details on a command.
Parameters in <angular brackets> are required, those in [square brackets] are optional. | means "or" - A|B means "A or B".
Commands sent by the game owner are not visible to other players.

#AnythingGoes

To send HostingBuddy a command in #AnythingGoes, type either /msg HostingBuddy command (preferred) or !command.

help [command]: Displays a list of commands, or details for a specific command

host <scheme>: Hosts a new game with the specified scheme

phost <scheme>: Hosts a new private game with the specified scheme

schemes: Displays a list of default schemes

Lobby

General commands

help [command]: Displays a list of commands and a short usage summary, or details for a specific command

start: Starts the game when all players have lit up. If they have not all lit up yet, the game will start automatically when they are.; Use !stop or turn your own light off to cancel automatic start.

stop: If HostingBuddy is lit up, the game will start automatically - this will turn HostingBuddy's light off.

close: Closes the game - no more players will be able to join.

reopen: Reopens the game - allows more players to join.; (aliases: open)

kick <player name>: Remove the specified player from the game.; (aliases: boot)

version <name>

Sets the game version to use.

Valid game versions are:

Normal
Batty
Fast (1.5x speed)
Test

Team commands

worms [team number] <worm count>: Sets the number of worms.; If a team number is not specified, the count is set for all teams.

colour <team number> <colour>

Sets a team's ally colour (you only need to specify the first letter).

Valid colours are:

Red
Blue
Green
Yellow
Magenta (aliases: Pink)
Cyan

(aliases: color)

handicap [team number] +|x|-: Sets a team's energy handicap.; If a team number is not specified, the handicap is set for all teams.

remove <team number>: Removes a team.; If a player is being disruptive it will probably be easier to !kick them.

Map/scheme commands

map [filter]: Selects a random map from the map pool, or generates a random landscape.; filter is a mask for colour maps, and the texture for generated maps (e.g. "Fruit" or "Cheese").

type [cavern|island|auto]

Selects whether or not the next PNG map will be an island or a cavern.

cavern (map will always be set to cavern)
island (map will always be set to island)
auto (map type will be read from file; defaults to island)

border [yes|no|auto]

Selects whether or not the next PNG map will have a border or not.

yes (map will always have a border)
no (map will never have a border)
auto (border setting will be read from file; defaults to no border)

water [drop|0-100|auto]

Selects the initial water level of the next PNG map.

drop (initial water level will enable water drops)
0-100 (initial water level will be a certain percentage of the map's height)
auto (initial water level will be read from file; defaults to lowest possible)

wmdb <map number>: Downloads and sends a map from WMDB.; You must specify the map number (from the URL).

wsdb <scheme number>: Downloads and uses a scheme from WSDB.; You must specify the scheme number (from the URL).
wsdb save: Saves the current scheme to WSDB.

schemes: Displays available schemes.

load <scheme name>: Loads a different game scheme.

reset: Resets the game scheme.

Game options

energy <number>: Sets worms' initial energy level.; (aliases: en, life)

rounds <number>: Sets the number of victories required to win the match.; (aliases: ro)

wormselect [on|off]: Toggles worm select.; (aliases: ws, select, sel)

teleport [on|off]: Toggles initial teleport.; (aliases: tp, tele)

artillery [on|off]: Toggles artillery (anchored) mode.; (aliases: an, anchor)

stockpiling on|off|anti

Sets stockpiling options:

On (new ammo on each round)
Off (restock ammo on each round)
Anti (one set of ammo for the whole game)

(aliases: sp)

donorcards [on|off]: Toggles donor cards.; (aliases: dc, donor)

falldamage [on|off|<value>]: Toggles fall damage.; (aliases: fd, falldamage)

Time options

turntime <seconds>: Sets the turn time.; Use inf[inite] for infinite turn time.; (aliases: tt, turn)

roundtime <minutes>: Sets the round time in minutes.; (aliases: rt, round)

roundtime <seconds>s: Sets the round time in seconds.; (aliases: rt, round)

weaponretreat <seconds>: Sets the weapon retreat time in seconds.; (aliases: wr)

roperetreat <seconds>: Sets the rope retreat time in seconds.; (aliases: rr)

turndelay <seconds>: Sets the hotseat delay time in seconds.; (aliases: td, hotseatdelay, hotseat, hd)

showtime [on|off]: Toggles round time display.; (aliases: st)

Crate options

weaponcrates <percentage>: Sets chance of weapon crates.; (aliases: wc, weaponcrate)

utilitycrates <percentage>: Sets chance of utility crates.; (aliases: uc, utilitycrate)

healthcrates <percentage>: Sets chance of health crates.; (aliases: hc, healthcrates, healthcrate, firstaidcrates, firstaidcrate)

crateenergy <number>: Sets health gained from health crates.; (aliases: ce, firstaid, fa)

Object options

Each of the first three options overrides each other, i.e. you can choose mines/drums/both (use 0 of either for no objects).

objects <number>: Sets number of mines/oil drums on terrain.; (aliases: ob)

drums <number>: Sets number of oil drums on terrain.; (aliases: oildrums, od)

mines <number>: Sets number of mines on terrain.; (aliases: mi)

dud [on|off]: Toggles dud mines.

fuse <seconds>: Sets mine fuse time.; Use ? for random.; (aliases: minefuse, mf)

Sudden death options

suddendeath end|nuke|classic|none

Sets sudden death mode:

end (end game)
nuke (nuclear strike)
classic (classic (1 HP) mode)
none (no action (no energy lost))

(aliases: sd)

waterrise none|slow|medium|fast: Sets sudden death water rise speed (you can also use 0 to 7).; (aliases: rise)

General options

replay [on|off]: Toggles automatic replays.

blood [on|off]: Toggles blood mode.; (aliases: bl)

godmode [on|off]: Toggles god mode (invincible worms).; (aliases: gm, invworms, iw)

indland [on|off]: Toggles indestructible land.; (aliases: il)

Weapon options

teamweapons [on|off]: Toggles team special weapons.; (aliases: tw, playerweapons, pw)

superweapons [on|off]: Toggles super weapons.; (aliases: sw, super)

aquasheep [on|off]: Toggles Aqua Sheep.; (aliases: as, aqua)

sheepheaven [on|off]: Toggles Sheep Heaven.; (aliases: sh, sheep)

goldgrenade [on|off]: Toggles golden grenades.; (aliases: gg)

goldshotgun [on|off]: Toggles golden shotgun.; (aliases: gs)

goldbanana [on|off]: Toggles golden bananas.; (aliases: gb)

goldlongbow [on|off]: Toggles golden longbows.; (aliases: gl, goldbow)

Weapon configuration

HostingBuddy finds weapons by comparing what you enter to the start of the weapon name, if it finds no matches then it removes the first word of each weapon and tries again. You will need to specify more of the full weapon name if multiple weapons start with the same name, e.g. Mine since Mine Strike exists.

Examples:

Bazooka
Ninja Rope
Girder Starter-Pack
Patsy's Magic Bullet

ammo <weapon name> <amount>: Sets weapon ammo.; Use inf[inite] for infinite ammo.; (aliases: am)

power <weapon name> <level>: Sets weapon power.; (aliases: po)

delay <weapon name> <turns>: Sets weapon turn delay.; (aliases: de)

crate <weapon name> <number>: Sets weapon crate probability.; (aliases: cr, crates)

External links

Forum thread on the development progress of HB

@@ Line 6: / Line 6: @@
 == Maps ==
 Custom maps exist for each game scheme type and are randomly chosen. Maps can also be loaded directly from [[WMDB]] using their map number.
+== Private Games ==
+All players must provide a password. When the host joins, any players using a different password will be kicked.
 == Commands ==
@@ Line 21: / Line 24: @@
 ; host <''scheme''>
 : Hosts a new game with the specified scheme
+; phost <''scheme''>
+: Hosts a new private game with the specified scheme
 ; schemes