VXLVERSE DOCS

VXLVERSE is a browser-based platform for creating 3D games without writing code. You can build levels, place 3D models, script NPC dialogues, and publish your game — all from the editor in your browser.

Your work autosaves to the cloud about a second after every change — there's no manual Save button on this version.

The editor is split into four areas:

Select an entity by clicking it in the viewport or in the Outliner. Press Ctrl+Shift+G, Ctrl+Shift+R, or Ctrl+Shift+S to switch between position, rotation, and scale gizmos. Arrow keys nudge the selected entity in 0.5-unit steps; hold Shift for fine 0.1-unit nudges.

Multi-select in the Outliner with the row checkboxes (or shift-click for ranges). When two or more entities are checked, the Inspector switches to bulk mode where you can change type, move/rotate/scale relatively, or delete them all at once.

VXLVERSE ships with 4,000+ free CC0 GLB 3D models. They live in the Asset Dock at the bottom of the editor — there's no separate modal to open. Pick a model, click in the viewport, done.

The first entity you place in a brand-new scene should be a Scenes & Levels asset — these are full environments (a town, a dungeon, an island) that act as the world backdrop. The editor opens a scene picker automatically when you create a new scene to nudge you toward this.

All models are standard .glb files cached after first load, so subsequent uses are instant. Pro / Admin users can also upload their own GLBs via the + Upload GLB button — useful when you have custom assets that aren't in the public library.

To set the player's starting position, click the green Hero Spawn button at the bottom-right of the viewport, then click anywhere in the scene.

The Story Editor is the canonical place to write your game's narrative. Press Q in the editor or click the Story button at the top-center of the viewport.

You can also write dialogue scripts directly per NPC by selecting the entity, opening the Inspector, and editing the Script field — or pressing Q while an NPC is selected to open the script editor for just that character. The scripting language is VXLScript (next section).

VXLScript is a simple text-based language for writing NPC dialogues, shops, quests, and game logic. Select an NPC entity and press Q to open the script editor.

# START
Guide: Welcome to the village!
-> END

# SHOP
Merchant: What would you like to buy?
-> END

Merchant: Welcome to my shop!
Merchant: I have the finest wares in all the land.
Player: What do you have for sale?

Guard: Halt! State your business.
* I'm here to trade -> MARKET
* I seek the King -> CASTLE
* Just passing through -> END

Merchant: What would you like?
* Buy Sword (50g) (need 50 $gold) -> BUY_SWORD
* Buy Potion (10g) (need 10 $gold) -> BUY_POTION
* Leave -> END

// Conditional goto: auto-jumps if player has the key
-> OPEN_DOOR (need 1 $key_dungeon)
Door: It's locked. You need a key.

[give $gold 100]
[give $sword_iron 1]
[give $hp 50]

[take $gold 50]
[take $key_dungeon 1]

[set $npc_quest_active 1]
[set $npc_quest_desc "Find the lost sword"]
[set $npc_quest_done 1]
// Quest flags power the Quest Log (J key):
//   _quest_active → shows as active quest
//   _quest_desc → shows objective text
//   _quest_done → marks as completed

[goto_level dungeon_01]

[hide boulder_entrance]
[show treasure_chest]

[wait 2]

[end_game You saved the kingdom!]

# START
NPC: Hello there!
-> GREETING

# GREETING
NPC: Nice to meet you.
-> END

// This is a comment
// Check if player has the quest item
-> REWARD (need 1 $dragon_head)

# START
// Return path if quest is done
* (need 1 $quest_dragon_dead) -> HERO
* (need 1 $quest_dragon_active) -> RETURN

King: A dragon plagues our lands!
* I will slay it! -> ACCEPT
* Sounds dangerous... -> COWARD

# ACCEPT
King: Take this key to the dragon's lair.
[give $key_dragon_lair 1]
[set $quest_dragon_active 1]
-> END

# COWARD
King: Then we are doomed...
-> END

# RETURN
// Auto-complete if player has proof
-> VICTORY (need 1 $dragon_head)
King: Have you slain the beast?
-> END

# VICTORY
[take $dragon_head 1]
[set $quest_dragon_active 0]
[set $quest_dragon_dead 1]
[give $gold 5000]
[give $sword_excalibur 1]
King: You are the Savior of the Realm!
-> END

# HERO
King: All hail the Dragon Slayer!
-> END

Publishing is a deliberate event, not a hidden toggle. The Publish button sits next to the green ▶ Play button at the top-right of the viewport. Clicking it opens the Publish modal — a single screen where you review the public-facing details of your game and ship it to the gallery.

If your game has critical issues (no scenes yet, no hero spawn placed), the modal shows a red banner listing what to fix and disables the Publish CTA. Click any issue to jump to its fix point. Warnings (NPCs without descriptions, scenes without descriptions) show as a soft amber hint but don't block publishing — your game runs, it just feels unfinished.

Once published, the same button reads ✓ Live and reopens the modal in Update mode. You can change metadata, recapture the thumbnail, or hit Unpublish to remove the game from the gallery without deleting it.

There is no manual save button on this version. Every change you make in the editor is written to two stores in succession:

The save indicator in the header reads Save normally, switches to Saving while the cloud upload is in flight, and back to Save when complete. If the network is offline, your changes still persist in localStorage and sync next time you have connectivity.

Game thumbnails auto-capture on first save (so your game has something to show on cards immediately). After that, they're only updated when you explicitly recapture or upload via the Publish modal — your custom thumbnail won't get overwritten.