VIVEN Wiki

Unity 기반으로 VR/메타버스 월드와 오브젝트를 저작할 수 있는 VIVEN SDK 공식 개발자 문서입니다. 개발환경 구축부터 Viven Script(Lua) 작성, 네트워크 동기화까지 단계별로 안내합니다.

환영합니다, VIVEN CREATOR 여러분!

VIVEN SDK는 Unity Editor 위에서 동작하는 메타버스 저작 도구입니다. Unity의 거의 모든 기능을 그대로 활용하면서, VIVEN 클라이언트(il2cpp 빌드)에서 런타임으로 실행 가능한 Viven Script(Lua)로 상호작용·네트워크·UI 로직을 구현할 수 있습니다.

어디서부터 시작할까요?

처음이라면 아래 순서를 추천드립니다.

1. 개발환경 구축하기 — Unity 설치·필수 에셋·SDK 설정
2. Quick Start — 빈 Scene으로 첫 VIVEN 맵 만들기 (6단계)
3. Viven Script 이용하기 — Lua 기반 스크립팅 기초
4. Unity 연동 — GameObject·Transform·Component 제어
5. Interaction 개요 — Grabbable, Sittable, Attach Point
6. Network 개요 — VObject, View, RPC, Room 프로퍼티

핵심 개념 한눈에 보기

• VMap — 하나의 월드. 루트에 Viven Map Environment 컴포넌트가 반드시 필요합니다.
• VObject — 네트워크 동기화 단위. 모든 상호작용의 기본.
• Viven Script — Lua 기반 런타임 스크립트. Viven Lua Behaviour 컴포넌트로 GameObject에 부착.
• View — VObject의 데이터를 실시간 동기화하는 컴포넌트 (TransformView, RigidbodyView 등).
• RPC — 원격 프로시저 호출. 단방향 이벤트 동기화.

외부 자원

• 📚 API Reference (sdkdoc.viven.app) — TwentyOz.VivenSDK.Scripts.Core.VivenAPI 네임스페이스 전체
• 🤖 VIVEN Coding Agent (GitHub) — Developer Preview
• 📂 SDK UPM (GitLab) — Unity Package Manager용 Git URL