Documentation

Three steps to get ZT Plush running in your server:

1. Click the invite link and choose your server.
2. Authorize the requested permissions. The bot needs Manage Roles, Manage Messages, Send Messages, Embed Links, Add Reactions, and a few more — it asks only for what it actually uses.
3. In any channel, run /info for a full feature overview, or /help for category-organized commands.

Before diving into individual features, here's how the recurring patterns work across the bot. Three things show up everywhere: variables, permission tiers, and defaults.

Variables (the curly braces)

Many features let you customize message templates. Anywhere you see {like_this} in a template, the bot replaces it with real values when the message goes out. Welcome messages, scheduled messages, giveaway embeds, and broadcasts all support them.

Feature-specific variables (like {prize} for giveaways or {ends} for scheduled events) are documented in each feature section. If a variable doesn't apply to the message you're writing — say, {user} in a scheduled message that fires to a channel without a specific recipient — it just gets left as text. The bot won't crash.

Permission tiers

Every command lists a required tier. Everyone means any member. Helper+ means the Helper tier or higher (so Helper, Mod, Senior, and Owner). See the Permission Tiers section for full details.

Defaults vs. customization

Many features (welcome messages, giveaway embeds, AutoMod responses) work out of the box with sensible defaults. Customization is optional — leave a field blank in the dashboard and the bot falls back to the default. That makes it safe to experiment: you can't accidentally “break” a feature by leaving it half-configured.

ZT Plush has four staff tiers plus the Server Owner. Each tier has clearly defined responsibilities:

Severity-based warnings with auto-escalation. Warnings have three severities: low, medium, high. The bot automatically escalates based on a member's total active warnings.

Auto-escalation thresholds trigger when total active warnings reach: 3 → automatic timeout, 6 → kick, 8 → ban. Low/medium severity warnings clear when a member leaves; high severity persists across rejoins (capped at 5).

Detects and removes phishing/scam links automatically. Uses a curated Discord-targeted list plus the URLhaus public threat-intel feed (~14,000 domains, refreshed every 12 hours).

Default escalation

Per member, within 24 hours of the first offense:

• 1st offense: Delete + high-severity warning + DM offender + ping staff
• 2nd offense: Delete + high warning + 1-hour timeout
• 3rd offense: Delete + 24-hour timeout
• 4th+ offense: Delete + ban

Allowlist & Blocklist (v3.1.0)

Server-specific overrides for the bot's threat detection. Configured from the dashboard's AutoMod page:

• Allowlist — domains the bot will never flag, even if they show up in URLhaus. Use for GIF hosts, your own domain, legit short links.
• Blocklist — domains the bot will always flag, regardless of any threat feed. Use for scammers targeting your community that aren't in URLhaus yet.

Both lists support leading-position wildcards: *.example.com matches all subdomains (e.g. sub.example.com) but not the bare example.com itself. No caps on either list — safety doesn't have a quota.

Customizable welcome and goodbye messages with variable substitution. Auto-assign a role on join. Configure everything from the dashboard's Welcome page, or use the slash commands below.

Welcome Rotation (v3.1.0)

Tired of every new member getting the same greeting? Set up a rotation pool of welcome messages and the bot randomly picks one on each join.

• Free: 10 messages in the pool
• Plush+ 30 messages in the pool

Each message can be individually paused without losing its slot — handy for seasonal greetings. Configure rotation from the dashboard's Welcome page. If the rotation is enabled but the pool is empty (or all messages are paused), the bot falls back to the single welcome message above.

Let members register their birthday with the bot. On the day, the bot posts an announcement in your chosen channel — optionally pinging a celebration role.

Configure the announcement channel, ping role, and custom message from the dashboard's Birthday page.

When someone boosts your server, the bot can post a thank-you message. Configure the channel and message template from the dashboard's Booster page.

Booster Tier Roles (v3.1.0) — Track how many boosts each member has contributed and auto-assign milestone roles when they hit specific thresholds (e.g. “3+ boosts”, “5+ boosts”). Free for everyone, up to 12 tiers per server. Configure from the dashboard.

Two classic Discord channel games, both built in:

• Counting — members take turns counting up: 1, 2, 3, 4… The bot tracks the current number, the all-time high, and (optionally) prevents the same user from counting twice in a row.
• Word-Chain — each new word must start with the last letter of the previous word. The bot enforces the rule, tracks the chain length, and remembers your server's best streak.

Both are configured per-channel from the dashboard. Set the channel, the bot enforces the rules. Failed attempts are deleted automatically.

Click-to-assign role panels. Pipe-separated syntax, supports unicode and custom emojis.

Define your own slash-prefix commands with custom responses. Optionally restrict who can use them, and add multiple responses to pick from at random.

Run prize drawings with role-based bonus entries. Start from the dashboard or via slash command. Bonuses are additive: a member with two bonused roles gets both bonuses summed on top of their base 1 entry.

Customization (v3.2.0)

From the dashboard's Giveaways page, you can set server-wide defaults for new giveaway embeds — title template, color, footer, thumbnail, plus a rotating pool of up to 4 image URLs (randomly picked per giveaway). Templates support variables:

“Who entered” view (v3.2.0)

On the dashboard's Giveaways page, each giveaway card has a collapsible Show entrants dropdown. Available to anyone with Manage Server permissions. Shows entry weights (so you can see who got bonus entries) and lazy-loads so it doesn't bog down the page.

Queue messages to fire at a specific time, or have them recur on a schedule. Each message can broadcast to multiple channels in one shot.

• Free: 10 scheduled messages per server, 1 channel each
• Plush+ 40 scheduled messages per server, up to 5 channels each (broadcast)

Schedule types:

• once — fires at a specific date/time, then disables itself
• hourly, daily, weekly — repeats at that interval starting from when you save
• custom — fires every N minutes (1 minute to 30 days)

Each scheduled message can be plain text or a custom embed (title, description, color, image, thumbnail, footer). Configure everything from the dashboard's Scheduled Messages page.

Plush+ Full audit-log mirror for your server. Tracks everything Discord's own audit log shows, with optional role exceptions so trusted staff don't get logged.

What gets logged: message edits and deletes, member joins/leaves, voice channel activity, role and channel creation/deletion, permission changes, and more.

Plush+ When a member gains a specific role, the bot automatically gives them another role. Use it to set up “promotion chains” — getting promoted to Junior Mod also grants the all-staff color role, for example.

Each rule has a trigger role (what they gain) and a reward role (what gets added). Optionally configure the reward to be removed when the trigger is removed.

Configure from the dashboard's Role Rewards page. Each server can have multiple rules; they all evaluate independently.

Plush+ Send a DM to every member who holds a specific role. Useful for staff announcements, ticket follow-ups, or coordinating events.

Safeguards: Members can opt out per-server. Hard caps on recipients and daily sends prevent accidental abuse. Throttled DM delivery to avoid Discord rate limits.

Bot-protected entry gate, free for everyone. New members see a button → solve a colored-button challenge → role assigned. Stops raid bots cold.

Auto-updating voice channels that display live server stats. Pick a stat type, pick a channel, customize the name template — the bot keeps the name in sync.

Available stat types: members, online, bots, humans, roles, channels, boosts, bot status.

• Free: 2 stats channels per server
• Plush+ 10 stats channels per server

Configure from the dashboard's Stats Channels page.

13 ticket categories with auto-transcripts. Set up the panel once; members open tickets via dropdown.

Lavalink-powered with multi-source playback. Best results: SoundCloud URLs — text queries open a picker. YouTube major-label tracks may require login; SoundCloud and indie YouTube work reliably.

DeepL-powered translation across 25+ languages. Caps apply per-user, per-server, per day — meaning your usage in one server doesn't eat into your usage in another.

• Free servers: 5 translations per user per day
• Plush+ 20 translations per user per day (4× the cap)

Cached translations don't count — same text + same target language = free repeat. Resets at midnight UTC.

Extract emojis, stickers, avatars from any message. Embed social media URLs cleanly.

Discord caches command lists per-server. After updates, new commands may not appear immediately. This is normal — here's how to fix it:

1. Refresh your Discord client first: Press Ctrl+R on desktop, force-close and reopen on mobile.
2. Still missing? Server Owner runs /sync refresh — instant per-server sync (5-min cooldown).
3. Need to reset? /sync reset removes guild-specific overrides.

Why this happens: ZT Plush registers commands globally. Discord's CDN propagates updates within ~1 hour, but Ctrl+R and /sync refresh skip the wait.