MCDanmaku

MCDanmaku is a Fabric client-side mod for Minecraft 26.2-snapshot-7+. It displays real-time danmaku messages from a specified Bilibili live room in the in-game chat.

Requirements

• Fabric Loader >=0.19.2
• Fabric API >=0.149.1+26.2

Build

./gradlew build

Usage

Log in to Bilibili

/danmaku login

Login flow:

1. The mod requests a Bilibili QR login session;
2. A temporary local HTTP server is started on your machine;
3. A http://127.0.0.1:<port>/ link is shown in the chat;
4. Click the link or manually copy it into your browser;
5. Scan the QR code on the page with the Bilibili mobile app;
6. Confirm the login on your phone;
7. After a successful login, the cookie will be saved to the local config directory.

Check login status

/danmaku loginstatus

Log out from Bilibili

/danmaku logout

This removes the locally saved Bilibili login information.

Set live room

/danmaku set <roomId>

If the danmaku client is already running, the new room ID will not take effect immediately. You need to stop and start the client again.

Start receiving danmaku

/danmaku start

After starting, danmaku messages from the currently configured live room will be displayed in the in-game chat.

Stop receiving danmaku

/danmaku stop

After stopping, the current WebSocket connection will be closed, and stale messages from old connections will be discarded.

Check status

/danmaku status

Shows the current danmaku client status and room ID.

Debug Logs

By default, detailed danmaku parsing logs, authentication responses, and statistics are not printed.

To enable debug logs, add the following JVM argument when launching Minecraft:

-Dmcdanmaku.debug=true

Notes

• Bilibili live danmaku APIs and login flows may change and break compatibility;
• Login information is only used to request Bilibili danmaku and user-related data;
• Do not publicly share bilibili-auth.properties or any file containing cookies;
• If the live room is offline or the Bilibili WebSocket node is unavailable, danmaku messages may not be received.