System Documentation & Command Guide
Complete technical reference for Nora Studio's automation, Top.gg multi-bot tracking, Roblox rank synchronization, ticket management, leveling, games, and security systems.
Quickstart Guide
Get Nora operating in your Discord server in less than 60 seconds:
- Step 1 — Authorize Application: Visit /install and select your target Discord server with standard administrator privileges.
- Step 2 — Interactive Setup: Run
/setup dashboardin any channel to view and configure community modules directly in Discord. - Step 3 — Web Dashboard: Access vaztinix.dev/dashboard to manage Top.gg votes, Roblox group rank bindings, tickets, custom embeds, and audit logs.
Top.gg Vote Rewards & Multi-Bot Tracker
Reward your community members for upvoting Nora and custom connected bots on Top.gg with instant role assignments, customizable Leveling XP, weekend multipliers, and loyalty vote streaks.
Sub-Second Webhook & Resilient Channel Pipeline
Votes cast on Top.gg are dispatched directly to Nora's high-performance endpoint with sub-second latency. If announcement channels restrict standard bot messaging, Nora automatically utilizes secure channel webhooks to guarantee embed delivery.
Step-by-Step Setup Guide
Open the Nora Dashboard and navigate to the Top.gg Votes tab. Under 1. Connect on Top.gg, copy the unified Webhook URL: https://api.vaztinix.dev/api/webhooks/topgg.
Log in to top.gg → Open your Bot Dashboard → Webhooks → Paste your Webhook URL into Top.gg. Copy the generated whs_... secret from Top.gg and paste it into Nora Dashboard's Webhook Authorization Secret field, then click Save Data.
If your server hosts or uses multiple bots, scroll to Multi-Bot Tracker in the dashboard and click + Track Another Bot. Enter the numeric Bot ID, display name, and avatar URL. Nora will listen for votes on all configured bots under a single webhook endpoint!
Select your Discord Voter Role, base Leveling XP (e.g. 150 XP), and Vote Announcement Channel. Enable 12-Hour Vote Reminders so voters get private DM alerts the moment their vote cooldown expires to keep their streak alive.
Role Hierarchy Notice
Ensure the @Nora role is placed HIGHER than the Voter reward role in Discord Server Settings → Roles so Nora can grant the role without permission conflicts.
Reward Multipliers & Streak Mechanics
Nora dynamically computes voter rewards based on voting frequency and weekend events:
| Reward Factor | Multiplier / Bonus | Calculation Rules |
|---|---|---|
| Base XP Reward | 150 XP (Configurable) |
Standard baseline XP awarded for every verified upvote. |
| ⭐ Weekend Multiplier | 2x Multiplier |
Automatically active Friday 00:00 UTC through Sunday 23:59 UTC to match Top.gg double vote weekends. |
| 🔥 Vote Streak Loyalty | +25 XP per streak count |
Increases by 1 for each consecutive vote cast within a rolling 36-hour window. |
| Formula | (Base + Streak Bonus) × Multiplier |
Example: 150 Base + (3 streak × 25) = 225 XP × 2x Weekend = 450 Total XP! |
Announcement Message Placeholders & Variables
Customize your announcement templates with dynamic placeholder tags:
| Placeholder Tag | Description | Example Output |
|---|---|---|
{user} / {userMention} |
Mentions the Discord voter. | @Vaztinix |
{username} |
Voter's clean username (without ping). | Vaztinix |
{userTag} |
Voter tag with discriminator. | Vaztinix#0000 |
{server} / {serverName} |
Name of the Discord server receiving the vote. | Nora's Hub |
{channel} |
Mentions the vote announcement channel. | #votes |
{bot} |
Name of the bot that received the upvote. | Nora Assistant |
{streak} |
Current consecutive vote streak count. | 4 |
{multiplier} |
Active multiplier badge text. | ⭐ 2x Weekend or ⚡ 1x Standard |
{xp} |
Amount of Leveling XP awarded. | 300 |
{rewards} |
Summary of granted roles and XP. | Role Assigned • +300 XP |
{role} |
Mentions the configured Voter Role. | @Voter |
Announcement Presets
Thank you {user} for upvoting {bot}! You gained {rewards}.
🔥 {user} is on a {streak}x streak upvoting {bot}! Rewards: {rewards}.
🎉 Upvote confirmed! {user} received {rewards} with {multiplier} in {server}.
⚡ Upvote received from {user}! (+{xp} XP)
Leveling & XP Progression Engine
Drive daily chat engagement with custom leveling rank cards, voice channel XP accrual, and milestone role rewards:
- Chat & Voice XP: Earn 15–25 XP per message (with anti-spam rate limiting) and background voice XP every 5 minutes in unmuted voice channels.
- Role Rewards with Stacking: Automatically grant cosmetic or privilege roles at specific level milestones (e.g. Level 5, 10, 25, 50, 100), with optional role stacking.
- Custom Rank Cards: Personalize rank cards with custom accent colors, background themes, and progress bars via
/rank. - Leaderboards: View global and server level leaderboards using
/leaderboard.
Automated Roblox Group Rank Sync v2.6
Seamlessly bind your Roblox group hierarchy to Discord server roles:
- Group Binding: Bind numeric Roblox Group IDs to Discord roles in the dashboard or via
/setup verify. - Automated Role Mapping: Map group ranks (Guest, Member, Officer, Developer, Owner) to distinct Discord roles.
- Bio & Direct OAuth Verification: Members verify in seconds via secure code verification or web link.
- Unverified Role Protection: Automatically assign an Unverified role to newcomers and remove it upon verification.
Support Ticketing & Mod-Mail Engine
Professional ticket management for inquiries, reports, appeals, and staff support:
- Interactive Panel: Deploy persistent ticket panels with customizable buttons (Support, Reporting, Appeals, Custom).
- Modal Intake Forms: Collect user issue details upfront using custom pop-up modal questionnaires.
- Ticket Claiming & Transcripts: Staff can claim tickets, add collaborators, and automatically archive formatted HTML transcripts to an audit log channel.
Reaction Roles & Custom Autoresponders
Empower members with self-assignable roles and automate repetitive answers:
- Reaction Roles v2.0: Create embed-based role menus with button or dropdown selection, supporting single-select (exclusive) or multi-select modes.
- Autoresponders v2.1: Configure keyword or regex triggers with rich embed replies, role/channel whitelists, and ignore-staff protections. Up to 200 custom triggers for Premium servers.
Native Discord AutoMod & Chat Defense v2.5
Protect your server with sub-4ms native gateway filtering and automated action escalation:
- Phishing & Malicious Link Blocker: Instantly detects and purges fake Nitro links and scam domains.
- Anti-Spam & Mass Mention Shield: Stops duplicate message flooding, mention spam, discord invite leaks, and zalgo text.
- Warning Escalation Rules: Set automated punishment thresholds (e.g. 3 warns → 1-hour mute, 5 warns → tempban).
- Quarantine System: Isolate suspicious raiding accounts into a sandboxed channel with restricted permissions.
Entertainment, Counting & Starboard v3.0
Keep your community lively and reward creativity:
- Collaborative Math Counting: Sequential counting supporting math expressions (
50+50,10^2) with strict anti-double-count checks and streak records. - One-Word Story: Collaborative storytelling channel where members build stories one word at a time.
- Rock Paper Scissors & Guess Game: Wager XP in interactive mini-games against Nora or friends.
- Tiered Starboard v3.0: Pins top community messages with progressive visual flares (Bronze → Golden → Radiant → Supernova → Cosmic Mythic).
Essential Command Catalog
| Command | Category | Description |
|---|---|---|
/setup topgg |
Integrations | Interactive Discord wizard to configure Top.gg vote rewards, voter roles, and webhooks. |
/vote |
Community | Display server Top.gg voting link, voter streak, and weekend multiplier status. |
/setup dashboard |
Setup | Open interactive server management and dashboard link. |
/rank [@user] |
Leveling | Inspect member Level, Total XP, progress bar, and leaderboard standing. |
/leaderboard |
Leveling | Display server top-ranked members in chat. |
/verify check |
Utility | Verify account binding and synchronize Roblox group roles. |
/ticket |
Support | Open private staff inquiry ticket with auto-transcript logging. |
/counting stats |
Games | View current count, record streak, and top contributors. |
/starboard stats |
Games | Inspect starboard threshold, star count, and top starred posts. |
/afk [reason] |
Utility | Set AFK status with mention notices and automated nickname prefix. |
/purge [count] |
Moderation | Bulk clean recent messages with audit log tracking. |
/warn [@user] [reason] |
Moderation | Issue official rule violation warning with escalation rules. |