Now serving communities worldwide

The last bot your
community needs.

AI-powered conversations, elite moderation, XP progression, economy, giveaways, tickets, analytics — every feature your server deserves, unified in one meticulously crafted bot.

SCROLL
35+
Source Files
21+
Commands
7
Modules
0ms
Analytics Lag
100%
TypeScript

What Hishitsu does

Everything. And then some.

Built from scratch in TypeScript with strict typing, Redis-backed rate limiting, a PostgreSQL data layer, and a Gemini AI engine — not a patchwork of plugins.

Intelligent AI

Ping the bot anywhere or chat in its designated channel. Powered by Gemini 1.5 Flash with RAG context from your knowledge base. Shows a typing indicator while thinking.

Elite Moderation

Warn, ban, kick, timeout, purge, lock. Four-tier permission cascade. Persistent case IDs. Auto-expiry tempbans. Logging to a dedicated channel — all from slash commands.

XP & Leveling

Redis-backed cooldowns survive restarts. Per-guild XP with configurable role rewards at any level. Paginated leaderboard with ASCII progress bars.

Economy System

Per-guild coins, daily claims, work jobs, server shop with role grants, inventory, and peer-to-peer transfers. Cooldowns via Redis — no reset on restart.

Analytics Dashboard

Messages, joins, leaves, voice time — buffered in Redis, flushed to PostgreSQL every 5 minutes. Zero latency on the event path. Historical data always queryable.

Ticket System

One-click panel buttons create private, permission-overwrite channels. Claim, close, add members. Full audit trail per guild. No configuration file required.

Giveaways

CSPRNG winner selection. Role and level requirements. Duration parsing (1d12h30m). Early-end and reroll. Button-based entry with live count display.

AutoMod

Anti-spam, anti-link, anti-raid, banned word filter. Per-user asyncio-style locks. Warning → timeout cascade. All in-memory with 5-minute pruning for zero DB writes.

Components V2

Every response uses Discord's new Message Components V2. No legacy embeds. Dark-blended #2b2d31 accent, zero emojis, mobile-first vertical layout.

Live preview

Responses that
look like they belong.

Every message is built with ContainerBuilder, SeparatorBuilder, and TextDisplayBuilder — no embeds, no clutter. Status prefixes instead of emojis. Code blocks for dynamic values. Your server's theme, uninterrupted.

Typing indicator before every AI response
Responds to pings and designated AI channel
One-hour Redis cache — identical questions cost zero API calls
#ai-chat
U
username Today at 14:32
@Hishitsu what are the rules for getting the verified role?
H
Hishitsu BOTToday at 14:32
AI: RESPONSE
-# Question: what are the rules for getting the verified role?
Based on the server knowledge base: To receive the Verified role, you must read and agree to the rules in #rules, then react with ✅. The role is granted automatically within a few seconds.
-# Powered by Gemini 1.5 Flash
M
moderator Today at 14:35
/warn user:@spammer reason:Spam in #general
H
Hishitsu BOT
MODERATION: WARNING ISSUED
Memberspammer
Warning ID#17
ReasonSpam in #general
Total Warnings1

Getting started

Three steps to a
smarter server.

01

Add Hishitsu

Click the invite link, choose your server, and Hishitsu is live immediately. All tables are created automatically on first boot.

02

Configure with Slash Commands

Use /config set to assign mod-log channels, roles, and welcome messages. Use /aiconfig enable to unlock the AI assistant.

03

Teach and Grow

Add knowledge with /teach, let the AI answer questions, watch your community analytics update in real time.

Community voices

Built for real servers.

"The AI channel is genuinely useful. Members ask questions and actually get correct answers based on our rules. No one reads pinned messages — they just ask Hishitsu now."

R
Rin
Admin · Gaming Community

"Replaced four separate bots. Moderation, economy, leveling, and tickets all in one. The Cv2 styling means it doesn't look out of place — responses feel native."

K
Kaito
Owner · Tech Hub

"The giveaway system is the best I've used. CSPRNG selection, role requirements, live entry count — and the cooldowns actually persist through restarts unlike every other bot."

S
Seren
Mod · Anime Server

Ready?

Add Hishitsu.
It's free.

No payment. No trial. No feature gates. Add the bot and configure it entirely from Discord — no dashboard account required for server admins.

Add to Server Support Server

Full Feature Set

Built to handle
everything.

Eight production-grade modules. One bot. Zero compromises.

AI Assistant

Gemini 1.5 Flash with RAG. Responds to pings and in the designated AI channel. Typing indicator before every response. Knowledge base via /teach. One-hour Redis cache.

@mentionAI channel/ask/teach/knowledge/aiconfig

Moderation

Four-tier permission cascade. Persistent case IDs. Tempbans with auto-expiry. All actions logged to a mod-log channel. DMs the target before acting.

/warn/ban/kick/timeout/purge/lock/modlogs

AutoMod

Anti-spam (sliding window), anti-link (CDN whitelisted), anti-raid (join wave detection), banned word filter. Warning threshold → auto-timeout pipeline.

/automod enable/automod spam/automod links/automod raid/automod addword

Leveling & XP

XP granted per message with Redis cooldowns that survive restarts. Configurable level role rewards. Rank cards with ASCII progress bars and leaderboards.

/rank/leaderboard/givexp/takexp/levelconfig

Economy

Per-guild coins with daily rewards, hourly work (Redis cooldown), server shop with role grants, inventory, and peer-to-peer transfers with transaction safety.

/balance/daily/work/shop/buy/pay

Support Tickets

Button-panel tickets create private permission-overwrite channels. Claim, close, add members. Auto-incremented ticket numbers. 5-second channel deletion after close.

/ticket setup/ticket close/ticket claim/ticket add

Giveaways

Cryptographically secure winner selection (crypto.randomInt). Role + level requirements. Flexible duration strings. Early-end and reroll. Live entry count on button.

/giveaway create/giveaway end/giveaway reroll

Analytics

Messages, joins, leaves, and voice minutes buffered in Redis with sub-millisecond overhead. Flushed to PostgreSQL every 5 minutes. Accessible from the admin dashboard.

Auto-collectedDashboard view90-day history

Reference

Command Reference

Modules

Moderation

Four-tier permission cascade: Bot Owner → Server Admin → DB Mod Role → Discord Permission. All actions create a case ID and log to your mod-log channel.

/warn <user> <reason>MOD
Issues a warning, logs it, DMs the target, and increments their warning count. Auto-times out at the configured threshold.
/warnings <user>MOD
Lists all active warnings for a member with case IDs and moderator names.
/removewarn <id>MOD
Deactivates a warning by its case ID. Warning count is recalculated automatically.
/kick <user> [reason]KICK MEMBERS
Kicks a member. DMs them before the kick. Logs the action.
/ban <user> [reason] [delete_days]BAN MEMBERS
Bans a member. Supports delete_days 0-7 for message history cleanup. DMs before banning.
/unban <user_id> [reason]BAN MEMBERS
Unbans a user by their Discord ID. Works even if they are no longer visible in member list.
/timeout <user> <minutes> [reason]MOD
Times out a member (1 minute to 4 weeks). Uses Discord's native timeout, not a role.
/untimeout <user> [reason]MOD
Removes an active timeout immediately.
/purge <amount> [user]MANAGE MESSAGES
Bulk-deletes 1-100 messages. Optional user filter. Messages older than 14 days are skipped (Discord rule).
/lock [reason]MANAGE CHANNELS
Prevents @everyone from sending messages in this channel.
/unlock [reason]MANAGE CHANNELS
Restores @everyone send permission.
/slowmode <seconds>MANAGE CHANNELS
Sets channel rate limit. 0 to disable. Max 21600 (6 hours).
/modlogs <user> [limit]MOD
Displays a member's full moderation history, most recent first.

Leveling

XP is awarded per message with a 60-second Redis cooldown per user per guild. Cooldowns survive bot restarts. Formula: threshold(n) = 100 × 1.5^n

/rank [user]
Displays a rank card with current level, total XP, ASCII progress bar, balance, and warnings.
/leaderboard [page]
Paginated top-10 XP leaderboard with PREV/NEXT navigation buttons.
/givexp <user> <amount>MANAGE GUILD
Grants XP directly to a member (1–100,000).
/takexp <user> <amount>MANAGE GUILD
Removes XP from a member. Cannot go below 0.
/levelconfig add <level> <role>MANAGE GUILD
Assigns a role reward to a specific level. Roles are granted automatically on level-up.
/levelconfig remove <level>MANAGE GUILD
Removes a level role reward.
/levelconfig list
Lists all configured level role rewards for this server.

Economy

All balances are per-guild. Cooldowns use Redis TTL keys — they do not reset on bot restart, unlike in-memory dictionaries.

/balance [user]
Check your or another member's coin balance and total earned.
/daily
Claim 500 coins every 24 hours. Cooldown is timestamp-based, not Redis.
/work
Earn 100–350 coins. One-hour cooldown stored in Redis.
/shop
Browse all items available in this server's shop.
/buy <item_id>
Purchase an item from the shop. Role is granted automatically if configured.
/inventory
View your purchased items.
/pay <user> <amount>
Transfer coins to another member. Uses a database transaction — atomic.
/additem <name> <price> [role]MANAGE GUILD
Adds an item to the server shop. Optional role grant on purchase.

Tickets

Ticket channels use permission overwrites — only the ticket creator, support role, and bot can see them. Channels are automatically deleted 5 seconds after closing.

/ticket setup <channel> <support_role> [category]MANAGE CHANNELS
Posts the ticket panel button in a channel. All new tickets go in the specified category.
/ticket close
Closes this ticket and schedules the channel for deletion in 5 seconds.
/ticket claim
Marks this ticket as claimed by you. Each ticket can only be claimed once.
/ticket add <user>
Grants a member visibility and write access to this ticket channel.

Giveaways

Winner selection uses crypto.randomInt() — a cryptographically secure PRNG backed by os.urandom. Never Math.random().

/giveaway create <prize> <duration> [winners] [role] [min_level]MANAGE GUILD
Starts a giveaway. Duration supports flexible notation: 1d, 12h, 30m, 1d6h30m. Entry via button. Min 1 minute, max 28 days.
/giveaway end <id>MANAGE GUILD
Ends a giveaway early and immediately selects winners.
/giveaway reroll <id>MANAGE GUILD
Picks new winners for an already-ended giveaway. Works on any previously ended giveaway.

AutoMod

All tracking is in-memory with a 5-minute pruning cycle. No database writes on the hot path. Warning cascade: warn → if ≥ threshold → 5-minute timeout.

/automod enable <true/false>MANAGE GUILD
Master toggle for all AutoMod rules.
/automod spam <true/false>MANAGE GUILD
Anti-spam: 5 messages in 5 seconds triggers a deletion and warning.
/automod links <true/false>MANAGE GUILD
Anti-link: deletes external links. Discord CDN and jump-links are always whitelisted.
/automod raid <true/false>MANAGE GUILD
Anti-raid: if 10+ members join within 10 seconds, kicks the triggering member and logs to mod-log.
/automod addword <word>MANAGE GUILD
Adds a word to the banned word list. Matched on whole-word boundaries.
/automod removeword <word>MANAGE GUILD
Removes a word from the banned word list.
/automod wordsMANAGE GUILD
Lists all banned words for this server.
/automod status
Shows the current AutoMod configuration for this server.

AI Assistant

Powered by Gemini 1.5 Flash. The bot also responds automatically to pings (@Hishitsu your question) and to messages in the designated AI channel — no slash command needed.

/ask <question>
Ask the AI a question via slash command. Must be enabled by a server admin.
/teach <title> <content>MANAGE GUILD
Adds a document to the server knowledge base. The AI uses this to answer questions more accurately.
/knowledge listMANAGE GUILD
Lists all knowledge base documents with their IDs and creation dates.
/knowledge delete <id>MANAGE GUILD
Permanently removes a knowledge base document.
/knowledge clearMANAGE GUILD
Deletes all knowledge base documents. Shows a confirmation button before proceeding.
/aiconfig enable <true/false>MANAGE GUILD
Enables or disables the AI assistant for this server.
/aiconfig channel [channel]MANAGE GUILD
Restricts AI to a specific channel. Leave empty to allow all channels. In the AI channel, every message gets a response.
/aiconfig prompt [prompt]MANAGE GUILD
Sets a custom system prompt that shapes the AI's personality and scope for your server.
/aiconfig statusMANAGE GUILD
Shows the current AI configuration, channel restriction, system prompt, and document count.

Utility

General-purpose commands for member information, polls, reminders, and more.

/whois [user]
Full member profile: account age, join date, roles, XP, balance, and warning count.
/serverinfo
Server statistics: member count, channels, roles, boost tier, creation date.
/avatar [user]
Returns the full-resolution avatar URL with an open-in-browser button.
/poll <question> <opt1> <opt2> [opt3] [opt4]
Creates a button poll. Each vote shows live percentage bars. One vote per user, re-voting changes your choice.
/remind <time> <message>
Sets a reminder. Supports 1h30m, 2d, etc. Delivered in the channel it was set in. Min 1 minute, max 28 days.
/snipe
Shows the last deleted message in this channel. Cache is per-channel, in-memory only.

Fun

Stateless entertainment commands. All have a 2–5 second cooldown.

/8ball <question>
The classic magic 8-ball with 20 responses. Color-coded by positivity.
/roll <dice>
Standard dice notation: 1d20, 2d6+3, 4d6. Up to 100 dice, up to 1000 sides. Shows individual rolls.
/rps <choice>
Rock-paper-scissors against the bot. Instant result.
/slots
Slot machine with weighted symbols. Triple diamond is the jackpot.
/joke
A random curated joke.
/fact
A random interesting fact.
/coinflip
Heads or tails.

Configuration

All settings are per-server and take effect immediately. No restart required. Column names are validated against an allowlist — no SQL injection possible.

/config viewMANAGE GUILD
Displays all current settings with resolved channel and role mentions.
/config set <setting> [channel/role/value]MANAGE GUILD
Changes a setting. Use the channel or role picker for relevant settings. Available: Mod Log Channel, Welcome Channel, Auto-Join Role, Ticket Category, Ticket Support Role, Starboard Channel, Welcome Message, Goodbye Message, AutoMod thresholds, and more.
/config reset <setting>MANAGE GUILD
Resets a setting to its default value.

Core

Informational commands available to all users.

/ping
Shows WebSocket latency and REST roundtrip time. Color-coded by quality.
/uptime
How long the bot has been online since last start.
/stats
Global bot statistics: guild count, member count, memory usage, Node version, discord.js version.
/invite
Invite link button for adding Hishitsu to another server.
/help
Quick overview of all command categories.