Mods / Instruments

Category: #Technology
Author: Quacksol
Side: Both
Created: Apr 7th at 5:29 PM
Last modified: Jul 29th at 7:28 PM
Downloads: 1844

Adds instruments to Vintage Story. These allow players to play ABC music files alone and together!


  • Currently 13 instruments available, including acoustic guitar, piano and drumkit
  • May play instruments using the player's view angle to change pitch
  • May also read .ABC files to play tunes
  • Play .ABC files alone, or together using a band system
  • While each player needs the mod to play the instruments, not all players need the ABC files to hear them!
  • May also craft a 'Music Block' to play your abc files at the click of a button, compatible with the band system

Future work (lots to do!):

  • Make animations for playing tunes
  • Bagpipes
  • Hurdy Gurdy
  • Keyboard playback


  • Copy the mod into the mods folder, like any other mod
  • In your Vintage Story game directory (usually in C:\Program Files\Vintage Story):
    • Create a folder named 'abc'
    • Put your abc files into here!
    • You may use sub-directories, which makes sorting files easier


  • Craft an instrument of your choice (recipes are available in the handbook)
  • Shift+right click while holding the instrument to choose the 'mode'
    • 'SemiTone Step' enables users to play notes depending on the player angle, in semitone steps
    • 'Tone Step' is the same, but the note steps in tones
    • 'Fluid' is also the same, but does not step
    • 'ABC' enables users to play ABC files
    • Enter a band name to synchronise playback with others (so long as your band name is the same!)
  • When in ABC mode, right click to bring up another interface to choose your ABC file to play
    • If no ABC files are found, an error will be written in the chat window to help fix it.

It says "ABC error: could not find folder at..."!

Unlike other mods, this mod looks in your game's installed directory for abc files that it can play. This way, if the mod needs to be updated, your tunes will remain untouched. You'll need to source your own abc files, there are plenty out on the web!

Where do I find .abc files?

If you follow the link above to the forum post, there are some example abc files in the downloads section.

Other than that, you can search for abc files, or make your own! I would recommend adding "Starbound" to your search, as the abc community for that game is huge. There are plenty of tutorials for converting MIDI files to abc as well, which will work with this mod.

What about abc files on my server?

Similarly to having abc files on your client, you can have abc files available to everyone who joins your server. In your server install directory, place your abcs in a folder "abc_server". You can put your abcs in subfolders just as normal, so you can make a subfolder for any groups you might have.


This mod is still a work in progress. If you're a modder and would like to help in any way, drop me a message!

If you find an ABC file that cannot be played, an error will be displayed in the chat window. Please send the file along with the error, so I can fix it.

Version For Game version Downloads Release date Changelog Download
v1.0.10 519 Jul 29th at 7:28 PM Show
v1.0.9 211 Jul 16th at 10:14 PM Show
v1.0.8 76 Jul 16th at 5:55 PM Show
v1.0.7 85 Jul 14th at 12:03 PM Show
v1.0.6 55 Jul 13th at 10:15 AM Show
v1.0.5 105 Jul 4th at 2:07 PM Show
v1.0.4 216 Jun 5th at 9:33 AM Show
v1.0.3 393 Apr 14th at 10:37 PM Show
v1.0.2 77 Apr 14th at 9:43 PM Show
v1.0.1 107 Apr 13th at 12:09 PM Show

17 Comments (oldest first | newest first)

Vinter_Nacht, Oct 17th at 7:08 PM

Could you add the Shofar, craftable from a horn that drops from big horn sheep?

Lyte, Aug 11th at 2:24 AM

i had a much older version , new version worked great!  Thanks !

Quacksol, Aug 10th at 9:40 AM

I have found the culprit, but the issue has been fixed in version 1.0.8. I've just tested the file, and it works for me. Are you using the latest version?

Lyte, Aug 9th at 3:27 AM

Quacksol , here is the Pastebin : Poker Face .abc file -

Quacksol, Aug 8th at 5:36 PM

I'm not too familliar with MIDI, right now there are no plans to integrate it to the mod. With abcs, each track of a MIDI file needs its own player, which works better with the game, at least in my opinion. But I would like to add keyboard playback at some point.

Lyte, could you send me the file, over pastebin?

Lyte, Aug 5th at 5:54 PM

I used Maestro  MIDI to .abc  file converter and everytime i try to play the Converted File on an instrument, i get a "Error Parsing File, Char Index 205"  message.  Do you know how to fix this ?

explorerbee, Aug 4th at 8:53 PM

Maybe this is a stupid question, but is it possible to add the ability to play MIDI files or the code won't allow it?

JupiterSky, Jul 27th at 12:44 AM

I am wondering about live playing.

I'm not too deep into modding yet, so I am wondering about the feasibility of MIDI inputs or maybe using the keyboard to play the instruments.

Eisenwulf, Jul 26th at 3:55 PM

Proposed instrument: the hurdy gurdy. 😃

Quacksol, Jul 16th at 10:16 PM

Hi guys, instruments_1.0.8 has a client crashing mod, please update to 1.0.9 if you're playing multiplayer.

Hamish, Apr 17th at 12:24 AM
Quacksol, Apr 13th at 12:29 PM

The mod's available here now! I've also made a few fixes.

l33tmaan, Apr 10th at 10:32 PM

Oh yeah, I even talked about this with someone recently. Oops!

SingABrightSong, Apr 10th at 6:33 PM
  • Due to the amount of sound samples in the mod, it is not available on VSModDB, so follow the link in the homepage tab to the forums.

Someone forgot to read

l33tmaan, Apr 10th at 3:33 PM

Someone forgot to upload the mod.

Zloy_EdyardOS, Apr 10th at 9:57 AM

How to download?

Rufkut, Apr 8th at 2:10 AM

Very cool

delete edit