Module documentation

Tickets

Support via private channels. User clicks a button — a channel opens, visible only to them and the moderator role.

• Multiple ticket types (different buttons → different notification roles)
• Transcript saved automatically on close (up to 20 MB per ticket)
• Auto-close on timeout survives bot restart
• Required permissions: Manage Channels (create/delete ticket channels)

Self-assign roles

Button or reaction menus for users to pick roles themselves.

• Up to 5 roles per button panel (Discord limit); 25 on a select menu
• Two modes: multi-select or single-select
• Required permissions: Manage Roles, plus the bot role above the granted ones

Reaction & Button Roles

Two panel types for self-assigning roles: reaction-based (click an emoji → role granted) and button-based. Toggle mode lets users hold multiple roles; unique-pick mode forces a single choice.

• Reaction panels: any guild emoji or unicode → role mapping
• Button panels: up to 5 buttons per row, colors and labels customizable
• Customize embed header, color and description
• Required permissions: Manage Roles, plus bot role above granted ones

Events

Sign-up with reminders. Optionally cross-server.

• Sign-up buttons (up to 10 per event), individual limits, colors
• Reminders: N minutes before in DM and/or in channel (pings registrants or a role)
• Recurring events: repeat every N min/hour/day/week/month
• Publish time: can be configured in advance; past time → publishes immediately
• Favorite (⭐) pins event to the top of history and keeps it forever

Tournaments

Full tournament module with auto-bracket and cross-server participation.

• Formats: single/double elimination, round-robin (with matchesPerPair), group stage + playoffs
• Cross-server modes: NONE (host-only), INVITE_ONLY (private invites), PUBLIC (catalog in /tournaments)
• Best-of: BO1/BO3/BO5/BO7 with score tracking
• Auto-publish bracket to Discord, real-time standings updates

Welcome & Farewell

Greetings and farewells with banner rotation support.

• Modes: channel only, DM only, both
• Markdown formatting in text (B/I/U/S/code/quote/spoiler)
• Multiple banners — bot rotates them randomly on each greeting

Verification

Check before granting roles. Useful against bots.

• Modes: Instant (just a button), Math (arithmetic), Question (custom question)
• Auto-kick: if a user doesn't verify within N minutes — kick
• Required permissions: Manage Roles, Kick Members

Message builder

Embed messages with preview, link buttons and templates.

• Save to favorites, history of the last 50
• Scheduled publishing
• Editing already published messages

Economy

Coins for activity, leaderboards, role shop.

• +1 coin per message (10s cooldown), +6/min in voice, +1 for first reaction
• Periods: weekly/monthly/quarterly — periodEarned resets each period
• Shop: buy a role or custom reward for coins

Giveaways

Giveaways with conditions and cross-server support.

• Conditions: no conditions / by role / coin entry cost
• Cross-server: common entry pool from multiple servers
• History with restart support (paid participants re-enter free on restart)

Birthdays

Members set their birthday via slash-command, the bot posts a wish on the day into a chosen channel. Optional anniversary tracking counts years on the server and triggers a separate greeting.

• Slash-command for users to register day/month (year optional)
• Daily check posts greetings in the configured channel
• Anniversary mode: counts years since the user joined the server
• Custom message template with placeholders {user} and {years}

Voice Plus

Temporary voice channels on demand. A user joins a trigger «Create voice» channel — the bot spawns a fresh VC just for them, grants Manage Channels in it, and auto-deletes the channel when everyone leaves.

• Trigger channel — joining it spawns a personal voice room
• Owner gets Manage Channels in their room: rename, limit, lock
• Auto-deletes when empty so the category stays clean
• Optional name template with {user} placeholder

Moderation

Auto-moderation and warnings.

• Anti-spam (5 messages / 5s), anti-flood (duplicate messages), anti-profanity
• Mute escalation: 1st → 2 min, 2nd → 5 min, 3+ → 10 min
• Warning system with configurable actions per count
• Required permissions: Moderate Members, Kick Members, Ban Members, Manage Messages

Anti-Raid

Mass-join and raid protection — auto-detection by signature.

• Limits on account age, missing avatar, join velocity
• Automatic high-alert mode when threshold tripped
• Logs all actions to audit channel

Permission Audit

PRO+ scanner that walks @everyone and non-admin roles looking for dangerous permission grants — MANAGE_CHANNELS, MANAGE_ROLES, MENTION_EVERYONE on broad audiences. Each finding comes with a suggested fix you can apply or dismiss.

• Scans @everyone and all non-admin roles for risky permissions
• Categorizes findings as critical / warning / info
• Suggested fix per finding with one-click apply
• Monthly automatic re-scan with DM notification on critical issues

Bulk Operations

Mass-edit tools that save dozens of clicks during server setup or restructuring. Create many roles or channels at once, grant a role to everyone matching a condition, copy permission overrides between channels.

• Mass-create roles from a list (names, colors, permissions)
• Mass-create channels in a category with shared overrides
• Conditional role grant: by existing role, join date, activity
• Copy permission overrides between channels in one click

Dashboard Access

The owner can grant per-module access to admins and moderators without giving Discord-level Administrator. Granular permissions let you say «this moderator can manage Tickets only» — they will not see other modules in the dashboard.

• Grant access by Discord role or by specific user ID
• Per-module scope: Tickets, Events, Giveaways, Logging, etc.
• Read-only vs full edit modes per module
• Audit log of all dashboard actions stays attributed to the actor

Logging

Action audit: joins, leaves, message deletes, role changes, etc.

• Output modes: Discord channel, web audit, both
• Storage limit: configurable in MB, old records are pruned

Counters

Voice channels with stats in the name: members, online, in voice, etc.

• Refreshed every 10 minutes (Discord rate-limits 2 renames/10 min per channel)
• 10 metrics: TOTAL/ONLINE/ROLE/BANNED/IN_VOICE/NEW_24H/TIME/CUSTOM_TEXT and more

Server Metrics

Activity dashboard showing the pulse of your server: members trend, top channels, top reactions, voice minutes and a health score. PRO+ unlocks a heatmap and cohort retention chart; PREMIUM adds per-module breakdowns.

• Daily members trend with join/leave deltas
• Top channels, top reactions, voice minutes
• Health score combining activity and retention signals
• PRO+: activity heatmap (hour × weekday) and cohort retention
• PREMIUM: per-module analytics breakdown

Member Journal

Per-member history table aggregating joins, leaves, kicks, bans, mutes and warnings. Filter by «in server / out / banned», search by username, sort by any column. Useful when a name keeps reappearing in mod chatter.

• Aggregates totalJoins / totalLeaves / kicks / bans / mutes / warnings
• Filters: all / currently in / left / banned
• Search by username, sort by any metric
• First-seen, last-join, last-leave timestamps per member

Streamers

Notifications about Twitch and YouTube streams.

• Polling every 5 minutes (parallel concurrency=8)
• Custom announcement text with placeholders {name} and {url}
• API keys required: TWITCH_CLIENT_ID/SECRET, YOUTUBE_API_KEY in .env

Auto-reactions

Bot randomly reacts to messages; secret words grant roles.

• Trigger chance 1–5% (intentionally low so it doesn't get annoying)
• Secret words: 5 attempts / minute per user (brute-force protection)

Cross-server events & giveaways

One event/giveaway across multiple servers — unified participant list.

• PRO feature: invite links from host to other PULSORT servers
• Unified leaderboard across participating servers
• Server-tags to see where each entry came from

Discord Journalist

Weekly community leader — auto-picked by activity with temp role.

• Metrics: messages, reactions, voice time
• Temp role for the week + personal hoisting in member list
• Auto-announcement in chosen channel with top-3

AI Journalist

Auto-publish game news + free game promotions (Epic Games, Steam free).

• Sources: Epic Games Store, Steam, Itch.io free promotions
• Filter by genres and platforms
• Schedule — publish every N hours into specified channels

AI Silence Breaker

Auto-publish discussion prompts when channels go quiet (PRO).

• Silence detection: N minutes without messages in the channel
• AI generates context-relevant prompt based on recent history
• Templates + owner overrides

Comeback magnet

Win back inactive users via personalized DM nudges (PREMIUM).

• Trigger: user hasn't logged in for X days
• AI writes a DM referencing recent server events
• Frequency limit — no more than 1 DM per user per month

Emoji & Stickers

Manage server emoji and stickers from the dashboard — rename, delete, batch-upload. Backup the whole library to a single archive so you can re-add everything if Discord wipes it or you migrate to a new guild.

• Batch upload from ZIP — filenames become emoji names
• Rename and delete from the dashboard without context-clicking each one
• Backup library to archive; restore later with one click
• Required permissions: Manage Expressions

Branding

PREMIUM-only — replaces the bot's nickname, avatar and embed footer in this guild with your own branding. The «Powered by PULSORT» footer can be kept or replaced; everything else looks like a custom in-house bot.

• Per-guild bot nickname and avatar override
• Custom embed footer text (Powered-by line optional)
• Optional accent color applied to all module embeds
• PREMIUM-only feature

Custom Invite Links

Create branded short links like pulsort.gg/yourservername that redirect to a Discord invite. Clicks are tracked so you see which marketing channel actually brings people in.

• Custom slug: pulsort.gg/<your-slug> → Discord invite
• Click counter per link with daily breakdown
• Multiple links per server for A/B testing campaigns
• Active/disabled toggle so you can pause without deleting