FluxCraft

[!(https://img.shields.io/badge/Ko--fi-support-blue.svg)](https://ko-fi.com/jforge)

# FluxCraft

FluxCraft is a server-side Paper plugin that connects your Minecraft server to MQTT.

It streams live in-game events to an MQTT broker and can also accept commands back through MQTT topics, making it easy to integrate Minecraft with dashboards, automations, bots, analytics pipelines, IoT systems, or larger event-driven platforms.

Unlike a typical gameplay plugin, FluxCraft is built for connectivity. It turns your server into a real-time event source that external systems can observe and react to — without requiring any client-side mods.

## What does it do?

FluxCraft publishes Minecraft server activity to structured MQTT topics in real time.

It can capture player actions, enemy activity, world changes, device interactions, and special block events, then publish them to organized topics that are easy to consume from external systems.

It also supports inbound MQTT integration for commands and chat-related topics.

## Why would you want it?

FluxCraft is useful if you want your server to be part of something bigger than Minecraft itself.

With FluxCraft, you can:

• monitor server activity in real time
• build external dashboards for player and world events
• trigger automations from gameplay
• connect Minecraft to MQTT-based tools like Node-RED or MQTT Explorer
• feed events into custom services, bots, or data pipelines
• integrate a Paper server into a broader IoT or Unified Namespace environment

In short, FluxCraft gives server owners and developers a clean bridge between Minecraft and the outside world.

## Features

### Real-time MQTT event streaming Publish events as they happen, so external tools can react immediately instead of scraping logs or polling APIs.

### Structured topic layout FluxCraft uses organized MQTT topics for players, worlds, enemies, devices, chat, commands, and more, making integrations cleaner and easier to scale.

### Broad event coverage FluxCraft supports events including:

• Player events: crafting, building, mining, death, respawn, eating, damage, join, quit
• Enemy events: spawn, damage, death
• World events: time and weather
• Device events: furnaces, levers, buttons, pressure plates, doors, trapdoors, pistons, and crafting-related interactions
• Special blocks: TNT explosions
• Experimental channels: chat and commands

### Fine-grained configuration Enable or disable event categories and individual event types so you only publish the data that matters to your setup.

### Modern broker support Supports MQTT 5 by default, MQTT 3. 1. 1 compatibility, and secure broker connections via TLS.

### Multi-server ready Designed to work cleanly across multiple servers connected to the same broker.

## Good fit for

FluxCraft is a great fit for:

• server owners who want live observability
• developers building Minecraft integrations
• automation enthusiasts using MQTT
• IoT and home-lab setups
• anyone experimenting with Minecraft as part of a larger event-driven system

## Technical notes

• Server-side only
• Built for Paper
• No client mod required
• Open source

## One-line summary

Turn your Paper server into a real-time MQTT event source for dashboards, automations, bots, and external systems.