QueQiao
Minecraft Server Mod/Plugin for Real-time Player Events & API Broadcast Messaging.
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
QueQiao
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 player events: - %%MD1%% - %%MD2%% - %%MD3%% (Not available for Velocity) - %%MD4%% - %%MD5%% - %%MD6%% - Receives `JSON` messages via `WebSocket` and forwards to in-game players - Implemented APIs: - %%MD7%% - %%MD8%% - %%MD9%% - %%MD10%% - %%MD11%%
Documentation
- Visit the `ApiFox QueQiao` for detailed documentation
> Can't find a suitable Mod/Plugin version? Feel free to submit an `Issue`
Quick Start
1. Install the corresponding server `plugin/mod` 2. Configure `websocket_server` in `config.yml`: - `enable: true` # Enable WebSocket server - `host: "127.0.0.1"` # WebSocket Server address - `port: 8080` # WebSocket Server port 3. Start the server and wait for `WebSocket Server` to initialize 4. Use `ApiFox` or other API testing tools, or connect with Integration projects - Configure global `Request Header`: ```json5 { // 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" } ``` 5. Launch the game and join the server 6. 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
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.