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.

First-time setup tip: The Server Owner should run zt!setrole <tier> @Role to assign staff tiers. Tiers are helper, mod, senior, and owner. This unlocks the bot's permission system.

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:

• 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

Staff are exempt from AutoMod. Members at Helper+ tier and above will never have their messages removed, even if they post a flagged link.

Run prize drawings with role-based entry multipliers.

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.

Customizable welcome and goodbye messages with variable substitution. Auto-assign roles on join.

Variables you can use:

{user}, {user.tag}, {user.name}, {server}, {membercount}, {date}, {time}

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

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

Anti-spam: 5 failed attempts triggers a 1-hour cooldown. Make sure the bot's role is above the verified role in Server Settings → Roles.

Plush+ Recover recently deleted messages with /messagelog snipe. Plush+ exclusive feature.

Plush+: 10 messages per channel, 1-hour retention. Bots and DMs are never logged.

DeepL-powered translation in 25 languages. Free tier: 5 per user per day.

Cached translations don't count against your quota — same text + same target = free repeat. Plush+ users get unlimited translations.

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.