๐ซ Unauthorized: Token invalid or expired. Enter a valid admin token to load analytics & design data.
๐ Analytics Filters:
User Access Editor
Super Admin only. Edit canonical role and subscription fields through constrained controls so access changes stay aligned with the normalized profile model.
Select a user to inspect and edit access settings.
Secondary Roles
Institution and org owner access automatically retains creator plus end_user capability.
๐ฐ Payments (Last 30 Days)
๐งโโ๏ธSir Quizard says: "The Royal Treasury grows with each quest completed!"
๐ฆ Current Database Credits
Credits Preview: Local-only placeholder. Future: debit on AI generations / quiz publishes via Stripe.
$0.00
Live billing should be read from Stripe and backend balances only. Local browser-side credit mutation is disabled.
Recent Credit Activity
No activity yet.
๐ฅ User Profiles
๐งโโ๏ธSir Quizard says: "Behold! These brave adventurers have joined our realm!"
๐ Top Players
๐งโโ๏ธSir Quizard says: "These champions have conquered the most quests!"
๐ Top Payers
๐งโโ๏ธSir Quizard says: "These generous nobles support our magical realm!"
๐งโโ๏ธSir Quizard says: "Let us examine this adventurer's journey through the realm!"
Display Name
โ
Account Created
โ
Total Spent
$0.00
Last Active
โ
๐บ๏ธ Quest Ownership
Quests owned (purchased) vs. available in Forging Ahead marketplace
โ Owned Quests0
No quests owned
๐ Available Quests0
Loading...
๐งฉ Quiz Ownership
Quizzes owned vs. available in Forging Ahead marketplace
โ Owned Quizzes0
No quizzes owned
๐ Available Quizzes0
Loading...
๐ Player Statistics
Aggregate stats and achievements
Quests Owned
0
Quizzes Owned
0
Total Purchased
โ
Avg Quiz Score
โ
๐ Recent Activity
Last 20 actions: purchases, quest progress, quiz attempts
Loading activity...
Advanced Administration
โ ๏ธ Expert Zone: Power-user tools for bulk operations and system maintenance.
Only proceed if you understand the data model. Normal content editing belongs in the other tabs.
๐งโโ๏ธ ELI5 - What These Tools Do:
๐ฆ Bulk Import: Like copying 100 pages at once instead of one at a time - upload CSV files to create many characters/storylines/treasures instantly
โ๏ธ SQL Function Overrides: Rewrite the "magic spells" (database functions) that power your quiz app - like changing how scoring works or adding new game mechanics
๐ง System-Level Adjustments: Change core settings that affect the entire app - like payment processing rules or user authentication
๐ CURL Generator: Create command-line "spells" to test your server directly, like a developer's debugging tool
โ ๏ธ Real Talk: These tools can break your app if used incorrectly. They're for experienced developers or when you need to make large-scale changes quickly. When in doubt, use the safer tools in other tabs!
๐ CURL Generator
Create command-line magic spells to talk directly to your server! Perfect for API testing and debugging.
๐ช How to use this wizard:
Pick an endpoint - Choose which part of your server to communicate with
Select method - GET to fetch data, POST to send data
Set limit - How many records to retrieve (start small!)
Generate & copy - Use the command in your terminal or API testing tool
๐ก Beginner tip: Start with GET requests - they're read-only and safe!
๐ค AI Settings & Prompts
โจ Control Your AI Storyteller: Edit the instructions that guide Grok AI in generating Chronicles, character dialogue, and story content.
๐ก How It Works:
Chronicle System: Grok reads completed characters + story chapters and writes a personalized chronicle
Character Dialogue: Each character has personality traits that guide their conversations
Model Selection: Grok-4 is more creative and contextual, Grok-3 is faster
๐ Living Chronicle AI Settings
These settings control how Grok generates the Living Chronicle that players see after completing characters.
0.8(0 = consistent, 1 = creative)
๐ฌ Character Dialogue Settings
Control how Grok generates character dialogue when players interact with quest characters.
๐ Note: Individual character prompts are set in the ๐ฎ Game Design tab under each character's grok_prompt and personality_traits fields.
These settings control the global dialogue generation behavior.
0.9
๐งช Test & Preview
Test your AI settings before deploying to production.
โ ๏ธ Coming Soon: AI preview tools will be added here to test Chronicle generation and character dialogue before saving.
Current AI Configuration:
Chronicle Model: grok-4-1-fast-reasoning
Location: New folder/routes/ai.routes.js (lines 593-662)
๐ Quiz Management
Upload Quiz Data
๐งโโ๏ธ
Sir Quizard says: โThis uploader stores your quiz source text in the database. Think of it like saving the book your questions come from.โ
What happens on upload (ELI5):
Your browser uploads the file to the server.
If itโs an PDF, the server extracts the readable text from it.
If itโs an image, the server uses OCR (OCR.space on Render) to extract text.
Then you review/edit the extracted text before saving.
Optional: click Grok final polish to clean up tiny OCR/typo artifacts only (no rephrasing).
The server saves the extracted text into Supabase quizzes.content.
Price and Active/Inactive are handled after upload via the controls below.
PDF note: We store the extracted text in the DB (not the PDF file itself). If a PDF is image-only/scanned, it may extract little or nothing.
Used to satisfy DB foreign key. Uploads/creates will fail if blank/invalid.
Workingโฆ
Image OCR can take a bit. Please waitโno refresh needed.
Analyzed image preview
Preview & rotate (fine)
Edits happen in your browser before upload, so OCR/Grok sees the edited image.
Flatten & align
Move the 4 green dots to the true corners, then click Rectify. Repeat until it looks right.
Alignment
โ
๐งฐ Quiz DB Editor
Edit the key quiz fields and write to quizzes. โArchiveโ sets Public/Active to false.
โ๏ธ Forging Ahead Publishing
Choose what appears publicly in Forging Ahead and set the price.
Quests
Loading quests...
Quizzes
Loading quizzes...
Your Uploaded Quizzes
Icon
ID
Filename
Uploaded
Price
Active
Statistics
QR Code
Download
Actions
Loading quizzes...
๐ Create a Quiz Pack
Build a bundle from your quizzes. The UI sums the included quiz prices and shows the discount based on your pack price.
Included Quizzes
Tip: only non-pack quizzes are listed. Duplicates are removed automatically.
Sum of included quizzes
$0.00
$Discount: 0%
๐ Create Quest Studio
Focused quest-drafting workflow
This tab is the focused creator workflow for generating a first-pass quest and trading-card style experience from your content URL. Grok drafts one stage at a time so the creator can edit and approve the quest, then the storylines, then the characters, then the treasures before anything becomes the final bundle.
3. Approved quest seeds storylines, then characters, then treasures
4. Edit and approve each stage below
Start With Your Content URL
Use the most content-rich source you have: an exhibit page, lesson page, syllabus page, article, PDF, or image. URLs, PDFs, and images all feed the same editable quest-draft workflow here.
Paste your content URL to generate the first editable quest seed.
Could take up to a minute depending on the source used. Rome wasn't built in a day.
URL generation creates a draft only. Nothing is written to the DB until you click Write to DB. Current mode: new quest, so Write to DB will insert a new quest.
Draft Review
Each stage pauses here for creator edits and approval before the next seed is sent to AI.
No draft yet. Generate from a URL to start the staged quest approval flow.
๐ญ Story Event Studio
This is the post-bundle authoring surface for storyline events. It ingests the approved quest, storylines, characters, and treasures, asks Grok for first-pass content for the three fixed storyline templates, and leaves those content slots editable before the live `story_events` rows are written.
Bundle-firstFixed templatesEditable content slots
Template Family
1. Storyline 1: wedding dual challenge
2. Storyline 2: treaty signing
3. Storyline 3: dragon champion selection
Bundle Intake
Write the approved Create Quest Studio bundle to the database first. After that, this studio can generate and save one live story event per storyline using the standard template family.
Waiting for an approved bundle from Create Quest Studio.
Approve quest, storylines, characters, and treasures in Create Quest Studio, then write the bundle to the database. This tab will ingest that approved material and draft the three fixed storyline events.
๐บ๏ธ Quest Design Workspace
Design Your World: Quests, Storylines, Characters, Challenges and Treasures. No creative bone in your body? Hit the AI buttons to help create wonder.
๐ก๏ธ Your Quests
Loading...
Quest auto-loads when selected. Use this to manually reload if needed.
Idle
Basic Story Events
๐ฑStep 1/3 - Seed Your Imagination
๐งโโ๏ธSir Quizard says: "Feed me your raw material! Upload lesson text, lore fragments, research notes, or paste any source writing. Then add a Focus (what outcomes or themes matter) and a dash of Flavor (tone, mood, sensory feel). Iโll analyze patterns, conflicts, lessons, relationships & vocabulary to extract narrative-ready building blocks for Storyline crafting in Step 2. The richer your input, the sharper the storytelling foundation."
โ Combine multiple files + pasted text
๐ก Use Focus for goals (e.g. empathy, STEM mastery)
๐จ Use Flavor for style (whimsical, solemn, cinematic)
๐งช I detect conflicts, lessons, relationships & settings
๐ Ready output enables precise edits in Step 2
Content URL to Draft Quest
Paste a content-rich URL or upload supporting source material and let Grok produce a first-pass quest draft with quest framing, storylines, characters, and treasures. The result lands below as an editable creator review, not a locked final output.
1. Ingest website text
2. Detect themes and storylines
3. Build the default Grok-designed quest
4. Edit anything before saving
Paste your content URL here, then let Grok build the first draft.
This URL action only builds an editable draft. It does not insert or overwrite anything in the DB until you later confirm Write to DB. Current mode: new quest, so Write to DB will insert a new quest.
Upload or paste docs to drive AI generation
Text-like files load directly here. For PDFs and images, use the server-backed Upload to Cache control below so text extraction/OCR can run first.
Server Cache (no DB)
Upload a PDF or image here to extract text on the server, then load that extracted text into the quest source automatically.
Add Focus = thematic or learning objectives. Add Flavor = mood, tone & sensory vibe. These are appended to AI promptโblank = neutral.
Review generated items here. Accept the ones you want before saving. Nothing auto-saves to the database, but your latest bundle stays in this browser until you clear it.
Quest
๐ Storylines
๐ง Characters
๐ Treasures
๐ผ๏ธ Mementos
โ Create / Edit Character
Loading charactersโฆ
๐ Create / Edit Storyline
// (Removed duplicate ensureStorylineContainerPlacement & showMinimalSourceInterface definitions โ hoisted earlier)
// Provide no-op stub to prevent legacy call sites from throwing if not yet fully refactored
if (typeof showMinimalSourceInterface === 'undefined') {
window.showMinimalSourceInterface = function noopShowMinimalSourceInterface(){ /* intentionally empty */ };
}
Challenge cleared; ready to completePlayer met any requirementsCompletedFinished; optional reward/messageReward on Completion ยท Custom RewardAvailability RulesShow/Hide based on story or itemsInteraction Asks?Find & Give Up Treasure ยท Codeword ยท Required Phrase ยท Any SpeechCharacterโs Starting TreasureLore setup; held by characterNot auto-gifted โ use a reward to give itLegend: Four buckets = Unavailable โ Available โ Unlocked โ CompletedSystem moves character IDs as players progress
Character State โ4 Bucketsโ
1) Unavailable โ Hidden; prerequisites not met (Availability Rules)
2) Available โ Visible; the player can interact
3) Unlocked โ Challenge cleared; requirements satisfied
4) Completed โ Finished; optional reward/message applied
Typical moves
Unavailable โ Available (when Availability Rules are met)
Available โ Unlocked (Find & Give Up Treasure ยท Codeword ยท Required Phrase ยท or Any Speech [no specific phrase])
Unlocked โ Completed (Challenge cleared; Reward on Completion or Custom Reward)
Note: Characterโs Starting Treasure is world setup the character holds; itโs not automatically gifted.
๐ Game Data Tables
Inline Editing: Live data fetched from the staging Supabase via your admin token. Change a value, it persists immediately.
(Fetches fresh rows each reload)
๐๏ธ Database Edits
Manage core design entities (quests, storylines, characters, treasures) and run full AI world generation. Moved here to keep the Game Design step flow focused.
Context-aware. Uses what you've entered and existing data.
These controls were relocated from Game Design. IDs preserved to avoid breaking handlers.
โน๏ธ How to Use
Use the action bar above to open entity forms or run AI generation. After generating content (Nuclear or source-based from Quest Step 1), return to Game Design to proceed through Step 2/3 editing & approval and Step 3/3 world build staging.