Premium

Premium Commands

All commands available to servers with active Mataru Premium.

ℹ

All commands on this page require active Server Premium. Use !premium status to check, or !premium redeem <key> to activate.

Autorole#

Automatically assign roles to members when they join the server. You can configure separate role lists for human members and bots.

⚠

Autorole will not assign roles with dangerous permissions (Administrator, Ban Members, Manage Guild, etc.) for safety. Roles above the bot's highest role also cannot be assigned.

!autoroleAutomatically assign roles to new membersPremium

Examples

!autorole enable!autorole add human @Member!autorole add bot @Bot!autorole remove human @Member

Aliases

ar

Subcommand	Description
!autorole enable	Enable the autorole system
!autorole disable	Disable the autorole system (config preserved)
!autorole add human @role	Add a role to assign to new human members
!autorole add bot @role	Add a role to assign to new bots
!autorole remove human @role	Remove a role from the human autorole list
!autorole remove bot @role	Remove a role from the bot autorole list
!autorole clear	Clear all autorole settings

Booster Role#

Server boosters can create and fully customize a personal role. Two types are available: a Selfrole (personal, non-shareable) positioned above the booster's highest role, or a Circle of Friends (COF) role that can be shared with other members.

ℹ

Role icons require the server to be at Boost Level 2 or higher. Booster roles are automatically removed when the user stops boosting.

!boosterroleManage your personal booster rolePremium

Examples

!boosterrole create selfrole!boosterrole create cof!boosterrole color #ff73fa!boosterrole share @friend

Aliases

brbrole

Subcommands#

Subcommand	Description
!br create selfrole	Create a personal role positioned above your highest role
!br create cof	Create a shareable Circle of Friends role
!br name <name>	Change the role name (max 100 characters)
!br color #hex	Change the role color using a hex code
!br icon <url\|emoji>	Set the role icon — URL, Unicode emoji, or custom server emoji
!br hoist <on\|off>	Show the role separately in the member list
!br share @user	Give your COF role to another member (COF only)
!br unshare @user	Remove your COF role from a member (COF only)
!br shared	List all members who currently have your COF role
!br info	View your current booster role details
!br delete	Permanently delete your booster role

Vanity Status Role#

Automatically assign a role to members who include a specific text (your server vanity URL or any custom string) in their Discord custom status. The role is removed when they remove the vanity from their status.

ℹ

Use !vanity sync to perform a manual scan of all cached members and sync their roles based on current status. Note: presence must be cached for the sync to detect custom statuses.

!vanityAuto-assign roles when members rep your server vanity in their statusPremium

Examples

!vanity setup @VanityRep discord.gg/mataru!vanity settext discord.gg/myserver!vanity enable!vanity sync

Aliases

vanityrolevr

Subcommand	Description
!vanity setup @role [text]	Quick setup — sets role, text, and enables in one command
!vanity setrole @role	Set the role to assign to members with the vanity
!vanity settext <text>	Set the text to look for in member statuses
!vanity enable	Enable the vanity role system
!vanity disable	Disable the vanity role system
!vanity status	View full vanity configuration and messages
!vanity channel #ch	Set the channel for vanity announce messages
!vanity logs #ch	Set the channel for vanity log entries
!vanity message add <text>	Set the message sent when a member equips the vanity
!vanity message remove <text>	Set the message sent when a member removes the vanity
!vanity message reset	Reset both messages to defaults
!vanity sync	Manually scan all cached members and sync roles

Guild Tag#

Automatically assign or remove a role and post a message when members equip or remove the Discord server tag (clan tag). Uses Discord's member flags API to detect tag status.

!guildtagAuto-assign roles when members equip or remove the server tagPremium

Examples

!guildtag enable!guildtag role @TagHolder!guildtag sync

Aliases

gtagclantagservertag

Subcommand	Description
!guildtag enable	Enable the guild tag system
!guildtag disable	Disable the guild tag system
!guildtag status	View full configuration and message templates
!guildtag role @role	Set the role to assign when the tag is equipped
!guildtag channel #ch	Set the announce channel for tag events
!guildtag logchannel #ch	Set the log channel for tag events
!guildtag message add <text>	Set the message sent when a member equips the tag
!guildtag message remove <text>	Set the message sent when a member removes the tag
!guildtag message reset	Reset both messages to defaults
!guildtag sync	Scan all members and sync roles based on current tag status
!guildtag reset	Reset the entire guild tag configuration

Mass Role#

Add or remove a role from all members, all human members, or all bots at once. The operation runs with a small delay per member to avoid Discord rate limits.

⚠

Mass role cannot be used on roles with dangerous permissions (Administrator, Ban Members, Manage Guild, Manage Channels, Manage Roles, Manage Webhooks, Mention Everyone). The role must also be below the bot's highest role.

!massroleAdd or remove a role from all members at oncePremium

Syntax!massrole <add|remove|humans|bots> @role

Examples

!massrole add @Member!massrole remove @OldRole!massrole humans @Human!massrole bots @Bot

Aliases

mrole

Mass Unban#

Unban every user on the server's ban list in one command. A confirmation button is required before the operation starts. The bot processes unbans with a 350ms delay between each to respect Discord's rate limits.

!massunbanUnban all banned users from the server (confirmation required)Premium

Syntax!massunban

Aliases

munbanunbanall

Anti-Alt#

Block new or alternate accounts from joining the server by enforcing a minimum account age. Accounts younger than the configured threshold are automatically kicked or banned.

!antialtBlock new/alt accounts from joining based on account agePremium

Syntax!antialt <enable <days>|disable|action <kick|ban>>

Examples

!antialt enable 7!antialt enable 30!antialt action ban!antialt disable

Aliases

altdetect

Subcommand	Description
!antialt enable <days>	Enable anti-alt with a minimum account age in days (1–365)
!antialt disable	Disable anti-alt protection
!antialt action kick	Kick accounts younger than the threshold (default)
!antialt action ban	Ban accounts younger than the threshold

Server Profile#

Customize the bot's avatar, banner, and bio specifically for your server. These changes only affect how the bot appears in your server and do not change its global profile.

ℹ

Only the Server Owner can use server profile commands. Provide an image URL or attach an image directly to the message.

Command	Description
!setserveravatar <url>	Set the bot's server-specific avatar — URL or attachment
!setserverbanner <url>	Set the bot's server-specific banner — URL or attachment
!setserverbio <text>	Set the bot's server-specific bio (max 190 characters)
!resetserveravatar	Reset the bot's server avatar to its global default
!resetserverbanner	Reset the bot's server banner to its global default
!resetserverbio	Clear the bot's server bio