Skip to content
View RLpeak's full-sized avatar

Block or report RLpeak

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
RLPeak/README.md

RLPeak

RLPeak is an open-source Windows desktop companion for Rocket League, built around a simple, no-runtime-injection approach.

RLPeak V1 (current release line: V1.1.0) focuses on item customization with Decals, Wheels, and Boosts. More tools and plugins are planned for future versions.

V1 provides a fast workflow for decals, wheels, and boosts with:

  • one-click Apply
  • one-time original backups
  • reset to original files
  • local state persistence
  • no runtime injection.

Download

Download the latest Windows installer from the GitHub Releases page for this repository.

What RLPeak Is

  • A desktop companion app built with Tauri + React + TypeScript.
  • A V1 item customization workflow for Decals, Wheels, and Boosts.
  • A remote-first delivery client for catalogs and item-file downloads.
  • A foundation for future RLPeak plugins and tools.

Included Plugins (v1.1.0)

RocketStats Overlay

  • Session overlay for:
    • MMR delta
    • wins
    • losses
    • streak
  • Uses tracker.gg sync with browser-impersonation HTTP client path (wreq) in release builds.
  • Multiple built-in themes:
    • RocketStats Circle
    • RocketStats JSTKISS
    • RocketStats NativeTheme
    • Minimalist
  • Click-through transparent overlay window (no direct in-overlay interaction required).
  • Overlay controls in plugin manage page:
    • theme
    • scale
    • opacity
    • X/Y position.

Workshop Map Loader

  • Browse workshop map catalog from RLPeak API.
  • Load selected map to:
    • <rocketLeaguePath>/TAGame/CookedPCConsole/mods/Labs_Utopia_P.upk
  • Original game file remains untouched:
    • <rocketLeaguePath>/TAGame/CookedPCConsole/Labs_Utopia_P.upk
  • Supports first-time setup onboarding plus hot-swap flow once mods file exists.
  • Includes load progress modal and in-app tutorial flow.

What RLPeak Is Not

RLPeak does not:

  • inject DLLs
  • inject into RocketLeague.exe at runtime
  • perform runtime injection
  • edit game memory
  • add runtime hooks
  • bypass anti-cheat.

Trust Model

RLPeak is open source so users can verify how it works before running it.

Core trust points:

  • downloads happen only when the user clicks Apply
  • downloaded files are asset files only and are not executed
  • local backups are created before replacement
  • reset can restore original files from local backups
  • remote API access is scoped to the official RLPeak domain.

Privacy: Anonymous Usage Metrics

RLPeak includes an optional anonymous usage metrics client to help understand real app usage and improve reliability.

What RLPeak sends:

  • app lifecycle/action event names (for example app start, plugin actions, apply success/failure)
  • app version
  • platform
  • anonymous random install ID (UUID)
  • optional plugin ID and safe generic error code.

What RLPeak does not send:

  • Rocket League account data
  • Windows username
  • local file paths
  • Rocket League path
  • hardware fingerprints
  • raw logs or raw stack traces.

Control:

  • Users can disable anonymous usage metrics anytime in Settings.

Remote Delivery Model

Production API domain:

  • https://api.rlpeak.com

Primary endpoints:

  • Manifest: https://api.rlpeak.com/v1/manifest.json
  • Startup version gate: https://api.rlpeak.com/v1/app/version.json

Behavior:

  1. RLPeak fetches catalogs from the manifest URLs.
  2. Catalog JSON is cached locally in AppData/catalogs.
  3. Item files are downloaded only when the user clicks Apply.
  4. Downloaded item files are treated as assets and are not executed.
  5. Downloaded files are cached under AppData/cache/ItemsFiles.
  6. Apply copies from cache/local compatibility sources into Rocket League.

Downloads are user-triggered and use HTTPS only.

Local Backup and Reset

Before replacing a game file, RLPeak creates a one-time backup (if missing):

  • AppData/Backups/originals/...

Reset restores originals from backups and works offline.

Version Gate

On startup, RLPeak validates the installed app version against:

  • https://api.rlpeak.com/v1/app/version.json

If outdated or unavailable, app routes remain blocked until version checks pass or user retries/updates.

Official Links

  • Website: https://rlpeak.com
  • API: https://api.rlpeak.com

Build From Source

Requirements:

  • Node.js + npm
  • Rust toolchain
  • Tauri prerequisites for Windows

Build-only prerequisites for the default tracker.gg browser-impersonation path (mmr-wreq):

  • NASM (nasm.exe) for BoringSSL assembly during compile
  • LLVM/Clang (libclang.dll) for bindgen used by boring-sys2

Runtime note for end users:

  • RLPeak packaged app does not require NASM, Rust, Node, Python, or build toolchains at runtime.
  • These prerequisites are for developers/build machines only.

Install dependencies:

npm install

Run in development:

npm run tauri:dev

Run validation:

npm run lint
npm run typecheck
npm run test
npm run build
cargo check --manifest-path src-tauri/Cargo.toml

Build Windows package:

npm run package:release

Debug package:

npm run package:debug

QA and Release Workflow

Attribution

  • RocketStats overlay experience is inspired by the original RocketStats project:
    • https://github.com/Lyliya/RocketStats
  • RocketStats upstream project license: MIT.
  • RLPeak runtime implementation is built into RLPeak binaries (no BakkesMod runtime/plugin binaries are executed).
  • Additional attribution notes: ATTRIBUTION.md

License

RLPeak is licensed under GPL-3.0.

See LICENSE for the full text.

Disclaimer

RLPeak is a third-party application for Rocket League and is not affiliated with Psyonix or Epic Games.

Popular repositories Loading

  1. RLPeak RLPeak Public

    Windows desktop utility for Rocket League item customization without runtime injection.

    TypeScript 15 3