Commands

Every command Vinyl understands, grouped the same way as its in-Discord .help menu. Default prefix is . - your server may have changed it with .prefix.

🛡️ Moderation

Warnings, kicks, bans, timeouts, and case tracking.

warn <user> [reason]

Issue a warning to a member. Creates a case and DMs them if possible.

kick <user> [reason]

Kick a member from the server.

ban <user> [reason]

Ban a user - works even if they've already left the server.

softban <user> [reason]

Ban then immediately unban, clearing the user's recent messages without permanently banning them.

timeout <user> <duration> [reason]

Timeout a member. Duration examples: 10m, 1h, 2d. Alias: mute.

unban <user_id> [reason]

Remove a ban by user ID.

nick <user> [new_nickname]

Change or reset (type reset) a member's nickname. Alias: nickname.

purge <amount>

Bulk delete up to 100 messages from the current channel. Alias: clear.

slowmode <seconds>

Set the channel's slowmode delay. Use 0 to disable.

lock [#channel]

Lock a channel so @everyone can't send messages. Defaults to the current channel.

unlock [#channel]

Undo a previous lock.

cases <user>

View a member's moderation history. Aliases: history, modlogs.

case <case_id>

View one specific case by its number.

🐛 Auto-Moderation

Spam detection, content filtering, and automated protection - runs on its own once enabled.

automod

Show the auto-moderation command overview.

automod status

View current auto-moderation settings and thresholds.

automod toggle

Turn auto-moderation on or off for this server.

automod spam <on|off>

Toggle spam detection specifically.

automod filter <on|off>

Toggle the prohibited-word content filter.

automod whitelist add <word|channel|role> <value>

Exempt a word from the content filter, or a channel/role from every automod check entirely.

automod whitelist remove <word|channel|role> <value>

Remove an existing whitelist entry.

automod whitelist list

Show the current whitelist for this server.

🔐 Verification

A gate for new members, with manual or self-serve verification.

verify [user]

With no user: starts your own verification (DMs you a code). With a user and Manage Roles permission: verifies them manually.

verify confirm <code>

Complete verification using the code sent to your DMs.

verification

Show the verification configuration overview. Alias: verifysystem.

verification setup

Guided setup - creates a Verified role and enables the system.

verification enable / disable

Turn the verification requirement on or off.

verification role <@role>

Set the role granted on successful verification.

verification status

View current settings and verification statistics.

🎭 Roles

Create, edit, and assign server roles.

role

Show the role command overview.

role create <name> [color]

Create a new role. Color accepts #hex, 0xhex, or a color name.

role delete <role>

Delete a role (asks for confirmation first).

role add <user> <role> / role remove <user> <role>

Add or remove a role from a member.

role color <role> <color>

Change a role's color.

role rename <role> <new_name>

Rename a role.

role list

List all roles in the server with member counts and colors.

role info <role>

Detailed info about a specific role.

🌱 Events & Welcome

Join/leave messages and related configuration.

welcome [#channel]

Set the channel for welcome messages.

goodbye [#channel]

Set the channel for goodbye messages. Alias: farewell.

modlog [#channel]

Set the channel moderation actions get logged to.

testwelcome / testgoodbye

Preview the welcome or goodbye embed without a real join/leave.

🍏 Utility

Server info, configuration, and general tools.

ping

Check the bot's latency.

info

About Vinyl - version, servers, and library info. Alias: about.

uptime

Live stats: uptime, server count, latency.

invite

Get Vinyl's invite link.

prefix [new_prefix]

View or change this server's command prefix.

userinfo [user]

Detailed info about a member. Aliases: ui, user.

serverinfo

Detailed info about the server. Aliases: si, server, guildinfo.

avatar [user]

Show a member's avatar with download links. Aliases: av, pfp.

config

Show the configuration command overview.

config view

View this server's current configuration.

config set <setting> <value>

Set a configuration value (channels, roles, prefix).

config reset <setting>

Reset a setting back to its default.

config setup

Guided setup wizard for core settings.

🎉 Fun

Lighthearted extras for downtime.

8ball <question>

Ask the orchard a yes-or-no question.

coinflip

Flip a coin. Aliases: flip, coin.

roll [sides]

Roll a die (default 6 sides). Alias: dice.

poll <question>

Start a quick 👍 / 👎 poll.

applefact

Get a random apple fact. Alias: fact.

🌍 Translation

Translate on demand, or automatically via a reaction.

translate <language_code> <text>

Translate text into another language. Alias: tr.

React with a flag emoji 🇪🇸 🇫🇷 🇯🇵 ...

React to any message with a country flag to get an instant translation reply - no command needed.

language [code]

View or set the language Vinyl replies to you in - every response gets auto-translated from then on. Aliases: lang, setlanguage.

🍂 Extras

AFK status and sniping deleted messages.

afk [reason]

Mark yourself AFK. Clears automatically the next time you send a message.

snipe

Show the most recently deleted message in the current channel.

📈 Leveling

XP, rank cards, and the server leaderboard.

rank [user]

Generate a rank card showing level, XP progress, and leaderboard position. Alias: lvl.

leaderboard

Show the server's top 10 by XP. Aliases: top, lb.

levelconfig

Show the leveling configuration overview. Alias: lvlconfig.

levelconfig toggle

Enable or disable leveling for this server.

levelconfig channel <#channel>

Set where level-up announcements are posted.

levelconfig status

View current leveling settings.