← Projects
PhilipsHue Minecraft Sync

Hue MC Controller

Control Philips Hue lights directly from your Paper/Spigot Minecraft server.

Java 21 Paper 1.21.1 Philips Hue API Work in Progress
View on GitHub Download .jar
🌉

Bridge Pairing

Auto-guided pairing with your Hue bridge's link button directly from chat.

💡

Global Control

Toggle all your lights on or off with a single command from any in-game location.

🔧

Lever Bindings

Right-click any lever in-game to bind it to a specific light or a captured scene snapshot.

🎬

Scene Capture

Snapshot the current state of all your lights and replay them with a lever flip.

Commands

/bridge set <ip>

Set the Hue bridge IP and start the pairing flow. Press the physical link button when prompted.

/lights on|off

Toggle all lights (group 0) globally on or off.

/list lights

List all light names registered on the connected bridge.

/set light <name>

Select a light by name or substring, then right-click a lever within 60 s to bind it.

/set scene

Snapshot all light states, then right-click a lever within 60 s. Lever ON restores snapshot, lever OFF powers all lights off.

Requirements

  • ☕ Java 21
  • 📦 Paper / Spigot 1.21.1
  • 🌐 Philips Hue bridge on the same network

Installation

  1. 1
    Download the shaded .jar from releases or build with mvn clean package.
  2. 2
    Place the jar in your server's plugins/ folder.
  3. 3
    Start the server — config.yml is generated automatically.
  4. 4
    Run /bridge set <ip> and press the link button on your bridge.

Build from Source

bash terminal 
mvn clean package

Outputs target/hue-mc-controller-1.0-SNAPSHOT-shaded.jar

How it Works

⚡
Hue API calls run asynchronously — the server main thread is only touched to deliver chat messages, so performance impact is minimal.
💾
Lever bindings persist in config.yml under the bindings key and survive server restarts.
🔑
If you change the bridge IP the stored API key is cleared automatically and you must pair again.

Ready to light up your server?

GitHub Download .jar