Invite the bot
Bring Sakumi into your server, make sure slash commands are enabled, and give it the permissions it needs to post messages, embeds, and manage roles if you use shop role rewards or reaction roles.
sakumi docs
Everything in one place
A proper guide for setting up Sakumi, understanding the dashboard, and learning how each bot module works without digging through commands blind.
Quick Start
Modules
FAQ
quick start
Get Sakumi working fast
Open the dashboard
Log in with Discord, pick a server you actually manage, and configure modules from the dashboard instead of memorizing every command upfront.
Set your basics
Rename your server currency, create your first embed, and set your join, leave, or boost messages so your server feels finished right away.
Good to know: Global slash commands can take a little time to update across Discord after deploys or changes.
dashboard
How the dashboard is organized
The dashboard is built around modules. Each module has its own settings page, and most of them also have matching slash commands so you can work from Discord or from the site.
- Overview: a fast read on your server setup and enabled systems.
- Embeds: build, preview, save, and send reusable embeds.
- Economy: manage currency names, balances, drops, and server rewards.
- Community modules: levels, reaction roles, tickets, reminders, giveaways, birthdays, and more.
- Moderation and anti-nuke: member safety, account age checks, and protection rules.
- Dev panel: owner and developer-only controls for Premium, module visibility, and rollout toggles.
economy
Currency, shops, grabs, and rewards
Per-server currency
Each guild keeps its own economy name, balances, cooldowns, inventory, shop state, and role rewards. One server can use Hanami while another uses petals or anything else you choose.
Grab drops
Sakumi can post timed drops into reward channels. Members have a limited window to claim them, and you can configure separate quick and long drop flows in the dashboard or through commands.
Normal and secret shops
Use categories to organize items, batch import with a text file, lock the secret shop behind a balance threshold, and attach Discord roles so rewards are applied automatically after purchase.
Mini-games and bot sync
Members can earn currency through games like slots, coinflip, and wordguess, and you can also bridge rewards from trusted bots with BotSync.
embeds
Embeds, welcome flows, and message styling
Sakumi’s embed tools are meant to feel simple but still powerful. You can build embeds from the dashboard or inside Discord, preview them live, save them by name, and reuse them across welcome, leave, boost, tickets, or announcements.
Live builder
Edit title, description, colors, images, thumbnails, footers, timestamps, and links while watching the preview update.
Markdown support
Formatting buttons help you add Discord markdown like bold, italics, code blocks, and mentions without having to remember the syntax.
Reusable saved embeds
Once an embed is saved, you can send it again later or attach it to welcome, leave, boost, verification, and ticket flows.
community
Levels, reaction roles, tickets, AI, and server utilities
Levels
Track activity, announce level-ups, and control where leveling matters. The goal is to reward the channels you want instead of inflating levels everywhere.
Reaction roles
Post role panels with your own custom embeds or saved embeds, then let members self-assign roles with clean buttons and emoji labels.
Ticketing and verification
Create ticket panels, set log channels, and use verification flows for age-gating or custom trust checks depending on how your server is structured.
AI chat
Sakumi AI can answer on demand and optionally speak up in configured channels with a controlled chance and cooldown, so it feels lively without being spammy.
safety
Moderation, anti-nuke, and server protection
Moderation is split so you can keep normal day-to-day settings apart from stronger anti-nuke protections. That way you can tune filters, account age requirements, and safety automation without making the whole dashboard messy.
- Account age checks: block suspiciously fresh accounts before they can become a problem.
- Anti-nuke protections: guard against destructive joins, role abuse, channel spam, and mass damage patterns.
- Logs and review channels: route moderation, verification, and setup events into staff channels so you always know what changed.
commands
Command Reference
Browse commands by system instead of one giant wall of slash commands.
custom api
Live API Explorer
This page loads Sakumi's real custom API capabilities from the backend first, then only lets you invoke actions the server actually reports.
Load capabilities first so the site can validate actions against the backend instead of trusting hardcoded names.
selected action
Choose an action group
The explorer will fill this with live action metadata from `/api/custom/capabilities`.
invoke
Validated request builder
response
Load capabilities to start.
faq
Common questions
Why are my slash commands missing?
Global Discord commands can take time to update. If they stay missing, recheck your token, client ID, and deploy flow.
Why are embeds or role rewards failing?
Double-check the bot’s permissions and role order. Sakumi needs room above the roles it manages.
Can I do setup without the dashboard?
Yes. Most major systems still have matching slash commands, so you can configure them fully inside Discord if you prefer.