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:
- Authorize Application: Navigate to /install and choose your Discord server. Ensure the bot role is positioned high in role hierarchy.
- Interactive Setup in Discord: Run
/setup dashboardin any moderator channel to open instant configuration links and role selectors. - Connect Web Dashboard: Visit vaztinix.dev/dashboard to manage Top.gg webhook secrets, Roblox Group ID bindings, custom embeds, and audit logs.
@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.
Webhook Endpoint Configuration
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 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
/rankor 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.
7. Games & Tiered Starboard v3.0
Pin outstanding community highlights with dynamic tiered visual flares and reward collaborative engagement:
Standard highlight post pinned to the starboard channel.
Silver radiant badge with author XP bonus.
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.
• 🔨 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):
Displays the live Moscow clock (MSK / UTC+3) for developer Vaztinix, current date, and schedule status.
Converts any time from your local timezone (e.g. EST, PST, UTC, GMT, JST) directly to Moscow MSK.
Side-by-side snapshot of 9 major global tech & gaming time hubs with UTC offsets and current clocks.
/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:
{
"status": "operational",
"version": "3.2.0",
"pingMs": 18,
"serverCount": 65,
"userCount": 42500,
"shards": [
{ "id": 0, "status": "ready", "ping": 18 }
]
}