Cid

This mod provides a system for adding and playing music in Minetest, primarily designed for playing single-instrument MIDI files.

This mod does not provide any music. You will need to install a music pack or some other dependent mod.

API

cid.tunes

Table containing tunes, indexed by the tune id. Values are tables in the following format:

{
    title = "Title of piece"
    license = "License and/or other info",
    backend = "midi", -- "midi" | "table"
    _data = dofile("mytable.lua"), -- Used only by the table backend
    _midi = "Binary string", -- Data read from a MIDI file
}

cid.instruments

Table indexed by instrument name, and an instrument definition as the value.

{
    name = "cid_piano", -- Name of the sound file
    gain = 1 / 2, -- Adjusts volume
    pitch = 60, -- MIDI pitch value, describes the sound sample's pitch
}

Some instruments are provided by default. cid.instruments.piano is the default instrument.

cid.backends

Contains a bunch of the backend stuff, can be used directly to set up music players.

Currently undocumented, see init.lua and backends/midi.lua.