14 releases (4 breaking)

✓ Uses Rust 2018 edition

0.4.2 Apr 21, 2019
0.4.1 Apr 14, 2019
0.4.0 Mar 10, 2019
0.3.0 Dec 29, 2018
0.0.6 Sep 26, 2018

#13 in Games

Download history 129/week @ 2019-01-06 372/week @ 2019-01-13 1/week @ 2019-01-20 4/week @ 2019-01-27 3/week @ 2019-02-10 11/week @ 2019-02-17 3/week @ 2019-02-24 82/week @ 2019-03-03 66/week @ 2019-03-10 6/week @ 2019-03-17 150/week @ 2019-03-24 13/week @ 2019-03-31 17/week @ 2019-04-07 38/week @ 2019-04-14

165 downloads per month

MIT license

428KB
10K SLoC

rlbot

crates.io docs Build Status

RLBot is a framework for creating offline Rocket League bots. This crate lets you write bots using a simple, safe interface that should feel comfortable to Rust developers.

Documentation: We have it.

Stability: As you might notice, we're still on version 0.x. Breaking changes are still possible at this stage. Join the Discord to keep up-to-date!

Compatibility: We target the latest version of RLBot, and the latest stable version of Rust.

Usage

Your code will look a little something like this:

use rlbot::ffi;

fn main() -> Result<(), Box<Error>> {
    rlbot::run_bot(MyBot { /* ... */ })
}

struct MyBot { /* ... */ }

impl rlbot::Bot for MyBot {
    fn tick(&mut self, packet: &ffi::LiveDataPacket) -> ffi::PlayerInput {
        // ...
    }
}

This library comes with plenty of examples to get you started. For a list of examples, check out the docs.

Installing the framework

RLBot is needed to use this RLBot binding, of course. If the framework is not found in any of Windows's DLL search locations, init() will return this error:

Os { code: 2, kind: NotFound, message: "The system cannot find the file specified." }

You'll need to download these files from RLBot:

  • RLBot_Injector.exe
  • RLBot_Core.dll
  • RLBot_Core_Interface.dll

Place them in a directory in your $PATH. Alternatively, if you don't want to pollute your system, place them in your crate's target directory, e.g. target/debug or target/release).

Dependencies

~1MB