Skip to content

Social Scape Creator Docs

Welcome! This is everything you need to build for Social Scape — worlds, avatars, and AI NPCs that talk, react, and act — using the Social Scape SDK in Unity.

Start here

  • Getting Started — install the SDK, build your first world, and upload it.
  • Worlds — scene setup, the world descriptor, and the upload pipeline.
  • World Objects — moving platforms, gravity zones (walkable rolling/inverted ships), jump pads, teleporters.
  • Interactables — grabbable props, levers and buttons, with inspector‑driven events (a gun that fires, a button that opens a door).
  • World Triggers & Logic — make worlds react with no‑code logic: timers, zones, key presses, player join/leave, plus variables, conditions and operations.
  • Health & Combat — health, damage, respawn, and death events for your world.
  • Video Players — play video (direct files or YouTube/Twitch) on screens, with spatial speakers, controlled from triggers or UI.
  • NexusScript — the safe scripting language that makes your world interactive.
  • AI NPCs — give characters a brain, a voice, and custom actions.
  • Aegis — creator‑first content protection: your avatars and worlds, encrypted by default.

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 Social Scape. 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.