사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/full-stack-skills/threejs-skills --skill threejs-objects시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
When to use this skill
ALWAYS use this skill when the user mentions:
- Parent/child relationships,
position/rotation/scale,matrixAutoUpdate,updateMatrixWorld - Choosing mesh types: static vs instanced vs skinned vs batched LOD
- Picking:
Raycaster.setFromCamera,intersectObjects, recursive flag, face/uv results - Layers: selective visibility for cameras/lights/objects
IMPORTANT: objects vs math
| Need | Skill |
|---|---|
| Scene graph + picking | threejs-objects |
| Box/ray math only | threejs-math |
Trigger phrases include:
- "Object3D", "InstancedMesh", "SkinnedMesh", "Raycaster", "layers"
- "父子节点", "射线拾取", "图层"
How to use this skill
- Compose scenes with
Groupand transforms; minimize deep hierarchies where possible. - Instancing: set per-instance matrices; understand
countand frustum culling behavior. - SkinnedMesh: bind skeleton; clips in threejs-animation; skinning material flags in threejs-materials.
- Picking: normalize device coords, set ray from camera, filter by layers, sort intersections.
- Events:
EventDispatcheron custom objects—patterns only, not DOM frameworks. - Clipping:
ClippingGroupusage per docs when user needs sectional cuts. - Dispose: geometries/materials/textures when removing objects permanently.
See examples/workflow-raycaster-pick.md.
Doc map (official)
| Docs section | Representative links |
|---|---|
| Core | https://threejs.org/docs/Object3D.html |
| Objects | https://threejs.org/docs/Mesh.html |
| Objects | https://threejs.org/docs/InstancedMesh.html |
| Core | https://threejs.org/docs/Raycaster.html |
Scope
- In scope: Object3D graph, renderable object types, raycasting, layers, dispatcher basics.
- Out of scope: Physics engines; XR input mapping (threejs-webxr).
Common pitfalls and best practices
- Forgetting
updateMatrixWorldbefore world-space ray tests on moved objects. - Raycaster without
layersset picks unintended objects—set masks consistently on camera and objects. - InstancedMesh raycast hits need per-instance handling—check docs for your version.
Documentation and version
Object3D, mesh types, Raycaster, and Layers are documented under Objects and Core in three.js docs. Behavior of picking and layers can shift slightly—link the exact page for the user’s three.js line.
Agent response checklist
When answering under this skill, prefer responses that:
- Link
Object3D,Mesh,InstancedMesh,Raycaster, orLayersas needed. - Pair skeletal animation with threejs-animation and skinned mesh setup.
- Route pure linear-algebra questions without a scene graph to threejs-math.
- Route XR input to threejs-webxr when sessions/controllers are involved.
- Mention
dispose()for geometries/materials when removing objects permanently.
References
- https://threejs.org/docs/Object3D.html
- https://threejs.org/docs/Raycaster.html
- https://threejs.org/docs/Layers.html
- https://threejs.org/docs/InstancedMesh.html
Keywords
English: object3d, mesh, instancedmesh, skinnedmesh, raycaster, layers, scene graph, three.js
中文: 场景图、Object3D、Mesh、实例化、骨骼网格、射线拾取、图层、three.js