Linden Logo
LindenEngine
PRD v1.4

1. Introduction

1.1 What is Linden?

Linden is an AI-native game development platform that transforms natural language prompts into production-grade, deterministic game assets, stateful code, and canonical engine scene graphs. Orchestrated by a coordinated 5-agent swarm working in parallel consensus.

AgentSpecialization
Game ArchitectScene hierarchy, node tree, lifecycle management
ProgrammerGDScript 2.0, C# 12, Rust bindings, AST diffing
Technical ArtistGLSL/HLSL/WGSL shaders, sprite atlases, normal maps
QA InspectorHeadless simulation, collision testing, performance profiling
Level SynthesizerProcedural level generation, difficulty pacing, biome design

1.2 Key Capabilities

  • Prompt-to-Playable – describe game mechanics in natural language
  • Hot-Reload <100ms – in-memory delta patching without engine reboot
  • Multi-Target Export – WebGPU, Windows, macOS, Linux, Consoles
  • AST-Level Precision – never overwrites hand-crafted custom code
  • Deterministic Output – >99.5% determinism score
  • 100% Royalty Free – full commercial ownership of all code & assets

1.3 System Requirements

ComponentMinimumRecommended
BrowserChrome 113+, Safari 18+, Firefox 120+Chrome 132+ (WebGPU)
RAM4 GB8 GB
GPUWebGL 2.0 supportWebGPU / Vulkan 1.3
OSWindows 10, macOS 12, Linux (Ubuntu 22.04)Windows 11 / macOS 14+
Internet10 Mbps50 Mbps (for live agent streaming)

2. Getting Started

2.1 Registration & Authentication

  1. Visit Linden Studio (linden.ai)
  2. Click "Start Building" or "Sign In"
  3. Authenticate via Google, GitHub, or Developer Email
  4. Access your cloud workspace dashboard immediately

2.3 First Project: "Hello Platformer"

  1. Step 1 β€” Input Prompt:
    Create a 2D platformer with a blue character who can jump and
    collect yellow coins. Add a red enemy that moves back and forth.
  2. Step 2 β€” Click Generate:

    Click "Generate Prototype" to dispatch parallel agent tasks (takes 30-60s).

  3. Step 3 β€” Inspect Output:

    Play in WebGPU Canvas, browse Scene Graph, examine GDScript/C# code, and review QA test logs.

  4. Step 4 β€” Export:

    Export as standalone WebAssembly bundle, Godot 4.3 project archive (.zip), or Windows executable.

3. Core Concepts

3.1 Understanding the 5 Agents

3.1.1 Game Architect

Converts high-level prompt mechanics into canonical engine node trees, life-cycle scripts, and collision masks.

3.1.2 Programmer Agent

Synthesizes strictly-typed GDScript 2.0 and C# 12. Employs AST diffing to never overwrite existing hand-written logic.

3.1.3 Technical Artist

Synthesizes custom visual shaders (GLSL/WGSL/SPIR-V), animated tilemaps, sprite sheets, and normal maps.

3.1.4 QA & Physics Inspector

Executes up to 10,000 headless physics simulation ticks to verify raycasts, boundary collisions, and memory allocations.

3.1.5 Level & Biome Synthesizer

Procedural generation using Wave Function Collapse (WFC), progressive difficulty curves, and environmental lighting volumes.

3.3 Token Economics

ActivityCompute Tokens
1 prompt parsing~100-500 tokens
Generate full platformer~12,000 tokens
Shader generation~2,400 tokens
Physics tweak~800 tokens
Level generation~3,500 tokens

4. Intermediate Guide

4.1 Direct Agent Directives

Use targeted @agent directives to invoke specific specialists:

@architect: "Add an Area2D sensor child to Player for detecting loot drops"
@programmer: "Write a collect_item() method that increments player score"
@artist: "Generate a 4-frame walk animation strip for the protagonist"
@qa: "Run 1000 wall-jump collision simulation cycles"

4.4 Command Line Interface (CLI)

npm install -g @linden/cli

# Generate project from prompt file
linden generate -f prompt.txt -o ./output

# Export target for Godot 4.3
linden export -t godot -o ./my_game

# Run headless simulation suite
linden test --ticks=1000 --headless

5. Advanced Guide

5.1 Advanced Prompt Engineering

=== GAME SPECIFICATION ===
Title: "Neon Ghost"
Genre: Action-Platformer
Physics: Gravity 1200px/sΒ², Jump Impulse 450px

=== MECHANICS ===
- Wall-sliding with spark particle emission
- Dash maneuver with 0.5s cooldown
- Neon energy katana attack with trail effect

5.4 Multi-Target Export

TargetFormatPrimary Use Case
WebHTML5 + WASMBrowser play, instant sharing
Windows.exe (portable)Steam, Itch.io distribution
macOS.app (universal)Mac App Store, standalone
LinuxAppImageSteam Deck, Linux gamers
Android.apk / .aabGoogle Play Store
iOS.ipa (preview)Apple App Store
ConsolesCustom SDKPlayStation, Xbox, Switch (NDA)

6. Professional & Enterprise

6.1 Enterprise Architecture

Private cloud VPC isolation, custom fine-tuned local models, and dedicated multi-tenant clusters.

6.4 Security & Sandboxing (Firecracker microVM)

All untrusted code compilation and testing runs within ephemeral Firecracker microVMs with strictly bounded CPU (2 vCPU), memory (512MB), and blocked network sockets.

7. API & SDK Reference

7.1 REST API Endpoint Summary

POST   /api/v1/projects          - Initialize new project
GET    /api/v1/projects/:id      - Retrieve project state & AST
POST   /api/v1/generate          - Dispatch swarm generation
POST   /api/v1/export            - Compile release binaries
GET    /api/v1/health            - System cluster & quorum status

8. Troubleshooting

8.1 Common Issues

IssueProbable CauseRecommended Solution
Error 400Malformed prompt syntax or JSONInspect JSON headers, test with curl -v
TimeoutProject scope too complexBatch prompt, enable async streaming, or upgrade tier
Tokens ExhaustedQuota exceededUpgrade tier or acquire pay-as-you-go token packs
Code Build FailAST Parse ErrorReview QA Inspector logs, use more constrained prompt
Low FramerateGPU / Shader loadTarget WebGPU, enable caching, or use self-hosted runner

8.3 Error Codes

CodeDescriptionRecommended Action
400Bad RequestVerify JSON schema & syntax
401UnauthorizedVerify API Key or re-authenticate
403ForbiddenCheck tier permissions
404Not FoundInvalid project ID specified
429Rate Limit ExceededThrottle calls or upgrade token concurrency
500Internal Engine ErrorContact Linden developer support

9. FAQ & Appendix

9.1 General Questions

Q: How does Linden differ from general LLMs like ChatGPT?

Linden uses 5 specialized domain agents operating in Raft-like consensus, deterministic AST patching, and compiles directly into executable game runtimes.

Q: How fast does it generate a playable game?

A 2D platformer prototype builds in 30-60 seconds. Incremental physics and visual tweaks hot-reload in under 100 milliseconds.

Appendix: Glossary

TermDefinition
ASTAbstract Syntax Tree – structural tree representation of source code
JITJust-In-Time compilation – runtime delta patching & instant reload
WASMWebAssembly – high performance binary runtime for web canvas
GDScriptGodot Engine's native, high-performance scripting language