Terminal
Terminal/Skill
Guides building, debugging and publishing VIVERSE web games and 3D apps with Three.js or React Three Fiber, including characters and physics.
By Poimandres (Zustand, R3F)
Works with
npx skills add pmndrs/viverse --skill pmndrs-viverseUse this skill for VIVERSE-ready Three.js and React Three Fiber apps. Use @react-three/viverse for React apps and @pmndrs/viverse for vanilla Three.js.
public/ folder, but do not fetch remote example source unless the user explicitly asks for it.references/getting-started.md: installation, first scenes, basic examples.references/components-and-hooks.md: exact React component, hook, action, character, physics, and animation APIs.references/gameplay-quality.md: game architecture and validation heuristics for playable demos.references/tutorials/index.md: tutorial index. Read one focused tutorial file rather than loading all tutorials.references/tutorials/custom-character-controller.md: custom humanoid controller with BVH character physics, directional locomotion, camera aim, held items, and layered upper-body actions.references/without-react.md: vanilla Three.js usage.references/publishing.md: VIVERSE CLI, build output, app creation, publishing.If unsure which reference applies, search first:
rg -n "SimpleCharacter|BvhPhysicsBody|avatar|actions|XR|publish" path/to/skill/references
<Viverse>.<SimpleCharacter /> for ordinary embodied React gameplay and new SimpleCharacter(...) for ordinary vanilla Three.js gameplay.model={false} unless the user asked for a placeholder or non-avatar actor.BvhPhysicsBody; dynamic blockers should share the same collision truth used by character movement and game logic.SimpleCharacter.references/tutorials/custom-character-controller.md: VIVERSE character physics, model/provider, bone attachments, and animation actions/layers.<Viverse>, BvhPhysicsBody, and a hand-rolled mesh/capsule player. The controllable player itself must use the VIVERSE character/controller/model/action/animation primitives.useCharacterModelLoader or loadCharacterModel. Do not fabricate the player model by casting a Group of boxes/cylinders/spheres to CharacterModel.<Gltf />, useGLTF, or equivalent) under CharacterModelBone; primitive boxes/cylinders are placeholders, not a finished held item, when an asset or tutorial model exists.references/gameplay-quality.md before final validation.react, react-dom, three, @react-three/fiber, @react-three/drei, @react-three/viverse, and companion packages such as @react-three/timeline; do not copy stale tutorial dependency caps or invent future ranges.@types/react, @types/react-dom, and @types/three.clientId during local development unless the user explicitly asks for authenticated VIVERSE behavior.BvhPhysicsBody and BvhPhysicsSensor should not structurally change after creation; use stable groups and visibility toggles when needed.references/publishing.md.Check the essentials:
vitexec/play.ts route reuses the same helpers and milestones proven by any disposable probes.