Lingchu Bot documentation is now live — check it out!
Lingchu Bot

Adapter Selection

Lingchu Bot groups concrete adapters into platform capabilities. Only one adapter is enabled per platform by default. The current QQ platform priority is:

  1. ~onebot.v11

When unset, QQ uses ~onebot.v11. To select an adapter explicitly, set a global NoneBot configuration value:

LINGCHUAdapter = "~onebot.v11"

Default selection. Make sure NoneBot has loaded the OneBot V11 adapter. Milky, QQ, and OneBot V12 are deprecated and have been fully removed from the project, including their source code.

Conflict prevention

Explicitly configuring multiple known adapters for the same platform fails startup:

LINGCHUAdapter = "~onebot.v11+~another_adapter"

Lingchu Bot does not control which adapters NoneBot actually imports or registers; it only selects business code through LINGCHUAdapter and checks that the selected adapter has been loaded and registered by NoneBot.

An unknown adapter that does not belong to any platform profile is not considered enabled. Message storage still accepts its events, but writes the platform field as unknown. This gives downstream displays a stable Unknown bucket instead of treating the raw adapter name as a platform ID.

For developer documentation on the adapter registry and adding new platforms, see Adapter Guide.

Last updated on