Skip to content

Instantly share code, notes, and snippets.

@thomasleveil

thomasleveil/B3_ravaged_howto.md

Created October 19, 2012 21:33
Show Gist options
  • Save thomasleveil/3920856 to your computer and use it in GitHub Desktop.
Save thomasleveil/3920856 to your computer and use it in GitHub Desktop.
Download ZIP
BigBrotherBot for Ravaged HOWTO
Raw
B3_ravaged_howto.md

BigBrotherBot for Ravaged HOWTO

Starting from v1.9.0dev10 BigBrotherBot (B3) has support for Ravaged dedicated game servers.

Install

  • Download the Windows package from http://files.cucurb.net/b3/ (let's say we take BigBrotherBot-1.9.0dev10-win32.zip)
  • Unzip BigBrotherBot-1.9.0dev10-win32.zip
  • Go to the conf folder
  • Download this example config file : https://raw.github.com/gist/3920646/b3.xml and save it into the conf folder under the name b3.xml (or use the online generator)
  • Edit the conf\b3.xml with your Ravaged server IP address, game port (usually 8000), rcon IP address, rcon port (usually 13550) and rcon password. (refer to your Ravaged server config file if you are unsure)
  • Join your Ravaged game server
  • Start B3 by double clicking on b3_run.exe
  • In-game you should see a message saying B3 is started (if not refer to the log file in conf\b3.log)
  • If B3 is started, be the first one to type in the in-game chat !iamgod
  • B3 will reply that you are now the superadmin

Support

If you had issues will installing, refer to the log file (conf\b3.log). If you can't figure out what went wrong, ask for help on the B3 forums in the Ravaged section at http://forum.bigbrotherbot.net/ravaged/. Make sure to provide your b3.log file.

Config

B3 is composed of plugins that add commands that can be typed in the in-game chat. Commands start with !. Plugins can also do stuff on their own, reacting to game events. Every time B3 starts, it will update a command documentation file that you will find in your config folder under the name b3_doc.htm. This documentation lists all commands provided by the loaded plugins. You can add/remove plugin by editing the b3.xml main config file. See at the end in the section named plugins. You can edit plugins settings by editing their own config file wich also are in the conf folder.

When you change config files, make sure you do not break the XML syntaxe. A XML capable text editor such as Notepad++ can help with that.

You need to restart B3 to have the new config files reloaded. Make sure to keep an eye to your b3.log file to check your plugins are loading fine.

Usage

The Admin plugin provides useful commands to manage your game servers and players. The most useful ones are :

  • !kick <player name> <reason> kick a player. You don't have to give the full exact name of the player, partial name works fine.
  • !maps list the available maps
  • !map <map name> load a new map (partial map name works too, for instance try : !map oil to load Thrust_Oilrig)
  • !maprotate to load the next map as defined in your map rotation list

Again, refer to the conf\b3_doc.htm file for the exhaustive list of available commands.

Also refer to the BigBrotherBot website and forums where you will find more documentation and plugins

Links

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment