Auto Verification

Automatically assign roles when users meet stat requirements.

Auto Verification watches for k!ui commands and automatically assigns roles to users who meet all configured stat requirements.


Enable and Set a Channel#

Enable auto verification and restrict it to a specific channel:

/config karuta auto_verify enabled:true verify_channel:#verification

Users must run k!ui in the configured channel for verification to trigger. Running it in any other channel has no effect.


Set Roles to Assign#

Configure which roles are assigned on a successful verification:

/config karuta auto_verify roles_to_add:@Member,@Verified

Pass roles as a comma-separated list of mentions or IDs. All listed roles are assigned simultaneously when a user passes.

Card Companion's role must be above every role it assigns in the server's role hierarchy, and it must have the Manage Roles permission.


Stat Requirements#

Add a stat requirement that users must meet:

/config karuta auto_verify stat:Cards grabbed value:5000

Users must satisfy every configured requirement to receive roles.

Available Stats#

Stat nameWhat it checks
Cards grabbedTotal cards grabbed from drops
Cards burnedTotal cards burned
BitsCurrent bit balance
MorphsTotal morphs performed

Multiple Requirements#

Run the command again with a different stat to stack requirements:

/config karuta auto_verify stat:Cards grabbed value:5000/config karuta auto_verify stat:Morphs value:50

Both conditions must be met before roles are assigned.

Removing a Requirement#

/config karuta auto_verify remove_stat:Cards grabbed

How It Works#

A user runs k!ui in the configured verification channel.

Card Companion reads their stats from the k!ui embed.

If every stat requirement is met, the configured roles are assigned immediately with no further action required.


Verifying Your Setup#

/config view

Confirm that auto_verify shows the correct channel, roles, and stat requirements before announcing it to your server.

Last updated June 12, 2026