CurseForge · Minecraft mod
QueQiao
Minecraft Server Mod/Plugin for Real-time Player Events & API Broadcast Messaging.
Quick answer
Which QueQiao release should I use?
QueQiao-cleanroom+1.12.2-0.5.0 targets 1.12.2 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is QueQiao required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does QueQiao-cleanroom+1.12.2-0.5.0 need?
QueQiao-cleanroom+1.12.2-0.5.0. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add QueQiao without breaking your instance.
Built for QueQiao-cleanroom+1.12.2-0.5.0. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use QueQiao-cleanroom+1.12.2-0.5.0. It targets 1.12.2 with Forge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside QueQiao-cleanroom+1.12.2-0.5.0. It opens that exact file at the source.
About this project
What does QueQiao add?
🌍中文 / English

QueQiao ✨ Minecraft Server Mod/Plugin for Real-time Player Events & API Broadcast Messaging ✨
📖 Documentation · ⬇️ Modrinth · ⬇️ CurseForge · 🐛 Report Issues
Introduction
- Distributes player events from the server in
JSONformat viaWebSocket- Implemented
Events:Player ChatPlayer CommandPlayer Death(Not available for Velocity)Player JoinPlayer QuitPlayer Advancement(Achievement)
- Implemented
- Receives
JSONmessages viaWebSocketand forwards to in-game players- Implemented APIs:
Documentation
- Visit the
ApiFox QueQiaofor detailed documentation
Can't find a suitable Mod/Plugin version? Feel free to submit an
Issue
Quick Start
- Install the corresponding server
plugin/mod - Configure
websocket_serverinconfig.yml:enable: true# Enable WebSocket serverhost: "127.0.0.1"# WebSocket Server addressport: 8080# WebSocket Server port
- Start the server and wait for
WebSocket Serverto initialize - Use
ApiFoxor other API testing tools, or connect with Integration projects and with theseRequest Header
{
// Required: server name, must match 'server_name' in config.yml
"x-self-name": "TestServer",
// Optional: auth token, must match 'access_token' in config.yml (omit if empty)
"Authorization": "Bearer 123"
}
- Launch the game and join the server
- Refer to the
API Documentationto send messages or listen to player events.
Integration Projects
@17TheWord/nonebot-adapter-minecraft:NoneBot2adapter@17TheWord/nonebot-plugin-mcqq:NoneBot2plugin@CikeyQi/mc-plugin:YunZaiplugin@Twiyan0/koishi-plugin-minecraft-sync-msg:Koishiplugin@17TheWord/zerobot-plugin-mcqq:ZeroBotplugin@kterna/astrbot_plugin_mcqq:AstrBotplugin@KroMiose/nekro-agent:AIagent
Related Projects
@kterna/queqiao_mcdr:MCDRimplementation ofQueQiaofor message exchange
Compatibility
@kitUIN/ChatImage: Displays images in Minecraft chat
Community
Special Thanks
@kitUIN: For code assistance and build tools@kitUIN/ModMultiVersion: IDEA multi-version MOD plugin@kitUIN/ModMultiVersionTool: Multi-version MOD build tool
Support & Contribution
- Star this project if you find it useful or support me on
Afdian - Submit suggestions/bugs via
Issues - Contribute via
Pull requests
License
This project is licensed under the MIT license.
Project description from CurseForge.
Pick your setup
QueQiao by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.1.2
2 loader builds26.1.1
2 loader builds26.1
4 loader builds1.21.11
2 loader builds1.21.10
2 loader builds1.21.9
2 loader builds1.21.8
2 loader builds1.21.7
2 loader builds1.21.6
2 loader builds1.21.5
2 loader builds1.21.4
2 loader buildsShowing the newest 12 of 52 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
QueQiao versions and loaders
QueQiao-fabric+26.1-0.5.2
QueQiao-fabric+26.1-0.5.2.jar
1 Aug 2026
QueQiao-fabric+26.1-0.5.2
QueQiao-fabric+26.1-0.5.2.jar
18 Jul 2026
QueQiao-paper+26.1.1-0.5.1
QueQiao-paper+26.1.1-0.5.1.jar
16 May 2026
QueQiao-forge+26.1-0.5.1
QueQiao-forge+26.1-0.5.1.jar
16 May 2026
QueQiao-fabric+26.1-0.5.1
QueQiao-fabric+26.1-0.5.1.jar
16 May 2026
QueQiao-neoforge+26.1-0.5.1
QueQiao-neoforge+26.1-0.5.1.jar
16 May 2026
QueQiao-spigot+26.1-0.5.1
QueQiao-spigot+26.1-0.5.1.jar
16 May 2026
QueQiao-cleanroom+1.12.2-0.5.0
QueQiao-forge+1.12.2-0.5.0.jar
6 Apr 2026
QueQiao-forge+1.18.2-0.5.0
QueQiao-forge+1.18.2-0.5.0.jar
6 Apr 2026
QueQiao-gtnh+1.7.10-0.5.0
QueQiao-forge+1.7.10-0.5.0.jar
6 Apr 2026
QueQiao-forge+1.21-0.5.0
QueQiao-forge+1.21-0.5.0.jar
6 Apr 2026
0.5.0+fabric-1.21.9
QueQiao-fabric+1.21.9-0.5.0.jar
6 Apr 2026
Looking for an older file? The official CurseForge project page is in Resources.