01 — Introduction
HELIX GUARD
DOCUMENTATION
Everything you need to configure, manage, and get the most out of HELIX Guard. Use the sidebar to jump to any module or command reference.
ℹ
All module settings are managed through the
dashboard. Most settings take effect immediately after saving — no bot restart needed.
Quick Setup
After adding HELIX Guard to your server, use /setup to see which modules are configured and which still need attention. The command gives you a live overview of every module's status with links to the relevant dashboard pages.
Shows a status overview of every module — which are enabled, which need configuration, and which are untouched. Good starting point after a fresh install.
Displays HELIX Guard info: live server count, member count, ping, module list, and links to the dashboard and server browser.
/botstats
command · anyone
Shows bot uptime, latency, memory usage, guild count, and version information.
02 — Reference
ALL COMMANDS
Every slash command available in HELIX Guard. Permission levels: Admin requires Administrator or Manage Server, Mod requires Kick/Ban Members, All is usable by everyone.
General
| Command | Description | Perm |
|---|
| /about | Bot info, stats, and links | All |
| /botstats | Bot uptime, latency, memory | All |
| /setup | Module status overview | All |
| /pro | View Pro features and pricing | All |
| /avatar [user] | Display a user's avatar | All |
| /serverinfo | Server details and stats | All |
| /roleinfo [role] | Role details, color, permissions | All |
| /poll | Create a quick yes/no poll or multi-option poll | All |
| /remind | Set a personal reminder | All |
Moderation
| Command | Description | Perm |
|---|
| /ban <user> [reason] [days] | Ban a member and optionally delete recent messages | Mod |
| /kick <user> [reason] | Kick a member from the server | Mod |
| /warn <user> <reason> | Issue a warning — escalates based on warning thresholds | Mod |
| /warnings <user> | List all warnings for a user | Mod |
| /clearwarnings <user> | Remove all warnings from a user | Admin |
| /timeout <user> <duration> [reason] | Mute a member for 1 minute to 1 week | Mod |
| /unban <user_id> | Lift a ban by user ID | Mod |
Leveling
| Command | Description | Perm |
|---|
| /rank [user] | View XP level, progress bar, and server rank | All |
| /leaderboard | Top members by XP for this server | All |
| /setxp <user> <amount> | Manually set a member's XP total | Admin |
| /resetxp <user> | Reset a member's XP and level to zero | Admin |
Server Browser
| Command | Description | Perm |
|---|
| /bump | Push your server to the top of the browser (2h cooldown, 1h Pro) | Admin |
| /vote [server_id] | Vote for this server or a specific server (12h cooldown) | All |
| /listing view | View your server's listing stats: votes, bumps, visibility | All |
| /listing hide | Hide your server from the browser | Admin |
| /listing show | Make your server public in the browser | Admin |
| /servers | Browse listed servers directly from Discord | All |
03 — Dashboard
DASHBOARD
The web dashboard at helixguard.app/dashboard is the primary way to configure HELIX Guard. Every module, setting, and data table is accessible from one place.
⚠
Every module page has a Save Settings button. Toggling a setting without saving will not take effect. A yellow Unsaved changes indicator appears whenever there are pending changes.
Navigation
Server landing page. Member count, recent activity, quick-action buttons, and module health at a glance.
Graphs for message activity, member growth, joins and leaves, and top channels — filterable by time range.
Warnings, member list, channels, roles, invites, bans, and audit log — all in one section.
Individual configuration pages for every module. Each has an Enable/Disable toggle at the top.
Active giveaways, create new ones, global settings, and history.
Server locale and timezone used in all embeds and timestamps.
Module 01
MODERATION
Full moderation toolkit built on Discord.js v14. Every action is rank-checked, DM-notified where applicable, and written to the audit log automatically.
Warning Escalation
Configure thresholds in the dashboard under Moderation → Auto-Moderation. When a member's warning count hits a threshold, HELIX Guard automatically applies the configured action (timeout or ban).
Number of warnings before automatic action. Set to 0 to disable auto-escalation.
What happens when the threshold is hit: Timeout or Ban.
Whether the bot DMs the member with the reason and action details when they are moderated.
ℹ
Rank-check enforcement is always active — the bot and the moderator must both outrank the target member. This cannot be disabled.
Module 02
AUTO-MODERATION
Automated content filtering and raid protection. Configure thresholds, filters, and responses without needing to be online 24/7.
Spam Filter
toggle + threshold
Rate-limits members sending rapid messages. Configure the message count and time window before action is taken.
Anti-Raid
toggle + threshold
Detects join spikes and locks the server automatically. Set the joins-per-minute threshold to trigger lockdown.
Profanity Filter
toggle + word list
Blocks messages containing configured words or phrases. Supports wildcards. Messages are deleted and the member is warned.
Link Filter
toggle + whitelist
Removes or warns on external URLs. Add domains to the whitelist to allow specific links.
Auto-Timeout
toggle + duration
Automatically times out members who trigger filters. Set the timeout duration (1 minute to 1 week).
Number of auto-mod strikes before escalating to a timeout or ban.
★
Pro: Advanced filters, smarter anti-raid with pattern detection, and per-channel rule overrides.
Upgrade →
Module 03
VERIFICATION
Require new members to complete a step before accessing the rest of the server. Reduces bot joins and spam accounts.
Verification Channel
channel
The channel where new members see the verification prompt. Restrict all other channels until they verify.
The role granted on successful verification. Use this role to unlock the rest of your server.
Verification Method
select
How members verify: Button (one click), CAPTCHA (image challenge), or Reaction (add an emoji).
Module 04
LEVELING
XP-based leveling system to reward active members. Members earn XP by sending messages and spending time in voice channels.
How much XP each message is worth. Has a built-in 60-second cooldown per user to prevent farming.
Award XP for time spent in voice channels. Set the XP rate per minute. Members must not be muted/deafened.
Level-Up Announcements
toggle + channel
Post a message when a member levels up. Choose a dedicated channel or post in the channel where they sent their last message.
Automatically assign roles when members reach specific levels. Add as many level/role pairs as needed.
Members with any of these roles will not earn XP. Useful for bots, muted members, etc.
No-XP Channels
channel list
Messages sent in these channels will not award XP.
★
Pro: Full leaderboard history, XP multiplier roles, and export to CSV.
Upgrade →
Module 05
WELCOME MESSAGES
Post a message to a channel (and optionally a DM) when someone joins or leaves the server.
The channel where join and leave messages are posted.
Message sent when a member joins. Supports variables: {user} {server} {membercount}.
Leave Message
toggle + text
Enable to also post a message when a member leaves. Supports the same variables as the welcome message.
Send a DM to the member when they join. Useful for rules, invite links, or onboarding info.
Automatically give a role to every new member on join.
Module 06
TICKETS
Private support tickets that members can open with your staff team. Each ticket gets its own channel, visible only to the member and your support roles.
The channel containing the "Open a Ticket" button. Members click it to create a new ticket.
Roles that can view and respond to all tickets.
Discord category where ticket channels are created.
Notify the member via DM when their ticket channel has been created.
Auto-Close
toggle + duration
Automatically close tickets after a period of inactivity. Set the inactivity timeout (e.g. 24h, 48h, 7d).
Transcripts
toggle + channel
Save a full message transcript when a ticket is closed. Sent to the configured transcript channel.
Module 07
GIVEAWAYS
Run fully customizable giveaways. Set requirements, bonus entries, appearance, and advanced options from the dashboard.
Creating a Giveaway
Go to Giveaways → Create in the dashboard. The following options are available:
The prize name and optional description shown in the giveaway embed.
Where the giveaway embed is posted.
Quick-select presets (1h → 14d) or a custom value. Giveaway ends at the exact scheduled time.
How many winners are drawn. All winners are announced in the giveaway embed when it ends.
@everyone, @here, a specific role, or nobody.
Entry Requirements
Discord account must be at least this many days old to enter.
Min Server Membership
days
Member must have been in the server for at least this many days.
Member must have sent at least this many messages in the server.
Only members with this role can enter.
Blacklisted Roles
role list
Members with any of these roles cannot enter.
Bonus Entries
role → entries map
Give extra entries to members with specific roles. E.g., Booster → +2 entries.
Global Settings
Giveaways → Settings applies defaults to all giveaways on your server.
Roles allowed to create and manage giveaways, even without Administrator permission.
Where giveaway events (start, end, reroll) are posted.
Off, Basic (block alt accounts), or Strict (also checks join patterns).
Maximum number of giveaways running at the same time.
Minimum time between a member's giveaway entries.
Module 08
ECONOMY
Virtual currency system for your community. Members earn, spend, and trade currency through commands and activities.
What to call your currency in all embeds and messages (e.g. coins, gems, tokens).
How many coins new members start with when they first interact with the economy.
Enable or disable gambling commands (/coinflip, /slots, etc.) for the server.
Create custom shop items — role rewards, custom prizes, or cosmetics. Set price, description, and stock limit per item.
Module 09
LOGGING
Route server events to dedicated log channels. Every event type can be toggled individually and sent to its own channel.
Bans, kicks, warns, timeouts — all moderation actions with actor, target, reason, and timestamp.
Edited and deleted messages. Shows original content, channel, and the responsible member.
Join, leave, nickname changes, role changes — member lifecycle events.
Voice channel joins, leaves, mutes, deafens, and server-moves.
Channel creation/deletion, role changes, server setting updates, emoji changes.
★
Pro: Unlimited individual log channels — route every event type to its own dedicated channel.
Upgrade →
Module 10
INVITE TRACKING
Detailed per-invite usage stats. See which invite code brought in the most members, track individual join events, and set entry limits per invite.
HELIX Guard caches all invite codes on startup and tracks uses in real time.
Cap how many members can join through a specific invite link. Useful for controlled-growth communities.
Invite Log Channel
channel
Post a message every time a member joins, showing which invite they used and who created it.
All invite stats are visible in the dashboard under Moderation → Invites. You can see total uses, remaining uses, creator, expiry, and the full join history per code.
Feature
SERVER BROWSER
A public directory of Discord servers using HELIX Guard. Members can discover, vote for, and join servers directly from helixguard.app/servers.
Setting Up Your Listing
Go to Dashboard → Configuration → Server Listing. Fill in your server's name, description, category, tags, language, and icon. Once you save and set the listing to public, your server appears in the browser.
Display name shown in the browser. Defaults to your Discord server name.
Short description (shown in cards) and a long description (shown on the server's detail page).
Primary category for your server (e.g. Gaming, Community, Art, Tech).
Up to 5 tags for filtering and discovery.
Primary language of your server community.
The Discord invite URL shown on your server's detail page.
Server Browser
BUMP SYSTEM
Bumping pushes your server to the top of the browser. Servers with recent bumps rank higher and get more visibility.
ℹ
Only members with Manage Server permission can bump. Use /bump in any channel.
Standard bump cooldown. After using /bump, you must wait 2 hours before bumping again.
HELIX Pro servers get a reduced 1-hour bump cooldown — twice as many bumps per day.
Server Browser
VOTES
Any member can vote for a server once every 12 hours. Monthly vote count is reset on the 1st of each month and factors into browser ranking.
Vote for the current server or specify a server ID to vote for a different one. 12-hour cooldown per user per server.
Votes this calendar month. Resets on the 1st. Used to rank servers in the default browser sort.
Cumulative all-time vote count. Displayed on the server's detail page.
Upgrade
HELIX PRO
HELIX Pro unlocks additional capabilities for your server. Starting at $4.99/month — cancel anytime.
Bump Cooldown
1h instead of 2h
Bump your server twice as often — stay at the top of the browser longer.
Priority Placement
browser feature
Pro servers appear above non-Pro servers with equal bump scores in the browser.
Advanced Auto-Mod
module feature
Extra content filters, smarter anti-raid with pattern detection, and per-channel rule overrides.
Extended Leaderboards
leveling feature
Full XP leaderboard history and CSV export.
Branded embed colors and thumbnail overrides on bot messages.
Unlimited Log Channels
logging feature
Route every event type to its own dedicated channel.
Faster response times and access to the Pro support channel.
★
View full pricing and upgrade at
helixguard.app/pro. Use
/pro in Discord for a quick overview.