Piano
Impress your friends by playing actual songs on the R.E.P.O piano. This is a tool that highlights the actual hitboxes of piano keys on a selected piano and hints (and registers) what keys must be hit
About this mod Author’s original text
R.E.P.O. Piano Hints
_Impress your friends by playing actual songs on the R.E.P.O. piano._
What it does
- Highlights the true hitboxes of keys on a selected R.E.P.O. piano.
- Guides you through songs by hinting the next key to press and registering hits as you play.
- Fully customizable: choose a built-in song or add your own simple “key index” scripts.
Note: The mod also highlights keys for guitars and harps, but those instruments aren’t optimized yet.
Why
I wanted to play at least _something_ on the R.E.P.O. piano—so I built a tool to make that easy.
How to use
- Start a private game (chat must be available).
- Find a piano and stand near it.
- In chat, type:
/song
Example:
/song birthday
This starts the _Happy Birthday_ intro.
- If the song exists, the first key lights up. Click it to advance; the next key will highlight automatically.
- Restart a song at any time by pressing O on your keyboard.
Included songs
Short, illustrative snippets to show the concept (they may be brief or a bit “off”—they’re examples so you can build your own):
- birthday – _Happy Birthday_ (intro)
- sunshine – recognizable bit of _You Are My Sunshine_
- elise – snippet of Beethoven’s _Für Elise_
- korobeiniki – the classic _Tetris_ theme
- smoke – the iconic riff from _Smoke on the Water_ (Deep Purple)
Add your own songs
You’ll edit the game config:
- File: com.igor.repo.pianohints.cfg
- Section: Song scripts/scripts (it already contains examples)
Format
uniqueSongName: keyNumber, keyNumber, keyNumber;
- Use commas between key numbers.
- End each song line with a semicolon.
Example
sunshine: 60,60,62,64,64,64,62,64,60,60,60,62,64,65,69,69,67,65,64,60,62,64,65,69,69,67,65,64,60,60,62,64,64,62,62,64,60;
After saving, launch the game and run:
/song sunshine
About those key numbers
- The R.E.P.O. piano has 108 keys (not the usual 88).
- For simplicity, keys are indexed 1–108 from low to high.
- If you want to see each key’s index in-game, set LabelMode in the config to Index.
- You can transpose by ear: map parts of a real piano song to these indexes and adjust until it sounds right.
Notes & known issues
You might find a lot of different configs inside of the config file and you might to play around with them, but I do not recommend to interact with anything that I wasn't mentioning previously. I just got a lot of trash left from the previous iterations of the mod and was too lazy to clean that out. Sorry.
One more thing. you will find that the mod has also affected guitars and harps, so it highlights their keys too. But it wasn't oprimised to work with them so expect them not to work as designed.
Can’t find a piano?
Considering, how hard it is to find a piano in the game, you might want yourself some means to spawning pianos:)
I recommend the following mods:
1.
2.
Have fun! 🎹
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.
Install these first, or the mod will not work: