Start Creating

Build on your computer and see every saved change come alive in VibeLands.

You need Node.js 20+ and a VibeLands account with a world.

1. Install Creator

npm install --global @vibelands/creator

Do this once. It adds the vibelands command and the public Creator tools.

2. Connect your account

vibelands login

Your browser opens a confirmation page. Check that its code matches the terminal, then press Confirm and connect. There is no token to copy.

If the browser cannot open on this computer, run vibelands login --no-open and use the printed link on another device.

3. Create your first project

vibelands create my-first-vibe
cd my-first-vibe
npm install
npm run dev

Creator asks which world to use and prints a game link. Open it and keep that tab running. Every time you save a file, your private world preview updates.

Your project uses the public Creator and Plugin SDK packages. The files stay on your computer, ready for your editor, Git, and AI tools.

4. Bring your first idea to life

Open client/BeaconModel.jsx, change the beacon color, and save. Then place it in the game from Add → Props → Hello Beacon.

From now on, return to the project and run:

npm run dev

Create with AI

Open the project in Creator Studio or your editor and give your LLM a simple request:

Read AGENTS.md, then turn the beacon into a magical forest lantern. Run the project checks when you finish.

Keep the game tab open while the LLM works. Each successful change appears in the world. See the local LLM workflow for a complete example.

Add shared gameplay when you need it

The starter is ideal for visuals and placeable objects. Choose Tier B when all players must share scores, collected items, rewards, timers, or saved progress:

vibelands create my-quest --tier B

Continue with the Tier B gameplay walkthrough.

Check before sharing

npm run check
npm test          # Tier B only

When your creation is ready for others, see Publishing.

Want to try without installing?

Use the browser Sandbox for a quick experiment. Use the package workflow above for creations you want to keep.

Need help?

vibelands doctor
vibelands check . --json

See Remote Sandbox for preview problems or the CLI reference for every command.