# Verdancia: Morgan's Story
**A 30-minute VR demo showcasing AI-driven narrative and memory-based relationships.**
---
## What This Is (60 seconds)
A cozy VR narrative where NPCs genuinely remember your conversations—not scripted dialogue trees, but real persistent memory. Built in Unity for Quest 3. You arrive at a struggling inn, help restore it, and witness a mysterious crash—all in 30 minutes.
**Why this matters:** Most games fake memory with "if player did X, say Y" scripts. We store actual conversation history and retrieve it semantically. NPCs remember what you said last week.
**This vault:** Documents the 30-minute demo, with optional deep-dives for students interested in the craft details.
**Want to join?** We're looking for 1-2 **3D artists or technical artists** (10-15 hrs/week).
**Want to explore?** Start with [[VERDANCIA-30MIN-STORY|The Story]].
**Want the tech?** See [[design/under-the-hood|Technical Overview]].
---
## Start Here
**For the full experience:**
[[VERDANCIA-30MIN-STORY|Read the 30-Minute Story]]
**For game developers:**
This vault documents the design process, technical architecture, and creative decisions behind a cozy VR narrative demo.
---
## Navigation Guide
### **Narrative**
- [[VERDANCIA-30MIN-STORY|The Story]] - Complete 30-minute narrative with embedded storyboards
- [[characters/raven|Characters]] - Raven, Anchor, and a mysterious arrival
- [[locations/the-inn|Locations]] - The Inn, Verdancia, the Forest
### **Design**
- [[design/pillars|Design Pillars]] - What makes Verdancia work (4 core principles)
- [[design/under-the-hood|Technical Details]] - How memory persistence, AI, and progressive disclosure work
- [[design/what-comes-next|Future Plans]] - Acts 5-8 and beyond
- [[design/how-we-work|How We Work]] - Collaboration guide (T3 deep-dive)
### **Worldbuilding**
- [[magic-systems/spiraloak|Spiraloak]] - The memory network that connects everything
- [[magic-systems/ui-design|UI Design]] - Minimal contextual interface philosophy
- [[media/MEDIA-INDEX|Visual Assets]] - All concept art, storyboards, and references
---
## Technical Overview
**Demo Strategy:**
- **Primary Demo Platform:** Quest 3 VR (for game studio presentations)
- **Secondary:** "Also works in browser" (Chrome/Safari) - Cross-platform proof
- **Future:** Desktop (macOS, Windows PC, Steam Deck)
**Tech Stack:**
- **Engine:** Unity (30-min demo), Bevy A/B testing post-demo
- **VR Platform:** Quest 3 native (hand tracking, spatial audio, full VR presence)
- **Browser Version:** WebGL fallback for accessibility/quick demos
- **Demo Scope:** Single-player narrative experience (30 minutes)
- **Post-Demo Expansion:** Small-group multiplayer co-op (2-4 players)
- **Networking:** Custom WebSocket solution for multiplayer + AI NPCs
- **AI Memory:** Anchor remembers last 30 minutes (active working memory), Spiraloak network stores 30 days (persistent retrieval)
**Distribution Goals:**
- Quest Store submission (primary)
- Browser deployment for demos and accessibility
- Cross-platform progression (browser → Quest 3 continuity)
**Why Quest 3 First?**
- Studios need to **feel** the VR presence (not just see it)
- Hand tracking makes UI interactions feel natural
- Spatial audio enhances cozy atmosphere
- Browser version proves "we can deploy anywhere"
**Core Innovations:**
- Persistent NPC memory (conversations remembered, relationships deepen)
- AI companion with honest limitations (Anchor's 30-min context window)
- Minimal contextual UI (symbols appear only when relevant)
- Cozy-first pacing (safety before mystery)
- Native VR presence optimized for comfort and immersion
---
## Learning Paths
### **Path 1: I want to understand the aesthetic**
1. Start: [[VERDANCIA-30MIN-STORY|The Story]]
2. Visuals: [[media/MEDIA-INDEX|Storyboards & Concept Art]]
3. Vibe: [[design/pillars|Design Pillars]] (cozy-first, archetypal depth)
### **Path 2: I want to see the world design**
1. Start: [[locations/the-inn|The Inn]]
2. Deep dive: [[magic-systems/spiraloak|Spiraloak]] (the glowing tree network)
3. Style guide: [[characters/raven|Raven]] and [[magic-systems/ui-design|UI Design]]
### **Path 3: I want technical constraints**
1. Start: [[design/under-the-hood|Technical Details]] (Quest 3 optimization)
2. Context: [[design/pillars|Design Pillars]] (VR presence, minimal UI)
3. Visuals: [[media/MEDIA-INDEX|Concept Art]] (Enuryn aesthetic reference)
---
## File Structure
```
published-vaults/spiralverse/
├── README.md ← You are here
├── VERDANCIA-30MIN-STORY.md ← Start here for narrative
├── characters/ ← Character deep-dives
├── design/ ← Design philosophy & technical details
├── locations/ ← World locations
├── magic-systems/ ← How Spiraloak, UI, and cultivation work
└── media/ ← All visual assets
├── storyboards/ ← 11 narrative beats
├── characters/ ← Character concept art
├── environments/ ← Location studies
└── magic-system/ ← System visualizations
```
---
## Project Status
**Current:** 30-minute demo narrative complete, concept art finished, Unity implementation in progress
**Next:**
- Complete Unity prototype
- Multiplayer co-op testing (2-player)
- Bevy A/B test after 30-min demo validation
**Vision:** Acts 5-8 expand to 2-hour experience with Morgan's integration into Verdancia community
---
## Credits & Philosophy
**Design Philosophy:**
- Cozy first, mystery earned
- Memory that matters (relationships persist)
- Honest AI (limitations as features, not bugs)
- Simple surface, archetypal depth
**This vault is:**
- Living documentation (updates as project evolves)
- Open for learning (use these frameworks in your projects)
- Tier-loadable (story → deep-dives → craft details)
---
**Ready to begin?** [[VERDANCIA-30MIN-STORY|Start the Story →]]
---
## For Aspiring Game Developers: Join Us?
### What You'll Actually Learn
This isn't a typical student project. You won't just execute tasks—you'll learn **VR art craft** and **cozy game aesthetics**.
**Specific Skills:**
- Quest 3 asset optimization (5K-15K poly budget, texture atlasing)
- VR-scale modeling (human perception in first-person VR)
- Cozy game aesthetics (Studio Ghibli-inspired, organic-tech fusion)
- AI-to-game pipeline (Meshy.ai → Unity → Quest optimization)
- Technical art (glowing shaders, particle VFX, holographic UI)
- Environmental storytelling (making spaces feel lived-in)
**Portfolio Value:**
Most students model weapons or sci-fi corridors. You'll make something that shows **emotional design** and **VR craft thinking**.
### What This Project Is (And Isn't)
**IS:**
- ✅ Collaborative 3D art for VR narrative
- ✅ Learning Quest 3 optimization and cozy aesthetics
- ✅ Creative input valued (art direction is collaborative)
- ✅ Experimental (some assets will fail, we'll iterate)
- ✅ Portfolio-quality work for game studio presentations
**ISN'T:**
- ❌ Fixed hours for guaranteed paycheck
- ❌ Clearly defined asset list you just execute
- ❌ Resume line without creative investment
- ❌ Typical game art job (this is cozy VR R&D)
---
### What I Already Handle (You Focus on Art)
**I'm a Quest dev with Unity experience:**
- ✅ Unity systems integration (hand tracking, spatial audio)
- ✅ AI memory system (NPC conversations, persistent memory)
- ✅ VR interaction design (berry harvest, Anchor glyph spawning)
- ✅ Network multiplayer architecture (post-demo)
- ✅ Performance profiling (helping you hit 72fps target)
**What I need help with:**
- ❌ 3D modeling (characters, environments, props)
- ❌ Art direction consistency (Enuryn organic-tech aesthetic)
- ❌ Technical art (shaders, VFX, holographic UI)
- ❌ Environmental storytelling (making spaces feel alive)
**Translation:** If it's code/systems, I've got it. If it needs to look beautiful and feel cozy, that's you.
### Technical Challenges (For the Puzzle-Solvers)
**Hard problems we're tackling:**
1. **Quest 3 Optimization:** 72fps stable in VR—how do we make glowing roots and particle effects performant without sacrificing cozy atmosphere?
2. **VR Scale Calibration:** First-person makes everything feel 30% larger—how do we model the inn so it feels cozy, not claustrophobic?
3. **Enuryn Aesthetic Consistency:** Organic-tech fusion (gnome spacecraft, glowing roots)—how do we keep this readable and consistent across 20+ assets?
4. **AI Model Cleanup Pipeline:** Meshy.ai generates decent meshes but wrong style—how do we build a reliable concept → game-ready workflow?
5. **Cozy Lighting for VR:** Studio Ghibli warmth in real-time rendering—how do we balance performance with emotional atmosphere?
6. **Holographic UI in 3D Space:** Anchor's symbols (spiral/bridge/shield) need to float naturally—how do we make glyphs feel magical, not "early 2000s sci-fi HUD"?
**If these excite you** → Keep reading
**If these feel vague/overwhelming** → Maybe not your project (yet)
---
### What You'd Actually Work On
**Example artist contributions:**
**3D Environment Art:**
- Inn common room (cozy hearth, worn furniture, VR-scale proportions)
- Spiraloak sapling 3D model (3-4 meters tall, glowing root tendrils, harvestable berry clusters)
- Copper-bark forest props (trees, rocks, ground cover for Quest 3 draw call budget)
- Quest 3 LOD strategy (hero assets 15K polys, background <5K polys)
**Character Modeling:**
- Raven character model (mid-30s innkeeper, earth tones, approachable in VR first-person)
- Old Farmer NPC (simple, readable from 2 meters conversational distance)
- Morgan survivor concept → model (crash debris, glitching interface VFX integration)
**Technical Art:**
- Spiraloak glow shader (pulsing golden light, performance-friendly)
- Berry harvest VFX (light flow particle effect, tactile feedback for hand tracking)
- Anchor holographic symbols (spiral/bridge/shield glyphs, magical not sci-fi)
- Quest 3 profiling (72fps target, identify performance bottlenecks)
**AI Pipeline Optimization:**
- Meshy.ai → Unity workflow (retexture for Enuryn aesthetic)
- Style consistency pass (organic-tech fusion, Studio Ghibli warmth)
- Collision mesh generation (VR grabbable props, hand interaction surfaces)
- Texture atlasing for Quest 3 (minimize draw calls, maintain visual quality)
**Note:** I handle Unity systems, hand tracking interactions, AI memory backend. You focus on making it look and feel beautiful.
**Hardware:** Quest 3 helpful for testing but not required—most modeling done in Blender/Maya, testing in Unity editor.
---
### Self-Selection Questions
Before reaching out, ask yourself:
1. **Have you modeled for VR or mobile games before?** (Quest 3 = strict performance constraints)
- If only desktop high-poly → You'll learn optimization
2. **Are you drawn to cozy aesthetics?** (Studio Ghibli, Stardew Valley, Journey)
- If no → This won't resonate with you
3. **Do you want creative input or just clear asset lists?**
- If just tasks → We're too experimental
4. **Can you handle "we tried X style, it failed, now what?"**
- If need certainty → This will frustrate you
5. **Does "making the inn feel like home" excite or confuse you?**
- If excite → Perfect fit
- If confuse? → Read [[design/pillars|Design Pillars]] first
- Still confuse? → Probably not your project
**3+ excited answers** → Let's talk
**3+ hesitations** → That's okay, not every project fits everyone
### How to Actually Get Involved
**Don't:** Send generic "I want to join" email
**Do:** Pick ONE and spend 30-60 minutes engaging with the work:
**Option A - Design Thinking:**
- Read [[design/pillars|Design Pillars]]
- Pick ONE pillar that resonates
- Write 200 words: "Here's how I'd visualize this..." (sketch optional but welcomed)
- Explain art direction choices that would make it work
**Option B - Technical Deep Dive:**
- Read [[design/under-the-hood|Technical Details]]
- Look at [[media/MEDIA-INDEX|Concept Art]]
- Write 200 words: "Here's how I'd approach Quest 3 optimization..." or "Here's my style reference for Enuryn aesthetic..."
**Option C - Environmental Storytelling:**
- Read [[VERDANCIA-30MIN-STORY|The Story]]
- Look at [[locations/the-inn|The Inn]] description
- Write 200 words: "Here's how I'd make the inn feel cozy in VR..." with references (other games, films, real spaces)
**Option D - Character/Asset Design:**
- Explore [[characters/raven|Raven]] and [[magic-systems/spiraloak|Spiraloak]]
- Write 200 words: "Here's my concept sketch approach..." or "Here's how I'd model the glowing roots..."
- Bonus: Quick thumbnail sketch (phone photo of pencil sketch is fine)
**Then reach out with:**
- Your 200 words (+ optional thumbnail sketch)
- Which option you chose (A/B/C/D)
- Why cozy VR art excites you more than typical student projects
- Your background (Blender? Maya? Substance? Unity? Quest dev? Just curious?)
- Portfolio link (ArtStation, personal site, even just Instagram sketches—we care about process, not polish)
**Why we ask this:**
- Filters "spray and pray" applicants
- Shows you actually engaged with the work
- Gives us conversation starting point
- Respects both our time
**If 30-60 minutes feels like too much** → This project requires passion, not just pay (and that's okay!)
### What Happens Next
**If you send thoughtful 200 words:**
1. We read it (genuinely)
2. If it shows real engagement → We schedule a conversation
3. We discuss: What excites you? What can you contribute? What do you want to learn?
4. If mutual fit → You join for a trial sprint (2 weeks, specific task)
5. Trial goes well → Longer-term collaboration
**If you don't send 200 words:**
- That's totally fine!
- Explore the vault, learn from it
- Use these ideas in your own projects
- Come back if passion strikes later
**We're looking for 1-2 students who:**
- Care about cozy aesthetics and VR craft
- Want to learn Quest 3 optimization and environmental storytelling
- Can handle iteration and art direction feedback
- Will bring creative ideas and visual references, not just execute tasks
- Can commit ~10-15 hours/week during development sprints
**Time Commitment:**
- **Trial sprint:** 2 weeks, ~10 hours/week (model ONE asset, mutual evaluation)
- **Core development:** 2-3 months, ~10-15 hours/week (if trial succeeds)
- **Flexible:** We adapt to your school schedule
- **Not:** 40-hour weeks or fixed employment (this is collaborative art R&D)
**What This ISN'T:**
- ❌ A way to bulk-hire 10 artists for asset production
- ❌ Fixed paycheck for making pre-defined models
- ❌ Guaranteed hours regardless of creative engagement
- ❌ "Model this exact spec" typical outsourcing job
---
**Contact:**
- **Discord:** sam [weaver] (in East Sweden Game server)
- **Email:**
[email protected]
- **Quick question?** DM on Discord first—we're more responsive there
- **Prefer email?** That works too, just might take longer
**Before applying:** Send your 200-word reflection (Option A/B/C/D above)
**Just curious?** DM with questions—no commitment needed
**Vault last updated:** December 2025
**Project status:** 30-min demo in Unity, concept art complete, storyboards finished, Quest 3 primary target