The easiest way to customize your B3 install is by installing extra plugins. Plugins add features or functionality to your BigBrotherBot.

• 3rd party plugins
• Tools

Learn Python or learn from the other plugins that where already made for B3.

B3 framework documentation

Here's an example by Bakes how to add simple logic to a new plugin: http://forum.bigbrotherbot.net/the-code-bin/converting-simple-modifications-into-plugins/

Plugin overview

Plugin tutorial 1 - defining new commands, also shows how to write info to the B3 log file, how to interact with players (chat, kick, etc) and how to write tests for the plugin.

Plugin tutorial 2 - reading the plugin config file and how to make sure the data we read is acceptable.

The glue between B3 and a game is called a 'parser' in the B3 framework. Parsers all inherits from the b3.parser.Parser class.

1. Game requirements : check the game can be supported by B3
2. Overview of what a B3 parser is
3. Mapping game events to B3 events
4. Controlling the game

Step by step example of a parser implementation with the Altitude game :

1. creating the parser file
2. adding rcon capabilities and example of b3.xml full altitude.py file
3. routing game log events to our methods full altitude.py file
4. handling 3 game events : player connects, player disconnect, player chat We got a first alpha version allowing to use the !iamgod command ! full altitude.py file
5. completing the parser full altitude.py file

Do you want to participate? Code plugins or even B3 core enhancements?

Make sure you read these pages:

1. B3 Coding Conventions
2. Using Git and Github
3. Documenting code for doc.bigbrotherbot.net