GitHub Discord Download
/ how it works

How RLPeak works

A clear explanation of the Windows V1 item workflow and the rules future modules should follow.

RLPeak is designed as a Rocket League companion platform. V1.1.0 ships the Items module plus a plugin system with RocketStats Overlay and Workshop Map Loader: it shows a catalog, downloads selected item files when needed, backs up originals, and copies the selected files into Rocket League’s item file location.

Overview

RLPeak is not a runtime mod menu. It does not inject into Rocket League, hook the game process, edit memory, or run scripts inside the game. V1 uses a desktop file workflow for items, while future releases may add workshop maps, session tools, overlays and SDK extensions inside the same app.

Remote catalogs

The V1 item list comes from the RLPeak API:

https://api.rlpeak.com/v1/manifest.json

The manifest points the app to the decal, wheel and boost catalogs. This keeps the installer lightweight because item files are not bundled with the app. Future modules should keep the same standard: explicit data sources, visible state and no mystery downloads.

Downloads happen on Apply

RLPeak does not silently download every item at startup. Downloads are user-triggered: select an item, click Apply, then RLPeak downloads only the files needed for that item.

Downloaded files are treated as assets. RLPeak does not execute them.

Local cache

After download, files are stored in a local cache so the same item can be reused later without downloading again.

AppData/cache/ItemsFiles/

If the item is already cached, Apply can continue immediately.

Backups

Before replacing a Rocket League file, RLPeak stores the original file once. Backups are kept locally:

AppData/Backups/originals/

This is what makes Reset possible.

Reset

Reset restores original files from local backups. It does not need the remote API and can work offline as long as backups exist.

Refreshing items in Rocket League

If Rocket League already loaded an item visually, it may keep that look in memory. That is why RLPeak shows a first-time guide explaining how to make decals and wheels appear without restarting.

Quick rule: for decals and wheels, switch away from the RLPeak item, leave Garage, apply in RLPeak, then equip the RLPeak item again. For boosts, restart Rocket League.

Current limits

  • Windows is the supported platform.
  • V1.1.0 ships Items, RocketStats Overlay and Workshop Map Loader; further plugins are planned for future releases.
  • Boost visual changes require restarting Rocket League.
  • RLPeak is third-party software and is not affiliated with Psyonix or Epic Games.