Skip to main content

A streamlined user interface for RLBot.

Project description



RLBotGUI is a streamlined user interface that helps you run custom Rocket League bots for offline entertainment. It relies on the RLBot project to work its magic:

Works on Windows and Linux


  • Download various bots programmed by the community
  • Get started with creating your own bot
  • Create matches against bots
    • Customize game mode, arena and mutators!
  • Try out the Story Mode


You can download, update or create bots


In Story Mode, you can take over cities by beating challenges and can also recruit teammates and purchase upgrades for your car!



If you just want to use this GUI, you can go download the installer from

It will put "RLBotGUI" in your Windows start menu.

Dev Environment Setup


  • Python 3.7


  1. In a command prompt, run pip install -r requirements.txt
  2. Run python

Deployment to PyPI

For normal changes, e.g. things happening inside the rlbot_gui folder, you should be publishing an update to PyPI. All users will get this change automatically without needing to reinstall!

To deploy:

  1. Create a .pypirc file like the one described here:
  2. Look in and increment the version number.
  3. Run publish-to-pypi-prod.bat


When deploying to pypi, the files which get included are controlled by the file. You may wish to exclude anything which does not belong in the initial install, e.g. bot logos which get copied in to the GUI folder as you use the program.

As a rule of thumb, if you add something to .gitignore, it may also belong in as a prune line.

Building the Installer

You can build an installer executable for users to download. You will rarely need to do this, because normal updates should be pushed to users by deploying to PyPI.

You really only need a new installer if you changed something in the pynsist_helpers folder,, or anything else that gets referenced in installer.cfg. AVOID THIS because you don't want to run around bugging users to reinstall.

  1. Follow to get NSIS installed.
  2. Run pip install pynsist
  3. Run pynsist installer.cfg

Find the resulting executable in build\nsis.

How to update items in the appearance editor

  1. Install and run BakkesMod
  2. In Rocket League, press F6 to open the BakkesMod console, and enter the dumpitems command
  3. Find the output items.csv in the folder where your RocketLeague.exe is, usually C:/Program Files (x86)/Steam/steamapps/common/rocketleague/Binaries/Win64
  4. Replace rlbot_gui/gui/csv/items.csv with the new file
  5. Change encoding of the new file to UTF-8. Here's how to do that in VS Code:
    • use the Change File Encoding command (or click the UTF-8 button in the bottom right)
    • select Reopen with Encoding, select the one with Guessed from content
    • now do that again, but Save with Encoding and UTF-8
  6. Don't forget to bump the version number in

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rlbot_gui-0.0.155.tar.gz (5.6 MB view hashes)

Uploaded source

Built Distribution

rlbot_gui-0.0.155-py3-none-any.whl (5.6 MB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page