Documentation

PoiiBot

A feature-rich Discord bot built for VTuber communities. Economy, profiles, moderation, stream alerts, and much more.

80+Commands
๐ŸŒธHana Coins
146+Servers
No commands found matching your search.
๐Ÿš€

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

Use /serverinfo as an admin to see a full settings dashboard. Configure with setup commands below.

โš™๏ธ

Server Setup

Admin configuration commands

Permissions: Most setup commands require MANAGE_SERVER or ADMINISTRATOR.
/serverinfo
Shows server stats. Admins see a full PoiiBot settings dashboard โ€” welcome, modlog, levels, autorole, and starboard all at once.
/modlog-enable
Set the channel where moderation logs are posted.
channel*
/modlog-remove
Disable moderation logging for this server.
/welcome-enable
Set a welcome channel and optional custom message for new members.
channel*message
/welcome-remove
Disable welcome messages for this server.
/role-enable
Set a role to automatically assign to new members when they join.
role*
/role-remove
Disable the autorole for this server.
/setmodrole
Set the server moderator role. Mods with this role can access and respond to ticket panels.
role*
/starboard-enable
Enable a starboard channel where highly-reacted messages get featured.
channel*
/starboard-remove
Disable the starboard for this server.
/ticket
Post a ticket panel with a button for members to open private support tickets with staff. Customizable title, description, and button label.
titledescriptionbutton-label
๐ŸŒธ

Economy โ€” Hana Coins

Earn, spend, and manage your coins

Ways to earn: Chat passively (1โ€“3/msg, 60s cooldown) ยท /daily check-in ยท /work every 4 hours ยท Guild level-ups (25 ร— level) ยท Fight wins ยท Rare loot finds
/balance
Check your Hana Coin balance and your global rank on the rich list. Optionally check another user.
user
/daily
Claim your daily Hana Coins. Base reward is 50โ€“150 coins based on streak. Bonus payouts at 7-day (+100), 30-day (+300), and 100-day (+1,000) streaks. Resets at midnight UTC.
/work
Work a 4-hour shift and earn 100โ€“300 Hana Coins with a random VTuber-themed job. 10% chance of a 1.5ร— bonus shift. 4-hour cooldown per user.
/gift
Send Hana Coins to another user. Can't gift more than your current balance.
user*amount*
/leaderboard
Paginated leaderboards with dropdown category switching: ๐ŸŒ Global Level ยท ๐Ÿ  Server Level ยท ๐ŸŒธ Hana Coins ยท โš”๏ธ Fight Record. Use โฌ…๏ธ โžก๏ธ to paginate.
category
๐Ÿ›๏ธ

Shop

Spend Hana Coins on cosmetics and boosts

๐ŸŽ–๏ธ

Badges โ€” ๐ŸŒธ 2,500

Profile card badges. Special: ๐Ÿ’ฐ Moneymaster is ๐ŸŒธ 100,000 and exclusively earnable.

๐Ÿ–ผ๏ธ

Wallpapers โ€” ๐ŸŒธ 5,000

Custom profile card backgrounds. Preview before buying.

โœจ

Borders โ€” ๐ŸŒธ 3,000โ€“5,000

Glow borders that bloom outward from your card. Six colors available.

โšก

Boosts

24hr Exp Boost (๐ŸŒธ 8,000) or permanent Loot Boost (๐ŸŒธ 15,000).

/shop
Browse the Hana Shop by category. Select an item to get a Preview button (renders your actual card with the item applied) and a Purchase button. Navigate categories and pages with buttons.
category
๐Ÿ“ฆ

Loot System

Search for items and build your inventory

Rarity tiers: โšช Common โ†’ ๐ŸŸข Uncommon โ†’ ๐Ÿ”ต Rare โ†’ ๐ŸŸ  Ultra-Rare โ†’ ๐Ÿ’œ Mythic. Rare+ finds award bonus Hana Coins. Special loot items (War Hammer, Mythic Shield, Kings Chair) affect the fight system.
/loot-search
Search for loot with a suspense delay and rarity-colored results. Rare+ finds grant bonus Hana Coins. Loot Boost (from shop) skips to uncommon tier.
/loot-stats
View your looting statistics โ€” counts per rarity tier and any stat-boosting items you own.
/inventory
View all items currently in your inventory.
๐Ÿ–ผ๏ธ

Profile Card

Your personal canvas card

Your card shows: username, title/flair, prestige tag, global level, server level, HP bar, Hana Coins, marriage status with partner avatar, bio text, and your badge collection. Equip a border via /shop.
/profile
View your profile card or another user's. Shows all stats, badges, bio, HP bar, and equipped border glow.
user
/profile-set bio
Open a modal to write your profile bio (up to 200 characters). Displayed in the bio box on your card.
/profile-set title
Set a title or flair that appears under your username on your profile card (max 35 characters).
title*
/profile-set badge
Choose which of your owned badges displays as your primary badge in the top-right corner of your card using a dropdown selector.
/profile-set clear
Clear a specific profile setting โ€” bio, title, primary badge, or border glow.
setting*
๐Ÿ“Š

Levels & Prestige

Two-track progression system

PoiiBot tracks ๐ŸŒ Global (all servers, never resets) and ๐Ÿ  Server (per-server, resets on prestige). Both update from messages. Only server level-ups post notifications. Guild level-ups award Hana Coins (25 ร— new level).
/level-check
Check your current level with a visual progress bar. Optionally evaluate a target level, check another user, or switch between global/server scope.
levelscopeuser
/level-toggle
Toggle server level-up notifications on or off. Exp still accumulates silently when off. Global milestones (25/50/75/100) are always announced.
/level-channel
Set a dedicated channel for level-up messages. Without this, level-ups post in the user's active channel.
channel*
/level-remove
Remove the dedicated level-up channel.
/prestige
Available at Server Level 60. Resets server level to 0 for a permanent prestige badge and Hana Coin reward (1,000 ร— prestige number). Global level is never affected. Requires typing PRESTIGE in a modal to confirm. Maximum prestige: 5.
โš”๏ธ

Fight System

Turn-based combat with items and rewards

Fight items from /loot-search: Ultra War Hammer (+damage, 25% proc) ยท Mythic Shield (50% damage reduction) ยท Kings Chair (heal to 120 on kill) ยท Band-aids (heal mid-fight, max 5). Winners earn 10โ€“30 Hana Coins, doubled on a 3+ loss streak.
/fight
Challenge another user to a turn-based fight. They get 60 seconds to Accept or Decline. Each turn: choose โš”๏ธ Attack, ๐Ÿ›ก๏ธ Defend, or ๐Ÿฉน Band-aid. 15 seconds per turn โ€” auto-attack fires on timeout. Both players must have HP above 0.
user*
/fight-stats
View your fight record with global rank, win rate bar, total damage, biggest win, loss streak, and tier (๐Ÿ”ฐ Unranked โ†’ ๐Ÿ‘‘ Legend). Optionally check another user.
user
/revive
Revive yourself after being killed in a fight. Free if above 50 HP. Restores to max HP.
๐Ÿ’ฌ

Social & Marriage

Interact with other members

/marry
Propose to another user. They get Accept/Decline buttons with a 60-second window. Both must be single. Auto-applies the married badge to both profiles.
user*
/marry-check
Check who you or another user is married to, with the partner's avatar and how long you've been together.
user
/divorce
Divorce your current partner. Requires confirmation. Removes the married badge from both profiles.
/hug
Hug another user with a random GIF.
user*
/pat
Give someone headpats.
user*
/kiss
Kiss another user.
user*
/bonk
Bonk another user.
user*
/slap
Slap another user.
user*
/cry
Start crying with a random GIF.
/simp
Check your simp level with a visual 10-block progress bar. Tiers from ๐ŸงŠ Ice Cold to ๐Ÿ‘‘ ULTRA SIMP.
/ppsize
Calculate your pp size with a visual bar and tier rating (๐Ÿ”ฌ Microscopic โ†’ ๐Ÿ‘‘ Legendary).
/ship
Check the compatibility between two users with a percentage and tier label.
user1*user2*
/shipname
Combine two usernames into a ship name.
user1*user2*
/poll
Create a yes/no/maybe poll. Bot reacts with ๐Ÿ‘ ๐Ÿ‘Ž ๐Ÿคท for members to vote.
text*
/afk
Set yourself as AFK with an optional reason. Auto-replies when someone pings you showing your reason and elapsed time. Clears automatically when you send a message.
reason
/contact
Request a live chat session with the bot owner. One session at a time โ€” if the owner is busy you're notified. Accepted sessions relay your DMs to the owner and vice versa.
๐Ÿ“ก

Stream Alerts

Twitch live notifications for your server

Polls every 3 minutes. Posts a live embed (title, game, viewers, thumbnail, Watch button) when a streamer goes live, and edits it to show stream ended + duration when they go offline. Each server's alerts are fully independent.
/alert add
Add a Twitch streamer to watch. Validates the username before adding. Optionally set a role to ping and a custom message alongside the alert.
username*channel*pingcustom-message
/alert remove
Remove a Twitch streamer alert from this server.
username*
/alert list
Show all configured stream alerts for this server, including current live status for each.
/alert test
Preview what a live alert embed will look like for a given username without requiring them to be live.
username*
๐Ÿ›ก๏ธ

Moderation

Keep your server safe and organized

Warning system: Warnings are tracked per-server (drives action prompts) AND globally (full cross-server history via /case). At 3 server warnings, mods are offered Ban / Kick / 24h Timeout / Dismiss buttons in the modlog.
/warn
Issue a warning. DMs the user with the reason and their current strike count. Logs to modlog. At 3 strikes, an action prompt with Ban / Kick / Timeout / Dismiss buttons is posted to modlog.
user*reason*
/warn-check
Check a user's warnings. scope:guild (default) shows this server's warnings with reasons and dates. scope:global shows warnings across all servers grouped by server.
user*scope
/warn-reset
Clear all warnings for a user in this server with a confirmation button. Global history is preserved for /case.
user*
/case
Full moderation history for a user โ€” warnings, staff notes, risk level (๐ŸŸข Clean โ†’ ๐Ÿ”ด High Risk), account age, and server join date. scope:global shows full cross-server warning history grouped by server. Ephemeral โ€” only you see it.
user*scope
/note add
Add a private staff note to a user's record. Never visible to the user โ€” only accessible to staff via /note list or /case.
user*note*
/note list
View all private staff notes on a user in this server.
user*
/note delete
Delete a specific staff note by its ID. Requires ADMINISTRATOR.
id*
/timeout
Timeout a member using preset durations (5 minutes up to 1 week) or remove an existing timeout. DMs the user. Logs to modlog. Respects role hierarchy.
user*duration*reason
/lock
Lock a channel so @everyone cannot send messages. Optionally specify a different channel and a reason. Logs to modlog.
channelreason
/unlock
Unlock a previously locked channel, restoring the @everyone send messages permission to default.
channelreason
/prune
Bulk delete 1โ€“99 messages. Optionally filter by user to only delete messages from that specific member. Discord only allows bulk delete within 14 days.
count*user
/slowmode
Set a channel slowmode using preset durations (Off, 5s, 10s, 30s, 1m, 5m, 10m, 1h). Optionally applies to a different channel.
duration*channel
๐Ÿ”ง

Utility

Useful everyday commands

/userinfo
Detailed user info โ€” Discord/server join dates, roles, global level, server level, Hana Coins, fight record, and prestige level.
user
/avatar
Get a user's avatar as a full-size image.
user
/ping
Check the bot's current response latency.
/invite
Get the invite link to add PoiiBot to your server.
/urban
Look up a term on Urban Dictionary. NSFW-channel only. Shows definition, example, and vote rating.
term*
/megaphone
Shout a message to the global megaphone channel. Requires a Megaphone item from /loot-search. Mythical Unicorn Horn gives unlimited uses.
shout*
/sniped-message
View the last deleted message in the current channel.
/thread
Create a thread in the current channel.
name*
๐ŸŽ‰

Fun

Entertainment commands

/birb
Get a random bird image.
/f
Pay your respects.
/pretend-ban
Fake ban a user with a dramatic red embed and a custom reason.
user*reason*
owo this message
Context menu โ€” right click any message and OwO-ify it.
deepfry image
Context menu โ€” right click any image message to deep fry it.
/deny
Deny a user's request dramatically.
user*