RLBotGUI
About
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: https://github.com/RLBot/RLBot
Works on Windows and Linux
Features
- 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
Screenshots
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!
Installation
If you just want to use this GUI, you can go download the installer from http://www.rlbot.org/
It will put "RLBotGUI" in your Windows start menu.
Dev Environment Setup
Prerequisites
- Python 3.7
Setup
- In a command prompt, run
pip install -r requirements.txt - Run
python run.py
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!
Automated
To deploy:
- Look in
setup.pyand increment the version number - Push a commit to the master branch (or open a PR with your changes to the master branch)
- After the commit is made, a new version will automatically be deployed to PyPi.
Manual
To deploy:
- Create a
.pypircfile like the one described here: https://github.com/RLBot/RLBot/wiki/Deploying-Changes#first-time-setup - Look in
setup.pyand increment the version number. - Run
publish-to-pypi-prod.bat
Note
When deploying to pypi, the files which get included are controlled by the MANIFEST.in 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 MANIFEST.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, run.py, or anything else that gets referenced in installer.cfg. AVOID THIS because you don't want to run around bugging users to reinstall.
- Follow https://pynsist.readthedocs.io/en/latest/index.html to get NSIS installed.
- Run
pip install pynsist - Run
pynsist installer.cfg
Find the resulting executable in build\nsis.
How to update items in the appearance editor
- Install and run BakkesMod
- In Rocket League, press F6 to open the BakkesMod console, and enter the
dumpitemscommand - Find the output
items.csvin the folder where yourRocketLeague.exeis, usuallyC:/Program Files (x86)/Steam/steamapps/common/rocketleague/Binaries/Win64 - Replace
rlbot_gui/gui/csv/items.csvwith the new file - 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
- Don't forget to bump the version number in
setup.py
7 maintainers
Release files for rlbot-gui 0.0.164
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| rlbot_gui-0.0.164.tar.gz | 5.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| rlbot_gui-0.0.164-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.3 MB
Release files / rlbot_gui-0.0.164.tar.gz
| Download URL | rlbot_gui-0.0.164.tar.gz |
|---|---|
| Size | 5.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
229097eb85067db7a6c62a18d2ba75acee87c01eb343e4612c5f81567d33db32
|
|
BLAKE2b-256 checksum How to use checksums |
1720002d23a646e1916decf0943a569c724c98bc923ab036b64822b68fb30e3c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 14, 2026.
Transparency logRelease files / rlbot_gui-0.0.164-py3-none-any.whl
| Download URL | rlbot_gui-0.0.164-py3-none-any.whl |
|---|---|
| Size | 5.7 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
aa5d7872e8eaf5d78d4ae03d3f18a0856ef5dc9976049426d5525fcd1c4b1460
|
|
BLAKE2b-256 checksum How to use checksums |
b31e7c288a9c37e62c8b37a27eeaa12f7679ff8bf66f94bb65ee80acdc4f9699
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Apr 14, 2026.
Transparency log
