Documentation

How each part of Tuna works, with the commands to set it up.

Getting Started

Invite Tuna to your server, then run a scan so you know exactly what the bot is looking at before you configure anything.

,scanserver

This produces a full written report, every role and its permissions, every category and channel, and a best guess at what each channel is used for.

Permissions

Tuna needs Manage Roles, Manage Channels, Manage Messages, Kick Members, and Ban Members to run its core features. Its own top role must sit above any role it's asked to manage, if a command fails with a permissions error, this is almost always why.

Moderation & Logs

Every moderation action creates a numbered case with full history:

,warn @user Spamming links
,case 47
,history @user

Route any of six log categories, messages, members, roles, channels, voice, server, to their own channel:

,logs set messages #mod-logs

Automod

The slur filter is on by default and is separate from general profanity, regular cursing is never touched unless you turn on the word filter yourself.

,filter toggle slurs true
,medialock @role

Music

No paid audio hosting needed. Tuna streams audio directly. Play by name, YouTube link, or a Spotify track/playlist link:

,join
,play never gonna give you up
,play https://open.spotify.com/track/...

Spotify playlist links need one thing set up first: the bot owner logs in once via the Owner Panel's "Connect Spotify" button. Individual track links work immediately either way. The Now Playing message has real Previous/Pause/Skip buttons, not just text.

LFG

Start a looking-for-group post with a game name and a party size. People join or leave with buttons, and the whole party gets pinged the moment it fills.

,lfg "Ranked Valorant" 5

Lock every LFG post to a specific channel if you'd rather keep it out of general chat:

,setlfgchannel #looking-for-group

Economy

A full wallet-and-bank currency system with daily rewards, jobs, and a leaderboard.

,daily
,work
,balance
,leaderboard

Leveling

Every part of it is adjustable, not just an on/off switch:

,levelconfig xprange 15 25
,levelconfig cooldown 60
,levelconfig rolereward 10 @Level-10
,levelconfig multiplier #general 2.0
,levelconfig ignore #bot-commands

Run ,levelconfig with no arguments to see every current setting in one place.

Community Tools

The day-to-day engagement stuff, all built in:

,rolemenu "Pick your games" @Valorant 🎯 @Minecraft ⛏️
,poll "Best map?" "Dust2" "Mirage" "Inferno"
,starboard #starboard ⭐ 3
,sticky set "Read the rules before posting!"

Staff & Tickets

Build a rank ladder from lowest to highest, then let people apply through a ticket panel. Accepting an application grants the entry-level rank automatically.

,ranks add @Trial-Mod
,staffappsetup #applications @Reviewer-Team
,staffapppanel

Promoting someone requires holding a rank at least two steps above the one you're granting, or being an administrator.