适用于 Minecraft 1.20.1, 1.21.1 的 QueQiao 插件

🌍中文 / 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 JSON format via WebSocket
• Implemented Events:
• Player Chat
• Player Command
• Player Death (Not available for Velocity)
• Player Join
• Player Quit
• Player Advancement(Achievement)
• Receives JSON messages via WebSocket and forwards to in-game players
• Implemented APIs:
• Broadcast
• PrivateMessage
• Title & SubTitle
• ActionBar
• Rcon Command

Documentation

• Visit the ApiFox QueQiao for 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_server in config.yml:
• enable: true # Enable WebSocket server
• host: "127.0.0.1" # WebSocket Server address
• port: 8080 # WebSocket Server port
• Start the server and wait for WebSocket Server to initialize
• Use ApiFox or other API testing tools, or connect with Integration projects
• Configure global Request 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 Documentation to send messages or listen to player events.

Integration Projects

• @17TheWord/nonebot-adapter-minecraft: NoneBot2 adapter
• @17TheWord/nonebot-plugin-mcqq: NoneBot2 plugin
• @CikeyQi/mc-plugin: YunZai plugin
• @Twiyan0/koishi-plugin-minecraft-sync-msg: Koishi plugin
• @17TheWord/zerobot-plugin-mcqq: ZeroBot plugin
• @kterna/astrbot_plugin_mcqq: AstrBot plugin
• @KroMiose/nekro-agent: AI agent

Related Projects

• @kterna/queqiao_mcdr: MCDR implementation of QueQiao for message exchange

Compatibility

• @kitUIN/ChatImage: Displays images in Minecraft chat

Community

• Discord

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.