threejs-controls
/threejs-controls
Addon camera and object manipulation controls: OrbitControls, MapControls, FlyControls, FirstPersonControls, TrackballControls, ArcballControls, DragControls, PointerLockControls, TransformControls; damping, target focal point, and integration with the animation loop. Use for editor-style navigation and gizmos—not a full game character controller stack; pair with Raycaster selection patterns in threejs-objects when transforming selections.
- Author
- full-stack-skills ↗
- Repository
- threejs-skills ↗
- Licence
- Apache-2.0
- Last repository change
- 04.10.2026
Assessment and security
- Files in this package
- 3
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 9
No signals detected. Repository changed on 04.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
Addon camera and object manipulation controls: OrbitControls, MapControls, FlyControls, FirstPersonControls, TrackballControls, ArcballControls, DragControls, PointerLockControls, TransformControls; damping, target focal point, and integration with the animation loop. Use for editor-style navigation and gizmos—not a full game character controller stack; pair with Raycaster selection patterns in threejs-objects when transforming selections.
Original author description
Addon camera and object manipulation controls: OrbitControls, MapControls, FlyControls, FirstPersonControls, TrackballControls, ArcballControls, DragControls, PointerLockControls, TransformControls; damping, target focal point, and integration with the animation loop. Use for editor-style navigation and gizmos—not a full game character controller stack; pair with Raycaster selection patterns in threejs-objects when transforming selections.
How it works
- When to use this skill
- How to use this skill
- Doc map (official)
- Scope
- Common pitfalls and best practices
- Documentation and version
- Agent response checklist
- References
- Keywords
SKILL.md preview
--- name: threejs-controls license: Apache-2.0 description: "Addon camera and object manipulation controls: OrbitControls, MapControls, FlyControls, FirstPersonControls, TrackballControls, ArcballControls, DragControls, PointerLockControls, TransformControls; damping, target focal point, and integration with the animation loop. Use for editor-style navigation and gizmos—not a full game character controller stack; pair with Raycaster selection patterns in threejs-objects when transforming selections." --- ## When to use this skill **ALWAYS use this skill when the user mentions:** - Orbiting/panning/dolly around a target, inertia/damping, min/max distance/polar angles - Map-like pan (MapControls) or flying (FlyControls) - Transform gizmo translate/rotate/scale with `TransformControls` - Dragging objects in plane (DragControls), pointer lock FPS (PointerLockControls) **IMPORTANT: controls vs webxr** | Context | Skill | |---------|--------| | Desktop/browser camera nav | **threejs-controls** | | XR controller poses | **threejs-webxr** | **Trigger phrases include:** - "OrbitControls", "TransformControls", "MapControls", "PointerLockControls" - "轨道", "变换控制器", "漫游" ## How to use this skill 1. **Import** from addons path (**threejs-dev-setup**). 2. **Construct** with `(camera, domElement)`; for `TransformControls` also attach to renderer events. 3. **Animation loop**: when `enableDamping`, call `controls.update()` each frame. 4. **TransformControls**: wire `dragging-changed` to disable Orbit temporarily; sync with selection from **threejs-objects**. 5. **Constraints**: set min/max distance/angles to avoid flipping or underground views. 6. **Dispose**: `controls.dispose()` when tearing down. See [examples/workflow-orbit-damping.md](examples/workflow-orbit-damping.md). ## Doc map (official) | Docs section | Representative links | |--------------|----------------------| | Controls | https://threejs.org/docs/OrbitControls.html | | Controls | https://threejs.org/docs/TransformControls.html | | Controls | https://threejs.org/docs/MapControls.html | | Controls (index) | https://threejs.org/docs/#Controls | ## Scope - **In scope:** Official addons controls usage patterns. - **Out of scope:** Full physics character motor; mobile gesture frameworks. ## Common pitfalls and best practices - Forgetting `update()` with damping enabled causes drift never settling. - TransformControls fighting with Orbit—pause one while using the other. - Pointer lock requires user gesture and exit handling. ## Documentation and version Controls are under [Controls](https://threejs.org/docs/#Controls) (Addons) in [three.js docs](https://threejs.org/docs/). API details (`enableDamping`, events) evolve—link `OrbitControls` / `TransformControls` pages for the user’s three.js version. ## Agent response checklist When answering under this skill, prefer responses that: 1. Link the specific controls class from the docs. 2. State `controls.update()` when damping is on, every frame. 3. Coordinate `TransformControls` with selection / **threejs-objects** raycasting. 4. Separate desktop navigation from **threejs-webxr** locomotion. 5. Call `dispose()` on controls when unmounting canvas. ## References - https://threejs.org/docs/#Controls - https://threejs.org/docs/OrbitControls.html - https://threejs.org/docs/TransformControls.html ## Keywords **English:** orbitcontrols, transformcontrols, mapcontrols, damping, camera controls, three.js **中文:** OrbitControls、轨道、TransformControls、变换控制器、阻尼、three.js
Files in this package (3)
- SKILL.md 4 KB
- agents/openai.yaml 1 KB
- examples/workflow-orbit-damping.md 1 KB
Versions
The database has no other skills named threejs-controls.
Database snapshot: 13.11.2026 · package version b72c6b1a462f (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100threejs-syntax-controls
Use when adding camera controls to a Three.js scene: orbit, pan, zoom, fly, first-person, or object manipulation. Prevents the common mistake of forgetting controls.update() in the render loop, not calling dispose(), or mixing controls. Covers OrbitControls, MapControls,… - 100threejs-interaction
Implement and debug Three.js interaction with Raycaster, pointer and touch coordinate conversion, hover/selection state, camera controls, dragging, keyboard input, and world-to-screen projection. Use when picking objects, adding OrbitControls or PointerLockControls, handling… - 100threejs-fundamentals
Three.js core knowledge base — scene, camera, renderer, geometries, materials, lights, GLTF loader, OrbitControls, raycaster, render loop, resize handling. Use when starting a vanilla Three.js scene, debugging WebGL context, integrating Three.js without React, or learning the… - 100threejs-interaction
Three.js interaction - raycasting, controls, mouse/touch input, object selection. Use when handling user input, implementing click detection, adding camera controls, or creating interactive 3D experiences. - 100threejs-interaction
Picking with raycasting, camera controls, transform gizmos, drag, hover and box selection for three.js, identical under WebGL and WebGPU. Use when handling mouse, touch or keyboard input, detecting clicks on 3D objects, adding camera controls, or making scene objects interactive. - 100threejs-objects
three.js scene graph objects: Object3D transforms and hierarchy, Group, Mesh, InstancedMesh, SkinnedMesh, BatchedMesh, LOD, Line/LineLoop/LineSegments, Points, Sprite, Bone, Skeleton, ClippingGroup; interaction via Raycaster, Layers masks, and EventDispatcher patterns. Merges…