SocialScape Creator Docs¶
Welcome! This is everything you need to build for SocialScape — worlds, avatars, and AI NPCs that talk, react, and act — using the SocialScape SDK in Unity.
Start here¶
- :material-rocket-launch: **[Getting Started](getting-started.md)** — install the SDK, build your first world, and upload it.
- :material-earth: **[Worlds](worlds.md)** — scene setup, the world descriptor, and the upload pipeline.
- :material-cube-outline: **[World Objects](world-objects.md)** — moving platforms, ride zones, jump pads, teleporters, gravity volumes.
- :material-code-braces: **[NexusScript](nexusscript/index.md)** — the safe scripting language that makes your world interactive.
- :material-robot-happy: **[AI NPCs](ai-npcs/index.md)** — give characters a brain, a voice, and custom actions.
What you can build¶
- Interactive worlds — triggers, doors, lights, minigames, scoreboards — scripted in NexusScript (a sandboxed C#‑like language that runs safely on the server and clients).
- AI NPCs — conversational characters powered by an LLM, with personality, world awareness (they react to events), custom actions (they can do things in your world), and voice.
- Avatars — custom characters players can wear.
How it fits together¶
Your Unity project (SDK)
├─ Build a world scene ──► upload ──► hosted on SocialScape
├─ NexusScript (.cs NexusBehaviours) ──► compiled, travels inside the world
└─ AI NPC config (personality, provider, actions) ──► travels inside the world
You only ever touch the SDK — the servers are run by SocialScape. Everything your world needs (scripts, NPC config, AI provider settings) travels with the world when you upload it.
New to NexusScript?
It looks like C# and you write it as .cs files, but it's a safe subset compiled by NexusVM — no arbitrary system access, no crashing the server. Start with NexusScript basics.
Key concepts at a glance¶
| Concept | What it is |
|---|---|
| World | A Unity scene you build and upload; other players join instances of it. |
| NexusScript | Your world's logic — a NexusBehaviour (.cs) compiled by NexusVM. |
| AI NPC | A character with an SSAINpc component: personality + an action manifest. |
| World Event | Your script telling an NPC something happened (NPC.Notify). |
| Custom Action | A tool the AI can choose to call, implemented by your script. |
| Storage | Per‑script "soft memory" (in‑memory; durable options for cross‑restart). |
→ Jump in with Getting Started.