QueQiao: Bridge Your Minecraft Server to External Apps

QueQiao: WebSocket Bridge for Minecraft Servers

Integrating external applications with a live Minecraft environment often presents significant technical hurdles for server administrators. Whether the goal is syncing chat logs to Discord, creating real-time monitoring dashboards, or linking AI agents to gameplay, a reliable data conduit is essential. The QueQiao: WebSocket Bridge for Minecraft Servers solution addresses this need by establishing a robust, bidirectional communication channel. It transforms internal game occurrences into structured JSON data streams via WebSocket, allowing seamless interaction between the server core and third-party software without complex middleware.

Core Functionality and Platform Support

This tool operates directly on the server side, performing two critical roles simultaneously. First, it intercepts specific in-game events and instantly broadcasts them as formatted JSON objects to any connected WebSocket client. Second, it listens for incoming JSON payloads and executes corresponding actions within the game, such as sending chat messages or running console commands. This dual capability creates a versatile loop for automation scenarios.

Compatibility is a primary focus for this utility, ensuring it fits into various existing infrastructures. Administrators can download QueQiao: WebSocket Bridge for Minecraft Servers builds tailored for major platforms including Fabric, Forge, Spigot, Paper, and Velocity. This broad support means that regardless of whether your network runs on a lightweight proxy or a heavy modded kernel, integration remains straightforward. The project utilizes ModMultiVersion tools to maintain a single codebase that compiles correctly across different game iterations, reducing fragmentation and ensuring stability for diverse setups.

Tracked Events and Data Structure

The system currently monitors six distinct event types, each packaged with detailed metadata to facilitate easy parsing by external bots or web panels. Users do not need to scrape raw log files, as the data arrives pre-cleaned and standardized. The supported events include:

• Chat Messages: Captures content, author name, timestamps, and the source server.
• Command Execution: Logs the full command string and the identity of the executor.
• Player Deaths: Records the cause of death and coordinates (note: unavailable on Velocity proxies).
• Player Joins: Provides usernames, UUIDs, and exact login times.
• Player Leaves: similar data points recorded upon disconnection.
• Achievements: Details the title and description of unlocked advancements.

Outbound Communication and API Actions

Beyond merely observing the server, this bridge allows external systems to influence the game world. By sending specific JSON requests, administrators can trigger five primary actions. These include broadcasting messages to all users, sending private whispers to specific individuals, displaying large Titles and SubTitles on the screen, pushing text to the Action Bar above the inventory, and executing arbitrary RCON commands via the console. This feature set supports complex workflows, ranging from simple donation alerts to automated item distribution triggered by external databases.

Installation and Configuration Guide

Setting up this bridge is designed for efficiency, typically requiring only a few minutes. Once you have located the correct file to download QueQiao: WebSocket Bridge for Minecraft Servers for your specific loader, place it in the mods or plugins folder. The configuration process revolves around a single file, usually named config.yml. Key parameters include enabling the service, setting the host address (defaulting to localhost for local integrations), and defining the listening port, commonly 8080.

Security is managed through HTTP headers during the connection handshake. Clients must present an x-self-name header identifying the source, and optionally an Authorization header if a token is configured. This prevents unauthorized scripts from injecting commands into the server console. For those wondering how to install custom adapters, the community has already developed connectors for popular frameworks like NoneBot2, ZeroBot, and Koishi, further simplifying the deployment of advanced bot ecosystems.

Licensing and Ecosystem

Distributed under the MIT license, this project offers complete freedom for modification and commercial use. The open-source nature encourages community contributions, resulting in a growing library of extensions such as ChatImage, which renders image previews directly in the game chat. Comprehensive documentation available via ApiFox details every endpoint and data model, providing developers with the examples needed to build custom integrations rapidly. By adopting this bridge, server operators gain a professional-grade interface for connecting their Minecraft world to the broader internet.