Skip to content
Skills Library
Programming · Building & coding

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.

Licence
Apache-2.0
Last repository change
04.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
9
Deprecation

No signals detected. Repository changed on 04.10.2026, without references to retired models or APIs.

Licence

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

  1. When to use this skill
  2. How to use this skill
  3. Doc map (official)
  4. Scope
  5. Common pitfalls and best practices
  6. Documentation and version
  7. Agent response checklist
  8. References
  9. Keywords
Original SKILL.md headings · 79 lines, 335 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.