midi

midi

A lightweight Minecraft mod for sending MIDI-like actions from the client to the server via custom plugin messages.

by
985 Downloads
fabricmagic
Rent Server with this Mod

Screenshots

banner

About this Mod

🎹 MIDI Plugin Message Mod

This Minecraft mod adds support for sending MIDI actions from the client to the server using custom plugin messages. It can be used to control in-game instruments, sound systems, lighting effects, or other MIDI-reactive features.

📦 Plugin Message: midi:action

The plugin message is based on a custom payload called MidiAction, sent via the CustomPayload system.

MidiAction Payload Structure

record MidiAction(
    String name,
    int command,
    int channel,
    int data1,
    int data2
)
Field Type Description
name String Name of the MIDI device (e.g., "Launchpad")
command int MIDI command (e.g., 144 = Note On)
channel int MIDI channel (0–15)
data1 int First data value (e.g., note number)
data2 int Second data value (e.g., velocity)

🛠 Example Usage

Sending from the Client

ClientPlayNetworking.send(
    new MidiAction("Launchpad", 144, 0, 60, 127)
);

Receiving on the Server

Register a global receiver in your server mod:

ServerPlayNetworking.registerGlobalReceiver(
    MidiAction.ID,
    (payload, context) -> {
        System.out.println("Received MIDI action from device: " + payload.name());
    }
);

⚙️ Technical Details

  • Packet ID: midi:action
  • Codec: Custom implementation using FriendlyByteBuf
  • Minecraft Version: 1.20.5+ (uses CustomPacketPayload API)

✅ Requirements

  • Minecraft 1.20.5 or higher
  • Fabric (or another compatible mod loader)
  • A server mod that handles incoming MidiAction payloads

Got questions or suggestions? Feel free to open an issue or reach out
directly!

Available Versions

midi-1.21+1.0.0release
MC 1.21fabric
August 1, 2025
midi-1.21.6+1.0.0release
MC 1.21.6fabric
August 1, 2025
midi-1.21.3+1.0.0release
MC 1.21.3fabric
August 1, 2025
midi-1.21.4+1.0.0release
MC 1.21.4fabric
August 1, 2025
midi-1.20.5+1.0.0release
MC 1.20.5fabric
August 1, 2025

How to Install midi on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.8).

3

Install Mod

Open the mod browser in the dashboard and search for "midi". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabric

Minecraft Versions

1.21.8, 1.21.7, 1.21.6 (+8 more)

Server-side

Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

midi server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.8). You can switch loaders with one click in the panel.

Is midi compatible with fabric?

midi officially supports fabric for Minecraft 1.21.8, 1.21.7, 1.21.6. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with midi – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if midi consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install midi with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
LicenseRef-NC-MIT
Server-side
Unsupported

Supported Versions

1.21.81.21.71.21.61.21.51.21.41.21.31.21.21.21.11.211.20.6+1 more