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.
/setup
command · anyone
Shows a status overview of every module — which are enabled, which need configuration, and which are untouched. Good starting point after a fresh install.
/about
command · anyone
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 |
| /tempban <user> <duration> [reason] [days] | Temporary ban — auto-unbans after the duration (5m – 30d) | Mod |
| /unban <user_id> | Lift a ban by user ID — also clears any pending tempban auto-unban | Mod |
| /lock · /unlock | Lock or unlock a channel for @everyone | Mod |
| /purge <count> | Bulk-delete the last N messages | 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 |
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
Overview
page
Server landing page. Member count, recent activity, quick-action buttons, and module health at a glance.
Statistics
page
Graphs for message activity, member growth, joins and leaves, and top channels — filterable by time range.
Moderation
section
Warnings, member list, channels, roles, invites, bans, and audit log — all in one section.
Modules
section
Individual configuration pages for every module. Each has an Enable/Disable toggle at the top.
Giveaways
page
Active giveaways, create new ones, global settings, and history.
Server Settings
page
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).
Warning Threshold
number
Number of warnings before automatic action. Set to
0 to disable auto-escalation.Escalation Action
select
What happens when the threshold is hit: Timeout or Ban.
DM on Moderation
toggle
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, scam-domain blocking, level-gated content, and a configurable escalation ladder. Works 24/7 without moderator involvement.
🚨 Scam-Domain Blocking
always-on
Bundled list of 90+ curated phishing domains (fake nitro, Steam scams, crypto wallet drainers). Always blocked, even for bypass roles. Add your own per-server custom blacklist via Auto-Mod → Link Blocker → 🚨 Manage List.
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 enables slowmode 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. Tenor / Giphy auto-exempt (toggleable).
🎚️ Minimum Chat Level
number
Require members to reach a chat level before they can post links. Stops new accounts from posting URLs immediately. Set to
0 to disable.👥 Allowed Roles for Links
multi-select
Roles that bypass the level gate but are still scam-checked. Optional sub-toggle blocks them from posting Discord invites.
Mention Spam
toggle + threshold
Blocks messages that mention more than N users at once.
⚖️ Escalation Ladder
toggle + steps
Build a multi-step escalation path: warn → timeout → kick → tempban → ban. Each step has its own threshold and duration. Disabled by default — flip the new Enable escalation ladder toggle to activate.
Bypass roles configured in Auto-Mod skip every filter except scam-domain blocking — that always runs to protect your server, even from compromised staff accounts.
Pro: Smarter anti-raid with pattern detection, per-channel rule overrides, regex matching, and live external scam-list sync. Upgrade →
Module 02b
LEVEL GATES
Configure a minimum chat level for each content type. Configured under Leveling → 🚦 Level Gates. Default 0 = no enforcement, fully backward-compatible.
🖼️ Send images
number
Block image attachments and inline image URLs (.png, .jpg, .gif, .webp) below the configured level.
🎬 Send videos
number
Block video attachments (.mp4, .mov, .webm).
🔗 Send Discord invites
number
Block
discord.gg/... and discord.com/invite/... links.🌟 Send stickers
number
Block messages containing a sticker.
😀 Use external emojis
number
Block messages containing custom emojis from other servers.
👤 Mention users
number
Stops new accounts from pinging existing members.
📣 Use @everyone / @here
number
Block mass-mention pings.
Auto-Mod bypass roles also bypass level gates. When a level gate triggers, the message is deleted, the member receives a DM, and an auto-mod strike is recorded — feeding into the escalation ladder if you've enabled it.
Module 02c
TEMPORARY ROLES
Assign a role for a fixed duration that auto-removes when it expires. Configure per-member from the Members panel, or per-role default from the Roles page.
Per-Member Assignment
action
Members → click member → ⏱ Temp Role button → pick role + duration (1h / 6h / 24h / 3d / 7d / 30d). Useful for one-off cases like a "Hall of Shame" role.
Per-Role Default Duration
setting
Roles → click role → toggle ⏱ Temporary Role + pick duration → save. Every future assignment of this role auto-schedules its removal.
Scheduled Actions Page
page
View and cancel pending temp-role removals and tempban auto-unbans in one place.
Auto-Cleanup
automatic
Manually removing the role (or unbanning a tempbanned user) clears the pending schedule automatically — no orphan rows.
Schedules survive bot restarts. The 30-second tick batches Discord API calls to stay safely under rate limits, so a 1-minute tempban may take up to 30 seconds longer than the configured duration to actually fire.
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.
Verified Role
role
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.
XP Per Message
number
How much XP each message is worth. Has a built-in 60-second cooldown per user to prevent farming.
Voice XP
toggle + rate
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.
Level Roles
role map
Automatically assign roles when members reach specific levels. Add as many level/role pairs as needed.
No-XP Roles
role list
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.
Welcome Channel
channel
The channel where join and leave messages are posted.
Welcome Message
text
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.
DM on Join
toggle + text
Send a DM to the member when they join. Useful for rules, invite links, or onboarding info.
Auto-Assign Role
role
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.
Ticket Channel
channel
The channel containing the "Open a Ticket" button. Members click it to create a new ticket.
Support Roles
role list
Roles that can view and respond to all tickets.
Ticket Category
category
Discord category where ticket channels are created.
DM on Open
toggle
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:
Prize
text
The prize name and optional description shown in the giveaway embed.
Channel
channel
Where the giveaway embed is posted.
Duration
select / custom
Quick-select presets (1h → 14d) or a custom value. Giveaway ends at the exact scheduled time.
Winners
number
How many winners are drawn. All winners are announced in the giveaway embed when it ends.
Ping
select
@everyone, @here, a specific role, or nobody.Entry Requirements
Min Account Age
days
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.
Min Message Count
number
Member must have sent at least this many messages in the server.
Required Role
role
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.
Manager Roles
role list
Roles allowed to create and manage giveaways, even without Administrator permission.
Log Channel
channel
Where giveaway events (start, end, reroll) are posted.
Anti-Cheat Level
select
Off, Basic (block alt accounts), or Strict (also checks join patterns).Max Concurrent
number
Maximum number of giveaways running at the same time.
Entry Cooldown
duration
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.
Currency Name
text
What to call your currency in all embeds and messages (e.g.
coins, gems, tokens).Starting Balance
number
How many coins new members start with when they first interact with the economy.
Gambling
toggle
Enable or disable gambling commands (
/coinflip, /slots, etc.) for the server.Shop
item list
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.
Moderation Logs
channel
Bans, kicks, warns, timeouts — all moderation actions with actor, target, reason, and timestamp.
Message Logs
channel
Edited and deleted messages. Shows original content, channel, and the responsible member.
Member Logs
channel
Join, leave, nickname changes, role changes — member lifecycle events.
Voice Logs
channel
Voice channel joins, leaves, mutes, deafens, and server-moves.
Server Logs
channel
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.
Track All Invites
toggle
HELIX Guard caches all invite codes on startup and tracks uses in real time.
Per-Invite Limits
number
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.
Upgrade
HELIX PRO
HELIX Pro unlocks additional capabilities for your server. Plans: 1 month $4.99 · 3 months $12.99 · 6 months $24.99 · 12 months $44.99 · Lifetime $89.99 — all plans include every Pro feature.
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.
Custom Embeds
appearance
Branded embed colors and thumbnail overrides on bot messages.
Unlimited Log Channels
logging feature
Route every event type to its own dedicated channel.
Priority Support
support
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.