warn <user> [reason]
Issue a warning to a member. Creates a case and DMs them if possible.
Commands
Every command Vinyl understands, grouped the same way as its in-Discord .help menu. Default prefix is ., and your server may have changed it with .prefix.
Moderation
Warnings, kicks, bans, timeouts, and case tracking.
kick <user> [reason]
Kick a member from the server.
ban <user> [reason]
Ban a user, even if they have already left the server.
softban <user> [reason]
Ban then immediately unban, clearing the user's recent messages without a permanent ban.
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 cannot 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.
Server Management
Auto-moderation, roles, verification, welcome and leave messages, custom embeds, and autoresponders.
Auto-Moderation
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
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 that 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
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.
Welcome & Leave Messages
welcome [#channel]
Set the welcome message channel.
welcome text <message>
Use a plain text welcome message. Supports variables like {user} and {server}.
welcome embed <name>
Use a saved custom embed (see below) as the welcome message.
welcome default
Reset welcome messages to Vinyl's built-in embed.
welcome status
View the current welcome message configuration.
goodbye [#channel]
Set the leave message channel. Alias: farewell. Has the same text / embed / default / status subcommands as welcome.
modlog [#channel]
Set the channel moderation actions get logged to.
testwelcome / testgoodbye
Preview the current welcome or goodbye message without a real join or leave.
Custom Embeds
embed create <name>
Open a point and click editor to build or edit a saved embed. Alias: edit.
embed addfield <name> <field name> | <field value> [| inline]
Add a field to a saved embed.
embed removefield <name> <index>
Remove a field by its number.
embed setthumbnail <name> <url>
Set a saved embed's thumbnail image.
embed setauthor <name> <text>
Set the small author line above a saved embed's title.
embed preview <name>
Preview a saved embed with variables resolved for you.
embed send <name> [#channel]
Call and post a saved embed by name, anywhere. Aliases: call, post.
embed list
List every saved embed in this server.
embed delete <name>
Delete a saved embed. Alias: remove.
embed variables
See what {variables} you can use in embed text. Alias: vars.
Autoresponders
autoresponder add <trigger> <response>
Reply automatically whenever a message contains the trigger phrase. Alias: ar.
autoresponder addexact <trigger> <response>
Same as above, but only fires when a message exactly matches the trigger.
autoresponder addembed <trigger> <embed_name>
Reply with a saved custom embed instead of plain text.
autoresponder remove <trigger>
Remove an autoresponder. Alias: delete.
autoresponder list
List every autoresponder configured for this server.
autoresponder toggle
Enable or disable autoresponders for this server.
Utility
Server info, configuration, translation, 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, and 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.
Translation
translate <language_code> <text>
Translate text into another language. Alias: tr.
React with a country flag
React to any message with a flag to get an instant translation reply, no command needed.
language [code]
View or set the language Vinyl replies to you in, so every response gets translated from then on. Aliases: lang, setlanguage.
Fun
Giveaways, lighthearted extras, AFK status, and message sniping.
Giveaways
giveaway start <duration> <winners> <prize>
Start a giveaway with a button to enter. Duration examples: 30m, 1h, 2d. Alias: gw.
giveaway end <message_id>
End a giveaway early and pick the winners now.
giveaway reroll <message_id>
Pick new winners for an already ended giveaway.
giveaway list
List active giveaways in this server.
Extras
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 reaction poll.
applefact
Get a random apple fact. Alias: fact.
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, badges, and the server leaderboard.
rank [user]
Generate a rank card showing level, XP progress, badges, 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.
Badges
badge
Show your own earned badges.
badge list [user]
List a member's earned badges.
badge catalog
See every badge and how to earn it. Some unlock automatically at certain levels or leaderboard positions, others are granted by staff.
badge give <user> <badge_name>
Grant a badge to a member.
badge revoke <user> <badge_name>
Revoke a badge from a member.