{"id":18555955,"url":"https://github.com/rlbot/rlbot","last_synced_at":"2025-05-15T08:07:34.925Z","repository":{"id":37736053,"uuid":"80671678","full_name":"RLBot/RLBot","owner":"RLBot","description":"A framework that allows people to write their own Rocket League bots.","archived":false,"fork":false,"pushed_at":"2024-06-02T13:27:18.000Z","size":77534,"stargazers_count":595,"open_issues_count":36,"forks_count":117,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-04-10T19:06:30.116Z","etag":null,"topics":["hacktoberfest","rocket-league"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RLBot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-02-01T22:36:52.000Z","updated_at":"2025-04-04T23:37:10.000Z","dependencies_parsed_at":"2022-07-12T15:18:26.890Z","dependency_job_id":"628b8eea-f838-4eba-b1f7-01168395ed52","html_url":"https://github.com/RLBot/RLBot","commit_stats":{"total_commits":893,"total_committers":59,"mean_commits":"15.135593220338983","dds":0.6651735722284434,"last_synced_commit":"e34dd4598bc643e2b8e50b77f7ffe4ca38e335de"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RLBot%2FRLBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RLBot%2FRLBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RLBot%2FRLBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RLBot%2FRLBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RLBot","download_url":"https://codeload.github.com/RLBot/RLBot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248870723,"owners_count":21175095,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","rocket-league"],"created_at":"2024-11-06T21:28:33.223Z","updated_at":"2025-04-14T11:26:43.461Z","avatar_url":"https://github.com/RLBot.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# YOU PROBABLY SHOULDN'T PULL THIS REPO\n\n## Bot Makers Read This!\n\n***If you just want to make a bot, you don't need to be here. Instead, start with one of these:***\n - Python - https://github.com/RLBot/RLBotPythonExample\n - Java - https://github.com/RLBot/RLBotJavaExample\n - C# (and other .NET languages) - https://github.com/RLBot/RLBotCSharpExample\n - Scratch - https://github.com/RLBot/RLBotScratchInterface\n - Rust - https://crates.io/crates/rlbot\n\n***If you just want to play with some bots, you can go to [RLBotGUI](https://github.com/RLBot/RLBotGUI) to easily start matches with bots***\n\n## Framework Contributors\n\nThis repository is currently incomplete to meet the legal needs of the Psyonix API. It is missing the source code behind RLBot.exe, and a few other files. If you want to make a code change that involves RLBot.exe (or the interface dll since it's closely related), you'll need some help from someone with access to the closed repo.\n\nWe expect we'll be able to open-source everything eventually, and then this repo will be back in business.\n\n**NOTICE:** We intend to cherry-pick any commits you make here into the closed repo. At a later date, when we have permission to open-source everything, we will **force push** the closed repo to this master branch. Your commits will still be there with proper attribution, but if you have any work in progress, it will need to be rebased at that time.\n\n# RLBot\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"512\" height=\"158\" src=\"https://github.com/drssoccer55/RLBot/blob/master/images/RLBot.png\"\u003e\n\u003c/p\u003e\n\n[\u003cimg src=\"https://img.shields.io/pypi/v/rlbot.svg\"\u003e](https://pypi.org/project/rlbot/)\n[\u003cimg src=\"https://img.shields.io/bintray/v/rlbotofficial/RLBotMaven/rlbot-framework\"\u003e](https://bintray.com/rlbotofficial/RLBotMaven/rlbot-framework)\n[\u003cimg src=\"https://img.shields.io/nuget/v/RLBot.Framework\"\u003e](https://www.nuget.org/packages/RLBot.Framework/)\n[\u003cimg src=\"https://img.shields.io/crates/v/rlbot\"\u003e](https://crates.io/crates/rlbot)\n[\u003cimg src=\"https://img.shields.io/discord/348658686962696195.svg?colorB=7581dc\u0026logo=discord\u0026logoColor=white\"\u003e](https://discord.gg/zbaAKPt)\n\n\n\n## Framework Info\n\nThe RLBot framework helps people create bots for use in Rocket League's offline modes, just for fun.\nIt provides values from the game like car and ball position, and carries back button presses.\nRLBot works for up to 10 bots reliably; it can be used up to 64, but can result in issues (bots disappearing after goals, spawning inside one another, etc).\n\n### Requirements\nRocket League, Python 3.6+\n\n### Quick Start\n\n1. Run setup.bat (or equivalent if you're on Linux or Mac)\n1. Open a terminal and execute `python runner.py`\n\n### Development Workflow\n\nThe first thing you'll want to do is run `setup.bat`. This does a lot of important things:\n- Sets up your rlbot installation in pip to link to your local files in this folder. Once you've done this,\nrunning rlbot from *anywhere* on your computer will reference these local files, including the dlls, etc.\n- Generates important code based on the `.fbs` message spec. Therefore it's a prerequisite for running anything.\n- Installs python package dependencies.\n\nIf you're doing work that affects our `.dll` or `.exe` files, you should also be aware of:\n- `copy-dlls.bat` - This copies *the debug versions* any built dlls from visual studio into the correct subdirectory in\nthe python source folder.\n- `copy-dlls-release.bat` - This copies *the release versions* any built dlls from visual studio into the correct subdirectory in\nthe python source folder.\n\nFor deploying changes, please see https://github.com/RLBot/RLBot/wiki/Deploying-Changes\n\nWhen you're done with development and want to get back to the official rlbot version vended from\nhttps://pypi.org/project/rlbot/, the easiest way to do that is simply `pip uninstall rlbot`. Then\nthe next time you execute a bat file from one of the RLBot*Example repos, a fresh copy will be\ninstalled from pip.\n\n### Wikis\n\nThere's tons of good information at https://github.com/RLBot/RLBot/wiki\n\n### Extras\n\n#### Community Info\n - We have a [Discord server](https://discord.gg/VZJKWwJ) (the heart of the community, please join!)\n - [We also have a subreddit.](https://www.reddit.com/r/RocketLeagueBots/)\n - We are now on v4 of RLBot so be wary of outdated information.\n\n#### Video Example\n[![Video](https://github.com/drssoccer55/RLBot/blob/master/images/vid2thumb6.JPG)](https://youtu.be/aAXe21m0vWo)\n\n#### Tournament History\nTournament results are recorded in our [braacket league](https://braacket.com/league/rlbot).\n\nVideos:\n - [Tournament 1 highlights](https://www.youtube.com/watch?v=PY0ggWbpsPg)\n - [Tournament 1 1v1 highlights](https://www.youtube.com/watch?v=mqXwSqy_TOw)\n - [Tournament 2 2v2 highlights](https://www.youtube.com/watch?v=U-esRgPSfn4)\n - [Full video of the first tournament, day 1](https://youtu.be/SKIw4f0ZBxE)\n\n#### The best part\nPsyonix Cone gave us a thumbs up!\n![Thumbs up](https://github.com/drssoccer55/RLBot/blob/master/images/psyonixcone.jpg)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frlbot%2Frlbot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frlbot%2Frlbot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frlbot%2Frlbot/lists"}