A-Frame Extras

Add-ons and helpers for A-Frame VR.

IMPORTANT: This project is not yet compatible with A-Frame 0.8.0. Stay tuned for the next (v4) release.

NOTE: The master branch contains changes that are not yet released or documented, and may be unstable. Documentation will also be different. Use v3.13.1 for the most recent stable version.

Includes components for controls, model loaders, pathfinding, and more:

src
├── controls/ (Documentation)
│   ├── checkpoint-controls.js
│   ├── gamepad-controls.js
│   ├── hmd-controls.js
│   ├── keyboard-controls.js
│   ├── mouse-controls.js
│   ├── touch-controls.js
│   └── universal-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-controller.js       
└── primitives/ (Documentation)
    ├── a-grid.js
    ├── a-hex-grid.js           
    ├── a-ocean.js
    └── a-tube.js

Usage (Scripts)

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/v3.13.1/dist/aframe-extras.min.js"></script>

CDN builds for aframe-extras/v3.13.1:

• 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 below.

A-Frame Version Compatibility

A-Frame	Extras
v0.5.X	aframe-extras/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.

Usage (NPM)

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.