# RLBotGUI
[<img src="https://img.shields.io/pypi/v/rlbot-gui.svg">](https://pypi.org/project/rlbot-gui/)
## 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
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
1. Look in `setup.py` and increment the version number.
1. 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](http://www.bakkesmod.com/)
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`
Raw data
{
"_id": null,
"home_page": "https://github.com/RLBot/RLBotGUI",
"name": "rlbot-gui",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "rocket-league",
"author": "RLBot Community",
"author_email": "rlbotofficial@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/46/34/2f9ee15bf36e134721749053ede837f4cc0a4eb63be8d8f562c829da3967/rlbot_gui-0.0.162.tar.gz",
"platform": null,
"description": "# RLBotGUI\n\n[<img src=\"https://img.shields.io/pypi/v/rlbot-gui.svg\">](https://pypi.org/project/rlbot-gui/)\n\n## About\n\nRLBotGUI is a streamlined user interface that helps you run custom\nRocket League bots for offline entertainment. It relies on the RLBot\nproject to work its magic: https://github.com/RLBot/RLBot\n\nWorks on Windows and Linux\n\n## Features\n\n- Download various bots programmed by the community\n- Get started with creating your own bot\n- Create matches against bots\n - Customize game mode, arena and mutators!\n- Try out the Story Mode\n\n## Screenshots\n\nYou can download, update or create bots\n\n\n\n\nIn Story Mode, you can take over cities by beating challenges and can also\nrecruit teammates and purchase upgrades for your car!\n\n\n\n## Installation\n\nIf you just want to use this GUI, you can go download the installer from http://www.rlbot.org/\n\nIt will put \"RLBotGUI\" in your Windows start menu.\n\n## Dev Environment Setup\n\n### Prerequisites\n\n- Python 3.7\n\n### Setup\n\n1. In a command prompt, run `pip install -r requirements.txt`\n2. Run `python run.py`\n\n### Deployment to PyPI\n\nFor normal changes, e.g. things happening inside the rlbot_gui folder,\nyou should be publishing an update to PyPI. All users will get this change\nautomatically without needing to reinstall!\n\n#### Automated\n\nTo deploy:\n1. Look in `setup.py` and increment the version number\n2. Push a commit to the master branch (or open a PR with your changes to the master branch)\n - After the commit is made, a new version will automatically be deployed to PyPi.\n\n#### Manual \n\nTo deploy:\n1. Create a `.pypirc` file like the one described here:\nhttps://github.com/RLBot/RLBot/wiki/Deploying-Changes#first-time-setup\n1. Look in `setup.py` and increment the version number.\n1. Run `publish-to-pypi-prod.bat`\n\n#### Note\nWhen deploying to pypi, the files which get included are controlled by the MANIFEST.in file.\nYou may wish to exclude anything which does not belong in the initial install, e.g.\nbot logos which get copied in to the GUI folder as you use the program.\n\nAs a rule of thumb, if you add something to .gitignore, it may also belong in MANIFEST.in\nas a prune line.\n\n### Building the Installer\n\nYou can build an installer executable for users to download. You will rarely need\nto do this, because normal updates should be pushed to users by deploying to PyPI.\n\nYou really only need a new installer if you changed something in the pynsist_helpers\nfolder, run.py, or anything else that gets referenced in installer.cfg. **AVOID THIS**\nbecause you don't want to run around bugging users to reinstall.\n\n1. Follow https://pynsist.readthedocs.io/en/latest/index.html to get NSIS installed.\n2. Run `pip install pynsist`\n3. Run `pynsist installer.cfg`\n\nFind the resulting executable in build\\nsis.\n\n### How to update items in the appearance editor\n1. Install and run [BakkesMod](http://www.bakkesmod.com/)\n2. In Rocket League, press F6 to open the BakkesMod console, and enter the `dumpitems` command\n3. Find the output `items.csv` in the folder where your `RocketLeague.exe` is, usually `C:/Program Files (x86)/Steam/steamapps/common/rocketleague/Binaries/Win64`\n4. Replace `rlbot_gui/gui/csv/items.csv` with the new file\n5. Change encoding of the new file to UTF-8. Here's how to do that in VS Code:\n - use the _Change File Encoding_ command (or click the UTF-8 button in the bottom right)\n - select _Reopen with Encoding_, select the one with _Guessed from content_\n - now do that again, but _Save with Encoding_ and _UTF-8_\n6. Don't forget to bump the version number in `setup.py`\n",
"bugtrack_url": null,
"license": null,
"summary": "A streamlined user interface for RLBot.",
"version": "0.0.162",
"project_urls": {
"Homepage": "https://github.com/RLBot/RLBotGUI"
},
"split_keywords": [
"rocket-league"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8767f95badf6e6b4cb749fbbd45c9d98cf77e5c644f1e66e7133b2f8a4da7f36",
"md5": "ac373d233c8658bae47a51e5d766bf82",
"sha256": "283ecf8f83a8d0cdbba0c67dbc9483c9c42d7a3e6cea10a2e416b8077582abb7"
},
"downloads": -1,
"filename": "rlbot_gui-0.0.162-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ac373d233c8658bae47a51e5d766bf82",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 5661973,
"upload_time": "2025-02-12T07:03:10",
"upload_time_iso_8601": "2025-02-12T07:03:10.329262Z",
"url": "https://files.pythonhosted.org/packages/87/67/f95badf6e6b4cb749fbbd45c9d98cf77e5c644f1e66e7133b2f8a4da7f36/rlbot_gui-0.0.162-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "46342f9ee15bf36e134721749053ede837f4cc0a4eb63be8d8f562c829da3967",
"md5": "c6b4d011e3495a46a9f8d800ba60d986",
"sha256": "1b968df87e43d83209e85c9bb771ceb3ee69a69b7e1a94fc6b4e8f0f51c7f88b"
},
"downloads": -1,
"filename": "rlbot_gui-0.0.162.tar.gz",
"has_sig": false,
"md5_digest": "c6b4d011e3495a46a9f8d800ba60d986",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 5640073,
"upload_time": "2025-02-12T07:03:13",
"upload_time_iso_8601": "2025-02-12T07:03:13.327075Z",
"url": "https://files.pythonhosted.org/packages/46/34/2f9ee15bf36e134721749053ede837f4cc0a4eb63be8d8f562c829da3967/rlbot_gui-0.0.162.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-12 07:03:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "RLBot",
"github_project": "RLBotGUI",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "rlbot",
"specs": [
[
"==",
"1.*"
]
]
},
{
"name": "pip",
"specs": []
},
{
"name": "gevent",
"specs": [
[
"==",
"24.*"
]
]
},
{
"name": "eel",
"specs": [
[
">=",
"0.12"
]
]
},
{
"name": "PyQt5",
"specs": []
}
],
"lcname": "rlbot-gui"
}
JSON
