ᛝ Taïru ᛝ

Taïru is a Discord bot built for communities that want more than just basic moderation. It handles the repetitive stuff — welcoming members, collecting their suggestions, tracking who invited whom, bumping, filtering out ghosts, and automatically moderating rule-breaking messages — so you can focus on growing your server.

---

💬 Anonymous Confessions

Members can submit anonymous confessions directly from Discord using /confess. Each confession is posted in a dedicated channel and gets its own thread for replies. Interactive buttons let anyone reply anonymously, and the bot quietly marks whether a reply comes from the original author — no identity revealed. Moderators get a separate log channel to review content without breaking anonymity.

---

💡 Suggestions

Members can submit ideas and improvements using /suggest. The command opens a modal to write the suggestion (10 to 1024 characters), then posts an embed in the configured suggestions channel — or the current channel if none is set.

How voting works

Once the embed is posted, the bot automatically adds three vote reactions:

Reaction	Meaning
✅	For
⚪	Neutral (can be disabled)
❌	Against

• Exclusive voting: clicking a reaction automatically removes the member's other votes (one vote per person).
• Live counters: the embed fields display the real-time vote count for each option.
• Dynamic color: the embed color updates to reflect the current leading vote.

Leading vote	Embed color
✅ For	🟢 Green
❌ Against	🔴 Red
Tie / ⚪ Neutral / No votes	⬜ Grey

⚠️ Automatically removing duplicate votes requires the Manage Messages permission in the suggestions channel.

---

👋 Welcome Messages

New member? Taïru's got it. Set up a fully custom welcome embed with a title, a message (with {{member}} and {{memberCount}} variables), an image, and a pool of random greeting quotes. When someone joins, existing members can hit the "Greet" button to send one of those quotes as a welcome.

You choose when the welcome fires:

Mode	Behavior
on_join	Triggers the moment the member joins
on_role_add	Triggers when the unverified role is assigned
on_role_remove	Triggers when the unverified role is removed

Use /config welcome preview to see exactly what the message looks like before publishing it.

---

📨 Invite Tracking

Taïru tracks which invite link each new member used to join the server. When a member arrives, it logs a detailed embed in the configured channel:

• 👤 Member tag and mention
• 📅 Account creation date
• 👥 Current server member count
• 🔗 Invite link used (code + URL)
• 📨 Who sent the invite (mention + tag)
• 🔢 Number of times the invite has been used
• ⏳ Invite expiry date (or "Never")

⚠️ Requires the Manage Server (MANAGE_GUILD) permission to fetch the invite list.

Configure it with /config invites set-log-channel.

---

⏰ Bump Reminder

Taïru watches for Disboard bumps and automatically pings your bump channel when the 2-hour cooldown is up. Configure a role to mention so the right people get notified every time. No more manual tracking, no more missed bumps.

---

🛡️ Auto-Moderation

Taïru includes a fully configurable auto-moderation system. Each rule independently maps a trigger to a sanction — rules stack, and only the first matching one fires per message.

Triggers

Trigger	What it detects
spam	Too many messages sent in a short time window
banned-words	A word or regex pattern found in a message
mentions	Too many user/role mentions in a single message
caps	A message exceeding a set percentage of uppercase letters
links	All HTTP/HTTPS links, or Discord invite links only

Sanctions

Sanction	Effect	duration option
warn	Logs a warning in DB + sends a DM to the member	—
timeout	Temporarily mutes the member	Duration in minutes
kick	Immediately kicks the member	—
ban	Permanently bans the member	Days of messages to delete (0–7)

When a message triggers a rule, it is automatically deleted before the sanction is applied.

---

/automod spam

Subcommand	Options	What it does
set	threshold, window, sanction, duration?	Triggers if a member sends ≥ threshold messages within window seconds
disable	—	Removes the spam rule

---

/automod banned-words

Multiple patterns can coexist. Each add creates a separate rule with its own sanction.

Subcommand	Options	What it does
add	pattern, sanction, duration?	Adds a banned word/regex (e.g. bad|worse|slur.*)
remove	id	Removes a rule by its ID
list	—	Lists all banned word rules for the server

---

/automod mentions

Subcommand	Options	What it does
set	max, sanction, duration?	Triggers if a message contains ≥ max user or role mentions
disable	—	Removes the mention rule

---

/automod caps

Subcommand	Options	What it does
set	percent, min-length?, sanction, duration?	Triggers if ≥ percent% of letters are uppercase (ignores short messages below min-length letters, default 10)
disable	—	Removes the caps rule

---

/automod links

Subcommand	Options	What it does
set	type (all / invites), sanction, duration?	Blocks all HTTP links or Discord invites only
disable	—	Removes the link rule

---

/automod settings

Subcommand	Options	What it does
set-log-channel	channel	Channel where all automod actions are logged
list-rules	—	Lists all active automod rules with their config and sanction

---

🔨 Auto-Kick

For servers with a verification flow, Taïru can automatically kick members who never get the required role within a set time window. Configure it with /automod auto-kick:

Subcommand	What it does
set-role	The role members need to avoid being kicked
set-delay	How long to wait before kicking (in minutes, min. 1)
set-log-channel	Where to log each kick action
disable	Turn it off entirely

Auto-kick and the rule-based automod each have their own independent log channel.

---

⚙️ Configuration

Every setting is per-server. Nothing bleeds between guilds. All /config commands require the Administrator permission.

Bump

Command	What it does
/config bump set-channel	Sets the channel for bump reminders
/config bump set-role	Sets the role to mention in reminders

Welcome

Command	What it does
/config welcome set-channel	Sets the welcome channel
/config welcome set-unverified-role	Sets the unverified role
/config welcome set-title	Sets the embed title
/config welcome set-message	Sets the embed description (interactive, 60s to reply)
/config welcome set-image	Sets the embed image URL (leave empty to remove)
/config welcome add	Adds a quote to the greeting pool
/config welcome remove	Removes a quote from the pool by ID
/config welcome list	Lists all quotes in the pool
/config welcome set-trigger-mode	Sets when the welcome fires (on_join, on_role_add, on_role_remove)
/config welcome preview	Previews the welcome message in the current channel

Confessions

Command	What it does
/config confessions set-logs-channel	Sets the moderation log channel

Suggestions

Command	What it does
/config suggest set-channel	Sets the channel where suggestions are posted (optional — falls back to the current channel)
/config suggest toggle-neutral	Enables or disables the neutral vote reaction ⚪ (enabled by default)

Invites

Command	What it does
/config invites set-log-channel	Sets the channel where invite join logs are sent

---

🌍 Language

Run /language to switch between English and French. The change applies server-wide instantly — every bot response follows.

---

📊 Utilities

Command	What it does
/info	Bot stats (server count, member count) and invite link
/user info	Basic info about any member (ID, bot status, creation date, inviter)
/ping	Current bot latency

Taïru also updates its Discord status every minute, showing live server and member counts.

---

🔐 Required Bot Permissions

Permission	Why
View Channels	Reading channels for all features
Send Messages	Posting confessions, welcome messages, reminders, logs
Send Messages in Threads	Replying inside confession threads
Embed Links	All embeds
Read Message History	Spam detection, fetching confession threads
Manage Messages	Deleting rule-breaking messages (automod) + removing duplicate votes on suggestions
Create Public Threads	Creating threads under confessions
Kick Members	Auto-kick and kick sanction
Ban Members	Ban sanction (automod)
Moderate Members	Timeout sanction (automod)
Manage Server	Fetching the invite list for invite tracking
Add Reactions	Placing the ✅ ⚪ ❌ vote reactions on suggestions

⚠️ If the bump role is not set as mentionable in Discord, add Mention Everyone so the bot can ping it in reminders.

Gateway Intents: Guilds, GuildMembers, GuildMessages, MessageContent, GuildInvites, GuildMessageReactions

---

Continuously hosted, regularly updated, built to stay out of the way.