System Documentation & Engineering Manual

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.

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

Webhook Endpoint Configuration

https://api.vaztinix.dev/api/webhooks/topgg

Multiplier & Streak Formula

Nora calculates voter rewards using a dynamic multiplier matrix:

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 verify group_id:12345678 verified_role:@Member unverified_role:@Unverified

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.

Enterprise support ticket workflow with interactive embeds, intake modal forms, transcript archives, activity analytics, and historical export:

• 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.

Shield your server with sub-4ms gateway regex filtering, phishing domain detection, automated escalation, and Wick-style Anti-Nuke Staff Quarantine:

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.

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

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)).

Channel-Based Guess the Number Game

Dedicated channel-based number guessing engine with real-time emoji hints. Configurable range from 0 up to 100,000 with customizable guess limits (defaults to 6, bounded by range). Always restarts automatically upon win or expiration:

• ⏫ (Higher): Secret number is higher than your guess.
• ⏬ (Lower): Secret number is lower than your guess.
• ✅ (Winner): Correct! Awards XP, congratulates the winner, chooses a new number, and restarts.
• ❌ (Expired): Out of guesses! Reveals the answer, selects a fresh number, and restarts.

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:

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.

Configuration

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

8b. In-Site Security Pass & Zero-Trust Verification

For high-security communities, Nora provides an In-Site Security Pass operating under an advanced zero-trust gatekeeper model to definitively stop automated raid scripts, ban evasion syndicates, and malicious proxy networks across all communities:

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):

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

Nora Studio features a next-generation Embeds V2 (Discord Components V2) engine enabled by default across all servers, paired with collaborative Saved Webhooks and automatic Staff-Sponsored Server Premium:

• Embeds V2 Default + Per-Module V1/V2 Selector: Every server module that dispatches embeds (Welcomer, Leveling, Starboard, Tickets, AutoMod, Verification, Top.gg Votes, and Webhook Builder) defaults to Embeds V2 (Components V2 Containers) and includes an instant selector to toggle between Embeds V2 and Classic Embeds V1.
• Saved Webhooks (3 Free / 10 Premium Presets): Server staff with Manage Guild or Administrator permissions can save named webhook presets accessible by all fellow staff in that server.
• Staff-Sponsored Server Premium Inheritance: As long as one staff member in a server holds Nora Studio Plus (Premium) or Team access, the entire server dashboard unlocks Premium status (10 Saved Webhooks & Pro modules) for all staff members in that server, displaying a header credit badge honoring the sponsoring member(s). If all sponsoring staff leave the server or lose Premium access, the server cleanly reverts to the Free tier (3 Saved Webhooks).
• Dual Image Uploader + URL & Modern Hex Swatch: Every image, thumbnail, avatar, and banner field across the dashboard provides both a direct URL input and a 1-click file uploader, alongside interactive hex color swatches with preset palettes.

Sticky Messages & Persistent Notices (/sticky)

Keep guidelines, rules, or announcements pinned to the bottom of active channels. Nora automatically tracks message count, deletes the prior sticky message, and reposts it according to your configured message frequency, fully supporting modern Components V2 containers:

• /sticky set <channel> <message> [frequency] [embed_title] [embed_description]: Deploy or update a sticky message.
• /sticky remove <channel>: Deactivate and remove a channel's sticky message.
• /sticky list: Display all active sticky messages and repost frequencies across the server.

Discord enforces a hard ceiling of 2,500 guilds per WebSocket shard. Nora's Dynamic Sharding Engine (src/utils/shardManager.js & src/shard.js) proactively separates and balances clusters well before reaching 2,500 servers based on four real-time telemetry factors, viewable live at vaztinix.dev/status:

The Nora Studio Web Dashboard combines hardware-accelerated announcement animations with per-user visual customization:

• Per-User Custom Dashboard Background (Images & Animated GIFs): Any logged-in user can upload an image or animated GIF (or paste a direct URL) in Profile or Settings. Static images open in the interactive 16:9 Widescreen Auto-Cropper (similar to Rank Cards), while animated GIFs can be applied with full looping preservation alongside customizable Dim Opacity (20%–92%) and Glass Blur (0px–24px) sliders.
• Announcement-Inspired Save Data Draft Bar: Whenever server settings are modified, Nora displays an announcement-style floating draft notification with a pulsing status dot, word-animated summary, collapsible Old → New diff inspector, and 1-click Save Data or Discard controls.
• Clickable Breadcrumb Navigation & Searchable Comboboxes: Every breadcrumb segment in the top bar (Server / Category / Section) is interactive, and all channel, role, and preset selectors feature instant search filtering.

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

{
  "status": "operational",
  "version": "3.5.0",
  "pingMs": 18,
  "serverCount": 99,
  "userCount": 42500,
  "shardingSummary": {
    "mode": "Dynamic Multi-Factor Pre-2500 Safe Balancer",
    "totalShards": 1,
    "recommendedShards": 1,
    "overallState": "OPTIMAL",
    "averageHealthScore": 98,
    "limits": {
      "DISCORD_HARD_MAX_GUILDS": 2500,
      "SAFE_HARD_MAX_GUILDS": 2200,
      "SOFT_SPLIT_GUILDS": 1800
    }
  },
  "shards": [
    {
      "id": 0,
      "status": "ONLINE",
      "ping": 18,
      "guilds": 99,
      "maxSafeGuilds": 2200,
      "discordMaxGuilds": 2500,
      "guildCapacityPct": 4.5,
      "healthScore": 98,
      "separationState": "OPTIMAL"
    }
  ]
}