A collection of ready-to-use bots and scripts made by the community. The compiled bot pack can be downloaded directly from the RLBot GUI.

Everyone is welcome to submit their bot/script to the bot pack.

Requirements:

• Open source: Your submission must be open source, and its repository must contain all necessary files and/or only use public dependencies.
• bot.toml or script.toml: Your submission must have a bot.toml or script.toml with
  • A unique agent id. We strongly recommend the format <yourname>/<botname>/<version>,
  • A name,
  • A working run command (and optionally a linux run command),
  • A logo file, and
  • All fields in the details section (description, fun fact, source link, developer, language, tags).
• bob.toml: A properly configured bob.toml file which allows our tool bob to build and package the submission. See the bob repository for further instructions and examples.
• Skill Limit: Your bot must be grand champion rank or lower (equal to Nexto or lower) due to the risk of cheaters taking advantage of your bot. Guideline: If your bot gets 42 goals before Nexto gets 28 in any soccar mode (1s, 2s, 3s), then it is too good.
• License (optional): Add a LICENSE file for your bot. The license must allow this bot pack to use the code and distribute the submission. If you do not include a LICENSE, the bot pack defaults to the MIT license.

After checking the requirements above, make a pull request to this repository that adds your bot as a submodule using git submodule add <yourgitrepo.git>.

The submodules in this repository are under the MIT license (see LICENSE), unless the individual submodules specify otherwise. Moreover, the owner of each submodule repository is allowed to change their license at any time as long as the new license still allows the bot pack to use the code and distribute the submission.

The owner of each submodule repository can request that their repository is removed as a submodule at any time.

Bob the bot builder is the tool used by the botpack to build, package, and generate incremental patches for the botpack. For this reason, your bot must have a properly configured bob.toml that allows Bob to build your bot.

For examples on how to use Bob, see https://github.com/swz-git/bob-example.