Getting Started
What you need to know first
🌸
Hana Coins
The bot's currency. Earn by chatting, daily check-ins, leveling up, fighting, working, and finding loot.
📊
Level System
Two separate tracks: global (all servers) and per-server. Both earn exp from messages.
🖼️
Profile Card
A custom canvas card showing your stats, badges, bio, HP, and coins. Fully customizable.
⚙️
Server Setup
Admins use setup commands to configure welcome messages, modlogs, autorole, and more.
Server Setup
Admin configuration commands
Permissions: Most setup commands require MANAGE_SERVER or ADMINISTRATOR. You can also manage most settings from the Dashboard.
/verify setup
Post a verification panel with a button. Members click it to receive the verified role and gain access. Creates a Verified role automatically if none specified.
titledescriptionbutton-labelrole
🔒 Manage Server
/serverinfo
Shows server stats. Admins see a full settings summary covering welcome, modlog, levels, autorole, and starboard.
/modlog-enable
Set the channel where moderation logs are posted.
channel*
🔒 Manage Server
/modlog-remove
Disable moderation logging for this server.
🔒 Manage Server
/welcome-enable
Set a welcome channel and optional custom message. Use
$@ to mention the user, $name for username, $server for server name.channel*message
🔒 Manage Server
/welcome-remove
Disable welcome messages for this server.
🔒 Manage Server
/role-enable
Set a role to automatically assign to new members when they join.
role*
🔒 Manage Server
/role-remove
Disable the autorole for this server.
🔒 Manage Server
/setmodrole
Set the server moderator role. Mods with this role can access and respond to ticket panels.
role*
🔒 Manage Server
/starboard-enable
Enable a starboard channel where highly-reacted messages get featured.
channel*
🔒 Manage Server
/starboard-remove
Disable the starboard for this server.
🔒 Manage Server
/ticket
Post a ticket panel with a button for members to open private support tickets with staff.
titledescriptionbutton-label
🔒 Manage Server
Economy
Hana Coins, earning, spending
Hana Coins are earned passively from chatting (60-second cooldown), daily check-ins, leveling up, fighting, working, and looting. Support server boosters earn 2x coins.
/balance
Check your Hana Coin balance or another user's.
user
/daily
Claim your daily Hana Coin reward. Streaks increase the payout.
/work
Work for Hana Coins. 4-hour cooldown. Shows one of many job descriptions each time.
/gift
Send Hana Coins to another user.
user*amount*
/leaderboard
View server and global leaderboards for levels, coins, and fight wins. Dropdown to switch between tabs.
Shop
Spend your Hana Coins
/shop
Browse the Hana Coin shop. Buy profile card backgrounds and badges.
Profile Card
Customize and view your profile
Your card shows username, title, prestige tag, global level, server level, HP bar, Hana Coins, marriage status, bio text, and your badge collection. Equip a border via /shop. You can also edit your bio and title from the Dashboard.
/profile
View your profile card or another user's.
user
/profile-set
Customize your profile. Set a bio, display title, primary badge, or clear your settings. Subcommands: bio, title, badge, clear.
/avatar
View your avatar or another user's at full size.
user
/userinfo
View detailed information about a user including account age, roles, and bot data.
user
Levels and Prestige
Earn exp, climb ranks
PoiiBot tracks Global and Server levels separately. Both update from messages. Server level-ups award Hana Coins (25 x new level). Support server boosters earn 2x exp.
/level-check
Check your current level, exp, and how much is needed to reach the next level.
user
/level-toggle
Enable or disable level-up notifications for this server.
🔒 Manage Server
/level-channel
Set a dedicated channel for level-up messages.
channel*
🔒 Manage Server
/level-remove
Remove the dedicated level-up channel. Notifications will post in the user's active channel.
🔒 Manage Server
/prestige
Reset your server level to 0 in exchange for a prestige point and Hana Coins. Global level is unaffected.
Fight System
Challenge other users to battles
Fights use HP. When HP hits 0 you can't fight until revived. Deal damage based on your level and luck. Win Hana Coins from defeated opponents.
/fight
Challenge another user to a fight. Both players take turns attacking until one runs out of HP.
user*
/fight-stats
View your fight record: wins, losses, total damage dealt, and your biggest win.
user
/fight-revive
Spend Hana Coins to revive another user who has been knocked out.
user*
Loot System
Find and collect rare loot
/loot-search
Search for loot drops. Rarity ranges from Common to Mythic. Cooldown applies between searches.
/loot-inventory
View your loot collection. Shows how many of each rarity you've found.
/loot-stats
View the server loot leaderboard. See who has found the most rare drops.
Stream Alerts
Twitch stream notifications
Stream alerts are free with no streamer limits. You can also manage stream alerts from the Server Dashboard. Add streamers, set custom messages with Discord markdown formatting, and remove alerts without using any commands.
/alert add
Add a Twitch streamer to watch. Set a channel, optional role to ping, and optional custom message.
streamer*channel*rolemessage
🔒 Manage Server
/alert remove
Remove a stream alert for a Twitch streamer.
streamer*
🔒 Manage Server
/alert list
Show all stream alerts in this server and their current live status.
/alert test
Preview what the live alert embed will look like for a configured streamer.
streamer*
Moderation
Keep your server in order
/warn
Issue a warning to a user with a reason. Logs to the modlog channel if configured.
user*reason*
🔒 Moderate Members
/warn-check
View all warnings for a user in this server.
user*
🔒 Moderate Members
/warn-reset
Clear all warnings for a user in this server.
user*
🔒 Moderate Members
/timeout
Timeout a user for a specified duration.
user*minutes*reason
🔒 Moderate Members
/lock
Lock a channel so only staff can send messages.
🔒 Manage Channels
/unlock
Unlock a previously locked channel.
🔒 Manage Channels
/prune
Bulk delete messages in a channel. Max 100 at a time.
amount*
🔒 Manage Messages
/slowmode
Set a slowmode delay on a channel in seconds. Set to 0 to disable.
seconds*
🔒 Manage Channels
/note
Add a hidden mod note to a user's record that only staff can see.
user*note*
🔒 Moderate Members
/case
View a specific moderation case by ID.
id*
Utility
General purpose commands
/help
Get a list of all commands with links to the documentation.
/birthday
Set your birthday (month and day only). PoiiBot announces birthdays in configured servers. Subcommands: set, check, clear, channel.
/schedule
Post and manage stream schedules. Accepts natural language dates. Times display in each user's local timezone. Subcommands: add, view, mine, delete, post, channel.
/announce
Configure a channel to receive PoiiBot update announcements. Subcommands: set-channel, status.
/poll
Create a poll with up to 4 options. Members vote by clicking buttons.
question*
/channel-topic
Post a clean embed showing the current channel topic.
/serverinfo
View stats and configuration info for the current server.
/userinfo
View detailed info about a user: account age, join date, roles, and bot data.
user
Fun
Lighthearted commands
/ppsize
You know what it does.
/ship
Check the love compatibility between two users.
user1*user2*
/f
Pay your respects.
/rip
Generate a RIP memorial image for a user.
user*
/triggered
Generate a triggered GIF for a user.
user*
/owo
OwO-ify a message. Works as a context menu command on any message.
/simp
Generate a simp certificate for a user.
user*
VTuber Registry
Global VTuber discovery and collections
Cards are global across every server. Autocomplete suggests matching names as you type. Browse the full registry from the Dashboard.
/vtuber view
View a VTuber's rendered card. Autocomplete suggests names as you type.
name*
/vtuber search
Browse approved VTubers by content type. Results sort by most collected.
tag
/vtuber random
Pull up a random approved VTuber from the registry.
/vtuber submit
Submit a VTuber via a two-part form. Part 1: image, bio, agency, content tags, oshi marks. Part 2: languages, Twitch, YouTube, Twitter, debut date.
name*
/vtuber collect
Add a VTuber to your collection for 100 Hana Coins. Once per day per VTuber.
name*
/vtuber collection
Browse your collected VTuber cards in a paginated list.
/vtuber support
Support a VTuber for 50 Hana Coins. One-time per VTuber, permanent.
name*
/vtuber edit
Edit your own verified VTuber card. Only available after the verification process.
name*
Reaction Roles
Self-assignable role panels
You can create and manage role panels entirely from the Dashboard. No commands needed. Discord commands are also available if you prefer.
/reactionrole create
Post a new role panel in the current channel. Choose between Toggle or Exclusive mode.
title*type*description
🔒 Manage Server
/reactionrole add
Add a role button to an existing panel. Provide the message ID of the panel.
message-id*role*label*emoji
🔒 Manage Server
/reactionrole remove
Remove a role button from a panel. The panel rebuilds automatically.
message-id*role*
🔒 Manage Server
/reactionrole delete
Delete an entire panel and remove the message from the channel.
message-id*
🔒 Manage Server
/reactionrole list
Show all role panels in this server, including message IDs, channel, type, and role count.
Birthday System
Automatic birthday announcements
PoiiBot only stores the month and day, never the year. You can also set your birthday from your Dashboard profile page.
/birthday set
Set your birthday by month and day. PoiiBot never stores the year.
month*day*
/birthday check
Check your birthday or another user's, including days until it arrives.
user
/birthday clear
Remove your birthday from PoiiBot.
/birthday channel
Set a channel for birthday announcements.
channel
🔒 Manage Server
Stream Schedule
Let your server know when you're going live
Times display in each user's local timezone. Date parsing is flexible:
June 15 8pm, Jul 4th 3:30pm, and June 15 20:00 all work./schedule add
Add a stream to the server schedule. Accepts natural language dates.
title*date*descriptiontwitch
/schedule view
View all upcoming streams scheduled in this server, sorted by time.
/schedule mine
View your own scheduled streams with their IDs.
/schedule delete
Delete one of your scheduled streams by its ID. Get the ID from /schedule mine.
id*
/schedule post
Post the full upcoming schedule as a formatted embed to the schedule channel.
/schedule channel
Set the channel where schedule announcements are posted.
channel
🔒 Manage Server
Announcements
Opt in to receive PoiiBot update announcements
/announce set-channel
Set a channel to receive PoiiBot announcements. Leave blank to opt out.
channel
🔒 Manage Server
/announce status
Check whether this server has an announcement channel configured.
Social
Interact with other users