Mods / Instruments

Category: #Technology
Author: Quacksol
Side: Both
Created: Apr 7th 2021 at 5:29 PM
Last modified: Nov 16th at 11:43 PM
Downloads: 12300
Follow Unfollow 68

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.1.4 412 Nov 16th at 11:43 PM Show
v1.1.3 2345 Sep 5th at 10:05 AM Show
v1.1.2 3931 Feb 7th at 10:01 PM Show
v1.1.1 808 Jan 17th at 9:31 PM Show
v1.1.0 1076 Jan 9th at 1:22 AM Show
v1.0.10 972 Jul 29th 2021 at 7:28 PM Show
v1.0.9 370 Jul 16th 2021 at 10:14 PM Show
v1.0.8 224 Jul 16th 2021 at 5:55 PM Show
v1.0.7 246 Jul 14th 2021 at 12:03 PM Show
v1.0.6 226 Jul 13th 2021 at 10:15 AM Show
v1.0.5 273 Jul 4th 2021 at 2:07 PM Show
v1.0.4 382 Jun 5th 2021 at 9:33 AM Show
v1.0.3 547 Apr 14th 2021 at 10:37 PM Show
v1.0.2 224 Apr 14th 2021 at 9:43 PM Show
v1.0.1 264 Apr 13th 2021 at 12:09 PM Show

35 Comments (oldest first | newest first)

💬 Quacksol, Nov 23rd at 4:44 PM

Hi all,

If you have any bugs/crashes, please report them to the discord mod post:

Thank you for trying my mod!

💬 Draugemalf, Nov 20th at 11:58 PM

There's a gamebreaking server bug. If a player tries to connect while another player is playing instruments the client will crash for the palyer trying to connect.

💬 Quacksol, Nov 18th at 5:43 PM

Hi OmegaHaxors, if you create/find a MIDI of the song you like, you can convert each channel of that file to a separate abc file. Also, there should already be a tab for the instruments.

💬 Quacksol, Nov 18th at 5:42 PM
💬 OmegaHaxors, Nov 17th at 11:29 AM

I'm getting really into the band system. How would I construct the ABC files so that each instrument in the band gets its own channel?
Also please make a creative tab for the various instruments. They're so hard to find in the menu.

💬 OmegaHaxors, Nov 17th at 8:19 AM

I played "row row row your boats" on the steel drum and it sounded drunk af. 10/10 a masterpiece

💬 Hexedian, Nov 5th at 7:14 PM

You know what this mod needs? It needs a playable jug.

The game already has jugs. You just need to blow on it!

💬 Quacksol, Nov 5th at 11:57 AM

Hey Pabbley, could you send me the details, such as which versions of the mod/game you are using and the crash report?

💬 Pabbley, Oct 31st at 1:43 AM

Hey there! The harp crashs to desktop when I attempted to play it!

💬 RogueRaiden, Sep 5th at 4:13 PM

Yes, ground storage would be amazing!

💬 Craluminum, Sep 5th at 11:04 AM

It would be great if you make instruments ground storable. Whether against wall or just as pumpkins. Here is the Ground Storage page from vanilla wiki that lists all of them.

💬 Quacksol, Sep 5th at 10:05 AM

HI everyone, the mod is updated for 1.17.2, and no longer crashes on opening UI.

💬 JaeSaber, Sep 5th at 4:46 AM

Needs and update, crashes when instrument UI opens


💬 OBEDIA, Aug 20th at 5:47 AM

Does this work with 16.5?

💬 Artor, Jun 1st at 8:30 AM

Hyped for animations and bagpipes.

💬 Quacksol, Feb 11th at 7:52 PM

Hi RogueRaiden, I'm sorry to say that the instruments are not placeable for the moment. They can however be placed on tool racks.

💬 RogueRaiden, Jan 30th at 4:40 PM

How do you place down the instruments?

💬 Cendar, Jan 19th at 4:34 AM

Hi! I made a french translation for your mod, feel free to add it if you want. 😊

fr.json - Instruments 1.1.1

💬 Vinter_Nacht, Oct 17th 2021 at 7:08 PM

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

💬 Lyte, Aug 11th 2021 at 2:24 AM

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

💬 Quacksol, Aug 10th 2021 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 2021 at 3:27 AM

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

💬 Quacksol, Aug 8th 2021 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 2021 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 2021 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 2021 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 2021 at 3:55 PM

Proposed instrument: the hurdy gurdy. 😃

💬 Quacksol, Jul 16th 2021 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 2021 at 12:24 AM
💬 Quacksol, Apr 13th 2021 at 12:29 PM

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

💬 l33tmaan, Apr 10th 2021 at 10:32 PM

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

💬 SingABrightSong, Apr 10th 2021 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 2021 at 3:33 PM

Someone forgot to upload the mod.

💬 Zloy_EdyardOS, Apr 10th 2021 at 9:57 AM

How to download?

💬 Rufkut, Apr 8th 2021 at 2:10 AM

Very cool

(edit comment delete)