rocket-league-gym-sim

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

rocket-league-gym-sim

★ 31 Open GitHub ↗

A version of RLGym for use with the RocketSim simulator.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# rocket-league-gym-sim
A version of [RLGym](https://www.rlgym.org) for use with the [RocketSim](https://github.com/ZealanL/RocketSim) simulator.

## FOREWORD
This project is a TEMPORARY STOP-GAP to use RocketSim while RLGym 2.0 is in development. I provide no guarantees that it is bug-free or that I will not make breaking changes to this project in the future.

This project requires you to acquire assets from a copy of Rocket League that you own with an asset dumper. I will not walk you through this process. The necessary links and basic instructions are listed below. If you cannot follow those, don't bother me.

## INSTALLATION
1. Install RocketSim via `pip install rocketsim` 
2. Install this project with pip via `pip install git+https://github.com/AechPro/rocket-league-gym-sim@main`
3. Build and run the [asset dumper](https://github.com/ZealanL/RLArenaCollisionDumper)
4. Move the dumped assets to the top level of your project directory

## USAGE
This project acts as a drop-in replacement for RLGym and can be used in exactly the same way. Barring the changed variables listed below, you can replace every instance of `rlgym` with `rlgym_sim` (or simply `import rlgym_sim as rlgym`) and your existing RLGym code should work.

All variables having to do with the game client have been removed from the `make` function. For example, `rlgym_sim.make(use_injector=True)` will fail because there is no injector. The following is a list of all removed `make` variables:
- `use_injector`
- `game_speed`
- `auto_minimize`
- `force_paging`
- `launch_preference`
- `raise_on_crash`
- `self_play`

Thanks to the flexibility of the simulator, the following additional variables have been added as arguments to `make`:
- `copy_gamestate_every_step`: Leave this alone for the default behavior. Setting this to `True` will no longer return a new `GameState` object at every call to `step`, which is substantially faster. However, if you need to track data from the game state or its member variables over time, you will need to manually copy all relevant `GameState`, `PlayerData`, and `PhysicsObject` data at each `step`.
- `dodge_deadzone`: Sets the threshold value that `pitch` must meet in order for a dodge to occur when jumping in the air.

## KNOWN ISSUES
- A variety of classes in `rlgym_utils` such as `SB3MultipleInstanceEnv` imports the `rlgym` library to build environments, so you will need to replace those imports yourself and remove the misc launch options listed above if you want to use SB3 with `rlgym_sim`. Note also that `SB3MultipleInstanceEnv` waits 60 seconds between launching clients by default because multiple Rocket League clients will break each other if launched simultaneously. This is not the case with RocketSim, so you can remove that delay.
- the `PlayerData` objects do not track `match_saves` or `match_shots` yet.

rocket-league-gym-sim

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README