MediaMod

The Minecraft mod

MediaMod is a Fabric mod that adds speaker, microphone and screen blocks to Minecraft, plus a local account system and direct message and call commands. It connects to this website over a small TCP bridge so the two halves stay in sync.

Minecraft 26.1.2 Fabric Java 25

Requirements

Component	Version
Minecraft	`26.1.2`
Fabric Loader	`0.19.3` or newer
Fabric API	`0.154.2+26.1.2`
Java	`25`
Koula Chat server	Running, bridge on port `9010`

Version matching matters more than usual here. Minecraft 26.1.2 changed several registration APIs, so a mod built for an earlier version will crash on launch rather than fail gracefully.

Install

1. Install Fabric Loader

Run the Fabric installer, pick Minecraft 26.1.2, and let it create the profile.

2. Drop in Fabric API

Put fabric-api-0.154.2+26.1.2.jar into your mods folder. MediaMod will not load without it.

3. Add MediaMod

Put media-1.1.0-26.1.2-fabric.jar into the same mods folder.

4. Start the website server

Run python app.py from the server folder. Watch for [bridge] listening on 127.0.0.1:9010.

5. Link your account

Launch Minecraft, then link from your Koula Chat dashboard's Minecraft tab. That unlocks the Bridged achievement.

What the mod adds

🔊

Speaker block

Plays audio from the bridge in-world with distance falloff, so a call can be heard by anyone standing nearby.

🎤

Microphone block

Captures voice from nearby players and pushes it up to the server, using javax.sound.sampled for device enumeration.

🖥

Screen block

A display surface intended to host an embedded browser via MCEF, with multiblock merging planned so several screens form one larger display.

👤

Local accounts

In-game sign-up and login with hashed passwords, so a Minecraft identity maps to a site identity.

💬

DM & call commands

Message or call another player without leaving the game. Calls ring on the website too.

🖼

Media HUD

An overlay showing bridge status, who is online and any incoming call, with buttons added to the title and pause screens.

Building from source

The mod is a standard Fabric Loom project.

# Windows
gradlew.bat build

# macOS / Linux
./gradlew build

# output
build/libs/media-1.1.0-26.1.2-fabric.jar
      

If the build fails, open build/reports/problems/problems-report.html — it is far more readable than the console output.

Server config

The bridge address lives in config/config.json:

{
  "app_name": "Koula Chat",
  "web_host": "0.0.0.0",
  "web_port": 4400,
  "bridge_host": "127.0.0.1",
  "bridge_port": 9010,
  "voice_host": "127.0.0.1",
  "voice_port": 9011
}
      

If Minecraft runs on a different machine from the website, change bridge_host to an address that machine can actually reach and make sure the port is open.

Common install problems

Minecraft crashes on startup with a registration error

Almost always a version mismatch. Minecraft 26.1.2 requires .setId(ResourceKey) on Item.Properties and BlockBehaviour.Properties before the object is constructed. A jar built against an older Minecraft will throw during registration.

Check the mod jar name matches your Minecraft version, and that Fabric API is the +26.1.2 build.

Items and blocks show a purple and black checkerboard

Missing texture definitions. Each item needs a client item definition JSON under assets/modid/items/. If you built from source and skipped the resources folder, this is what you get.

Buttons appear twice on the title screen

Duplicate mixins. If more than one screen mixin injects the same buttons they both fire. The mod should use a single generic ScreenMediaButtonsMixin with instanceof checks rather than one mixin per screen type.

The mod loads but the bridge never connects

Start the website server first and confirm it prints [bridge] listening on 127.0.0.1:9010. Then check the status pill on your dashboard. More detail is on the Minecraft client support page.

Minecraft troubleshooting Bridge protocol docs