Skip to content

Instrument map

Jump to bottom
SBPrime edited this page Dec 24, 2014 · 4 revisions

#Instrument map This file contains the mapping for MIDI instruments. This file is used to map each MIDI instrument number (program) to minecraft sound. You are able to add comments, default instruments (if the program is not mapped) or map different sounds for different instrument octaves.

Back to main

Sample

#ProgramID | Sound patch | Base volume | Octaves
D	note.harp			100%	0-1	2-3	4-5	6-7	8-9	10	#Default mapping
0	note.harp			100%	0-1	2-3	4-5	6-7	8-9	10	#Acoustic Grand Piano
1	note.pling			 20%	0-1	2-3	4-5	6-7	8-9	10	#Bright Acoustic Piano
2	note.pling			 20%	0-1	2-3	4-5	6-7	8-9	10	#Electric Grand Piano
3	note.pling			 20%	0-1	2-3	4-5	6-7	8-9	10	#Honky-tonk Piano

Comment

Each line that starts with "#" is ignored. If you put "#" inside a line all characters to the end of line are ignored.

Sample:

#Whole line comment
0	note.harp			100%	0-1	2-3	4-5	6-7	8-9	10	#End of line comment

Instrument definition

Each instrument definition line is divided into 4 sections:

  • Instrument ID
  • Minecraft sound patch
  • Volume modification
  • Octaves

Sample:

1	note.pling			 20%	0-1	2-3	4-5	6-7	8-9	10	#Bright Acoustic Piano

Instrument ID

This is the MIDI instrument number. The number needs to by in range from 0 to 127.

Minecraft sound patch

This is the path to minecraft sound that will by used as the instrument. You can use any sound that is available in minecraft or in any resource pack.

Volume modification

This section allows you to modify the basic volume of the sound. The value needs to by in range from 1% to 100%.

Octaves

Since minecraft allows implements 2 octaves of notes you might want to provide different instruments for different MIDI octaves (MIDI allows octaves from 0 to 10, last one is not full). Each entry should contain a starting octave and an ending octave. The plugin picks the first instrument that has an octave definition that the note octave fits into.

Default instrument

Since MIDI supports 128 different instruments and minecraft has only 5 instruments you can chose to map only the instruments that interest you and ignore the rest. If a instrument ID is not found MidiPlayer uses the default instrument entry. To define a default instrument entry you need to enter "D" as the instrument ID.

Sample:

D	note.harp			100%	0-1	2-3	4-5	6-7	8-9	10	#Default mapping

#Drum map The drum map contains the mapping for the drum station instruments. It is used to map each instrument to minecraft sound. You are able to add comments, default instruments (if the instrument is not mapped).

##Sample

#Note | Sound patch | Base volume
#D	note.bd		100%    #Default mapping
35	note.snare	100%    #Acoustic Bass Drum
36	note.snare	100%    #Bass Drum 1
37	note.snare	100%    #Side Stick

##Instrument definition Each drum definition line is divided into 3 sections:

  • Drum ID
  • Minecraft sound patch
  • Volume modification

Sample:

35	note.snare	100%    #Acoustic Bass Drum

###Instrument ID

This is the drum instrument number. The number needs to by in range from 0 to 127.

###Minecraft sound patch

This is the path to minecraft sound that will by used as the drum instrument. You can use any sound that is available in minecraft or in any resource pack.

###Volume modification

This section allows you to modify the basic volume of the sound. The value needs to by in range from 1% to 100%.

Back to main

Clone this wiki locally