Skip to main content

A streamlined user interface for RLBot.

Project description

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

HomeScreenshot

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

StoryMode

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

  1. In a command prompt, run pip install -r requirements.txt
  2. 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:

  1. Look in setup.py and increment the version number
  2. 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:

  1. Create a .pypirc file like the one described here: https://github.com/RLBot/RLBot/wiki/Deploying-Changes#first-time-setup
  2. Look in setup.py and increment the version number.
  3. 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.

  1. Follow https://pynsist.readthedocs.io/en/latest/index.html 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 setup.py

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.163.tar.gz (5.6 MB view details)

Uploaded Source

Built Distribution

rlbot_gui-0.0.163-py3-none-any.whl (5.7 MB view details)

Uploaded Python 3

File details

Details for the file rlbot_gui-0.0.163.tar.gz.

File metadata

  • Download URL: rlbot_gui-0.0.163.tar.gz
  • Upload date:
  • Size: 5.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for rlbot_gui-0.0.163.tar.gz
Algorithm Hash digest
SHA256 b92a1718e7a78c40173b0415d45b521e9a02a49f5caa9938d02fa3e41ce455cd
MD5 7c95702764f298ae30a1a76d6dbb9842
BLAKE2b-256 18d5791fbb17a2d3d8f251e90c92a5a4ccbad47ef93f58569b9221877dbd6013

See more details on using hashes here.

Provenance

The following attestation bundles were made for rlbot_gui-0.0.163.tar.gz:

Publisher: publish.yml on RLBot/RLBotGUI

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file rlbot_gui-0.0.163-py3-none-any.whl.

File metadata

  • Download URL: rlbot_gui-0.0.163-py3-none-any.whl
  • Upload date:
  • Size: 5.7 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for rlbot_gui-0.0.163-py3-none-any.whl
Algorithm Hash digest
SHA256 52814fc6370ca2a8ff65eff9f5ae3c81ba96802b601c6371e3f00716ce28aa03
MD5 d4aeba8108d297476ca841afa628d3c7
BLAKE2b-256 05877de61fdab3947b830bf3dcb9b39de2985e690b4ee18c21f575148ddef126

See more details on using hashes here.

Provenance

The following attestation bundles were made for rlbot_gui-0.0.163-py3-none-any.whl:

Publisher: publish.yml on RLBot/RLBotGUI

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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