# \ud83c\udfb9 MIDI Plugin Message Mod<\/p>\n
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.<\/p>\n
## \ud83d\udce6 Plugin Message: `midi:action`<\/p>\n
The plugin message is based on a custom payload called `MidiAction`, sent via the `CustomPayload` system.<\/p>\n
### `MidiAction` Payload Structure<\/p>\n
“`java
\nrecord MidiAction(
\n String name,
\n int command,
\n int channel,
\n int data1,
\n int data2
\n)
\n““<\/p>\n
| Field | Type | Description |
\n| ——— | ——– | ——————————————- |
\n| `name` | `String` | Name of the MIDI device (e.g., “Launchpad”) |
\n| `command` | `int` | MIDI command (e.g., `144` = Note On) |
\n| `channel` | `int` | MIDI channel (0\u201315) |
\n| `data1` | `int` | First data value (e.g., note number) |
\n| `data2` | `int` | Second data value (e.g., velocity) |<\/p>\n
## \ud83d\udee0 Example Usage<\/p>\n
### Sending from the Client<\/p>\n
“`java
\nClientPlayNetworking.send(
\n new MidiAction(“Launchpad”, 144, 0, 60, 127)
\n);
\n“`<\/p>\n
### Receiving on the Server<\/p>\n
Register a global receiver in your server mod:<\/p>\n
“`java
\nServerPlayNetworking.registerGlobalReceiver(
\n MidiAction.ID,
\n (payload, context) -> {
\n System.out.println(“Received MIDI action from device: ” + payload.name());
\n }
\n);
\n“`<\/p>\n
## \u2699\ufe0f Technical Details<\/p>\n
* **Packet ID**: `midi:action`
\n* **Codec**: Custom implementation using `FriendlyByteBuf`
\n* **Minecraft Version**: 1.20.5+ (uses `CustomPacketPayload` API)<\/p>\n
## \u2705 Requirements<\/p>\n
* Minecraft 1.20.5 or higher
\n* Fabric (or another compatible mod loader)
\n* A server mod that handles incoming `MidiAction` payloads<\/p>\n
—<\/p>\n
Got questions or suggestions? Feel free to open an issue or reach out
\ndirectly!<\/p>\n","protected":false},"excerpt":{"rendered":"
A lightweight Minecraft mod for sending MIDI-like actions from the client to the server via custom plugin messages.<\/p>\n","protected":false},"featured_media":101022,"template":"","meta":{"_minecraft_slug":"midi","_minecraft_project_id":"WGxKLoGM","_minecraft_author":"Freddi","_minecraft_license":"LicenseRef-NC-MIT","_minecraft_downloads":871,"_minecraft_follows":2,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"midi.zip","_minecraft_size_bytes":6848,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:04:49.534647Z","_minecraft_date_created":"2025-07-19T04:17:56.491998Z","_minecraft_date_modified":"2025-08-01T07:34:46.435210Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/midi","_minecraft_icon_attachment_id":101022,"_minecraft_imported_at":"2026-06-05T19:21:31+00:00","_minecraft_import_hash":"08ac7e936f06da0068cf92c576cd1d4e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,89,873,122,123],"mod_loader":[99],"minecraft_version":[101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-101021","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-game-mechanics","mod_category-library","mod_category-magic","mod_category-technology","mod_loader-fabric","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n