Add-ons and helpers for A-Frame VR.
Includes components for controls, model loaders, pathfinding, and more:
src ├── controls/ (Documentation) │ ├── movement-controls.js │ ├── checkpoint-controls.js │ ├── gamepad-controls.js │ ├── keyboard-controls.js │ ├── mouse-controls.js │ └── touch-controls.js ├── loaders/ (Documentation) │ ├── animation-mixer.js │ ├── fbx-model.js │ ├── gltf-model-legacy.js │ ├── json-model.js │ ├── object-model.js │ └── ply-model.js ├── misc/ (Documentation) │ ├── checkpoint.js │ ├── cube-env-map.js │ ├── grab.js │ ├── jump-ability.js │ ├── kinematic-body.js │ ├── mesh-smooth.js │ └── sphere-collider.js ├── pathfinding/ (Documentation) │ ├── nav-mesh.js │ └── nav-agent.js └── primitives/ (Documentation) ├── a-grid.js ├── a-hex-grid.js ├── a-ocean.js └── a-tube.js
In the dist/ folder, download any package(s) you need. Include the scripts on your page, and all components are automatically registered for you:
<script src="//cdn.rawgit.com/donmccurdy/aframe-extras/v4.1.3/dist/aframe-extras.min.js"></script>
CDN builds for aframe-extras/v4.1.3:
- aframe-extras.js (development)
- aframe-extras.min.js (production)
For partial builds, use a subpackage like aframe-extras.controls.min.js
. Full list of packages above.
A-Frame Version Compatibility
A-Frame | Extras |
---|---|
v0.8.X | aframe-extras/v4.1.3 |
v0.5.X | */v3.13.1 |
v0.4.X | */v3.3.0 |
v0.3.X | */v2.6.1 |
v0.2.X | */v1.17.0 |
NOTE: Several components and examples also rely on aframe-physics-system.
npm install --save aframe-extras
// index.js
require('aframe-extras');
Once installed, you'll need to compile your JavaScript using something like Browserify or Webpack. Example:
npm install -g browserify
browserify index.js -o bundle.js
bundle.js
may then be included in your page. See here for a better introduction to Browserify.