Technical Reference v3.2

System Documentation & Engineering Manual

Comprehensive operational documentation for Nora Studio: Next-Gen Roblox group synchronization, multi-bot Top.gg vote pipelines, sub-4ms AutoMod gateway defense, Starboard v3.0, and leveling progression.

1. Quickstart Setup Guide

Deploy Nora to your Discord community and configure your essential modules in less than 60 seconds:

  1. Authorize Application: Navigate to /install and choose your Discord server. Ensure the bot role is positioned high in role hierarchy.
  2. Interactive Setup in Discord: Run /setup dashboard in any moderator channel to open instant configuration links and role selectors.
  3. Connect Web Dashboard: Visit vaztinix.dev/dashboard to manage Top.gg webhook secrets, Roblox Group ID bindings, custom embeds, and audit logs.
Role Hierarchy Rule: Always place the @Nora role higher than voter reward roles, verified group roles, and muted roles in Discord Server Settings → Roles.

2. Top.gg Vote Rewards & Multi-Bot Tracker

Reward your community members for supporting Nora and any linked custom bots on Top.gg with automatic role awards, customizable Leveling XP, weekend multipliers, and loyalty vote streaks.

Sub-Second Webhook Pipeline: Upvotes are received in real-time via Nora's secure webhook endpoint. If normal bot channel permissions are restricted, Nora falls back to channel webhooks to guarantee delivery.

Webhook Endpoint Configuration

Unified Top.gg Webhook URL
https://api.vaztinix.dev/api/webhooks/topgg

Multiplier & Streak Formula

Nora calculates voter rewards using a dynamic multiplier matrix:

Factor Bonus Rate Rules & Scheduling
Base XP 150 XP Configurable baseline XP awarded on every verified upvote.
⭐ Weekend 2x 2.0x Multiplier Automatically active Friday 00:00 UTC through Sunday 23:59 UTC.
🔥 Streak Loyalty +25 XP / count Increments on consecutive votes cast within a rolling 36-hour window.
Formula Total XP = (Base XP + [Streak × 25]) × WeekendMultiplier

3. Automated Roblox Group Rank Sync v2.6

Link your Roblox group hierarchy directly to Discord server roles with bi-directional real-time verification:

  • Group Rank Mapping: Bind any numeric Roblox Group ID to Discord roles (Guests, Members, Officers, Developers, Owners).
  • 4-Way Verification: Direct OAuth2, In-Game Code, Bio Keyword verification, and automated nickname sync.
  • Unverified Quarantine: Automatically assign an Unverified role to newcomers to prevent raid attempts until verified.
Setup Command
/setup verify group_id:12345678 verified_role:@Member unverified_role:@Unverified

4. Leveling & XP Progression Engine

Drive active community interaction with custom leveling rank cards, voice XP rewards, and milestone role unlocks:

  • Chat & Voice XP: Earn 15–25 XP per message with anti-spam cooldowns, plus voice XP every 5 minutes in unmuted channels.
  • Milestone Roles: Grant privilege or cosmetic roles at Level 5, 10, 25, 50, and 100 with optional role stacking.
  • Rank Cards: Users can inspect their progress with /rank or customize their card themes in /rank edit.

5. Support Ticketing & Mod-Mail Engine

Enterprise support ticket workflow with interactive embeds, intake modal forms, and transcript archives:

  • Interactive Panel: Deploy persistent panels with custom buttons (Support, Reports, Appeals, VIP Inquiry).
  • Modal Intake Forms: Collect issue summaries, evidence links, and usernames upfront via pop-up modals.
  • HTML Transcript Archive: Automatically generate and post rich HTML transcripts to your staff log channel when closed.

6. AutoMod & Native Chat Defense Shield

Shield your server with sub-4ms gateway regex filtering, phishing domain detection, and automated escalation:

Defense Module Detection Method Default Action
Anti-Phishing Real-time blacklist & Levenshtein domain matching Instant delete + 24hr Quarantine Timeout
Anti-Spam Rate-limit bucket (5 messages / 3 seconds) Warn + Delete Flood
Anti-Invite Discord invite regex pattern matching Delete message + Warning log
Mass Mention Mention threshold detector (> 4 mentions) Mute 10 minutes + Staff Alert

Internal Verification Network (IVN)

To defend against unauthorized privilege escalation, state tampering, and internal telemetry probing, Nora operates an autonomous Internal Verification Network (IVN) layer. All administrative operations, privileged diagnostics, and deep core interactions require verified identity authentication from certified Nora Studio team personnel.

Core Isolation & Heuristic Shield: Unauthenticated, masked, or anomalous requests attempting to manipulate internal state or extract sensitive runtime parameters are automatically detected, intercepted, and neutralized at the perimeter before reaching internal application logic. Security events are captured for active risk intelligence to ensure community and infrastructure protection.

7. Games & Tiered Starboard v3.0

Pin outstanding community highlights with dynamic tiered visual flares and reward collaborative engagement:

🥉 Bronze Star 3+ Stars

Standard highlight post pinned to the starboard channel.

🥈 Silver Radiant 7+ Stars

Silver radiant badge with author XP bonus.

🥇 Golden Cosmic 15+ Stars

Gilded golden embed with glowing visual flare & community broadcast.

Math Counting Game

Sequential collaborative counting channel with strict anti-double-count checks and full math expression evaluation (e.g. 10^2, 50*2, sqrt(144)).

8. Verification Gatekeeper & Threat Shield

Protect your server from alt raids, spam syndicates, and ban evaders before they gain access. Nora's Verification Gatekeeper analyzes incoming members during verification with multi-vector security checks:

Security Vector Screening Mechanism Risk Impact
Discord Official Spammer Flag Queries Discord API UserFlags.Spammer bitwise mask Immediate high risk (+50 pts) & auto-quarantine
Scam & Phishing Lure Intel Regex scans username and bio for Nitro lures, Steam scams, and malicious domains Severe risk (+40 pts) & keyword match logging
Ban Evasion Registry Scan Cross-references server ban lists for handle collisions and identical avatar hash matches High risk (+45 pts) with original banned user ID match
Account Freshness & Age Evaluates Discord account creation timestamp against configurable day threshold Flagged if under minimum age (e.g., < 3–7 days old)

Automated Enforcement & Staff Review Dossier

When an account is flagged with a Risk Score ≥ 40, Nora halts verification role assignment and executes the configured guild action:

  • Deny (Default): Keeps user restricted with Unverified Quarantine role and blocks access.
  • Kick: Automatically kicks high-risk accounts with a DM notification explaining security reasons.
  • Ban: Automatically issues a server ban for confirmed evasions or malicious threats.
Staff Review Buttons: Nora posts a real-time Dossier embed to your configured Mod Log channel with three 1-click interactive buttons:
• 🔨 Ban User: Instantly bans the account with audit trail.
• 👢 Kick User: Removes the account from the guild.
• 🛡️ Override & Approve: Bypasses security flags, strips quarantine roles, and grants verified access immediately.

Configuration

Control the Gatekeeper directly in Discord via /setup security or via the Web Dashboard at vaztinix.dev/dashboard under Verification → Security & Threat Gatekeeper.

9. Global Timezone & Creator Operations Suite

Coordinate seamlessly across international gaming guilds and developer teams. Nora includes a first-class global timezone engine and direct connection to Creator Vaztinix in Moscow, Russia (MSK / UTC+3):

🇷🇺 /time vaz Creator Clock

Displays the live Moscow clock (MSK / UTC+3) for developer Vaztinix, current date, and schedule status.

🔄 /time convert Bi-Directional

Converts any time from your local timezone (e.g. EST, PST, UTC, GMT, JST) directly to Moscow MSK.

🌐 /time world Global Matrix

Side-by-side snapshot of 9 major global tech & gaming time hubs with UTC offsets and current clocks.

About Developer Vaztinix: Vaztinix is a Russian creator based in Moscow, Russia who studies lots of English :3. The /time vaz and AI timezone commands make it effortless for community members and staff worldwide to know if it's day or night for Vaz.

10. Essential Command Reference Catalog

Click any command below to copy its syntax directly to your clipboard:

Command Category Required Permission Description
/setup security Setup Manage Guild Configures Verification Threat Gatekeeper, security checks, and online scan.
/time vaz Utility Everyone Displays live Moscow clock (MSK / UTC+3) for Creator Vaztinix and bio :3.
/time convert Utility Everyone Converts any time/timezone to Moscow Standard Time (MSK / UTC+3).
/time world Utility Everyone Displays global time matrix across UTC, MSK, EST, CST, PST, GMT, CET, JST, AEST.
/setup dashboard Setup Administrator Launches the interactive server control center & dashboard link.
/setup topgg Integrations Manage Guild Configures Top.gg voter role, reward XP, and webhook channel.
/vote Community Everyone Displays voting links, current voter streak, and weekend multiplier status.
/rank [@user] Leveling Everyone Inspects member level, total XP, current progress bar, and standing.
/leaderboard Leveling Everyone Displays server top 10 most active members by XP and Level.
/verify check Roblox Everyone Forces immediate synchronization of Roblox group roles and badges.
/ticket Support Everyone Opens a private staff inquiry channel with modal questionnaire.
/purge [count] Moderation Manage Messages Bulk purges recent messages with formatted audit log entries.
/warn [@user] [reason] Moderation Moderate Members Issues an official rule violation warning with automatic punishment escalation.
/counting stats Games Everyone Inspects current count, high-score streak, and top server contributors.

11. REST API & Webhook Specifications

Integrate your external dashboards and custom Discord applications with Nora's official HTTP telemetry:

GET /api/status/public
{
  "status": "operational",
  "version": "3.2.0",
  "pingMs": 18,
  "serverCount": 65,
  "userCount": 42500,
  "shards": [
    { "id": 0, "status": "ready", "ping": 18 }
  ]
}