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

1. Start a private game (chat must be available).

2. Find a piano and stand near it.

3. In chat, type:

   /song <songname>

   Example:

   /song birthday

   This starts the Happy Birthday intro.

4. If the song exists, the first key lights up. Click it to advance; the next key will highlight automatically.

5. 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):

1. birthday – Happy Birthday (intro)

2. sunshine – recognizable bit of You Are My Sunshine

3. elise – snippet of Beethoven’s Für Elise

4. korobeiniki – the classic Tetris theme

5. 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. https://thunderstore.io/c/repo/p/giosuel/Imperium_Repo/

2. https://thunderstore.io/c/repo/p/SphynxDevs/ItemConjurer/

Have fun! 🎹