Skip to content
Babylon.js is a powerful, beautiful, simple, and open, game and rendering engine packed into a friendly JavaScript framework.
Tree: 17de6fe4be
Clone or download
sebavan Merge pull request #6426 from sebavan/master
Rename indice to index of refraction
Latest commit 17de6fe May 31, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update Jan 31, 2019
.vscode Nightly Apr 23, 2019
Exporters Moved Exporters to Oct 14, 2017
Playground Nightly May 29, 2019
Tools Merge pull request #6334 from TrevorDev/nodeEditorFHL May 13, 2019
Viewer v4.0.0 Apr 30, 2019
assets Move logo to pg as well Apr 22, 2019
dist Nightly May 31, 2019
gui Fix line GUI + add more options to inspector May 17, 2019
inspector Rename indice to index of refraction May 31, 2019
loaders Fix typo from commit 7fcf5f5 May 20, 2019
localDev Fix Sheen BRDF Mar 7, 2019
materialsLibrary Rename indice to index of refraction May 31, 2019
nodeEditor Fix several UI bugs May 24, 2019
postProcessLibrary First pass for ocean post-process Feb 1, 2019
proceduralTexturesLibrary Merge remote-tracking branch 'upstream/master' into libToModules Jan 7, 2019
sandbox Fix #6320 May 7, 2019
serializers dont remove texture if texture coords are not present May 22, 2019
src Rename indice to index of refraction May 31, 2019
tests Fix instanced bones (hopefully) May 25, 2019
.gitattributes Ignore whitespace and new lines from windows OS Nov 25, 2015
.gitignore gitIgnore fix Feb 22, 2019
.travis.yml Test Feb 14, 2019
CNAME Create CNAME May 4, 2018
azure-pipelines.yml Up memory TS 3.4.5 May 14, 2019
bower.json Starting blocks for nodeEditor Mar 21, 2019 Update Dec 8, 2018
favicon.ico Browser stack readyness Jan 5, 2018 Moved license to a separate file Jun 23, 2017
package.json Nightly May 31, 2019 Break Down Mesh Builder Dependency Jan 15, 2019 Update Apr 30, 2019
tsconfigRules.json Build fixes and add default num workers Mar 26, 2019
tslint.json Full build Sep 26, 2018
what's update correct whats new Mar 19, 2019


Getting started? Play directly with the Babylon.js API using our playground. It also contains a lot of samples to learn how to use it.

npm version Build Status Average time to resolve an issue Percentage of issues still open Build Size Twitter

Any questions? Here is our official forum.


Additional references can be found on where xxx is the folder structure you can find in the /dist folder like

For the preview release, use the following URLs:

Additional references can be found on where xxx is the folder structure you can find in the /dist/preview release folder like


BabylonJS and its modules are published on npm with full typing support. To install, use:

npm install babylonjs --save

This will allow you to import BabylonJS entirely using:

import * as BABYLON from 'babylonjs';

or individual classes using:

import { Scene, Engine } from 'babylonjs';

If using TypeScript, don't forget to add 'babylonjs' to 'types' in tsconfig.json:

    "types": [

To add a module, install the respective package. A list of extra packages and their installation instructions can be found on the babylonjs user on npm.


See Getting Started:

// Get the canvas DOM element
var canvas = document.getElementById('renderCanvas');
// Load the 3D engine
var engine = new BABYLON.Engine(canvas, true, {preserveDrawingBuffer: true, stencil: true});
// CreateScene function that creates and return the scene
var createScene = function(){
    // Create a basic BJS Scene object
    var scene = new BABYLON.Scene(engine);
    // Create a FreeCamera, and set its position to {x: 0, y: 5, z: -10}
    var camera = new BABYLON.FreeCamera('camera1', new BABYLON.Vector3(0, 5, -10), scene);
    // Target the camera to scene origin
    // Attach the camera to the canvas
    camera.attachControl(canvas, false);
    // Create a basic light, aiming 0, 1, 0 - meaning, to the sky
    var light = new BABYLON.HemisphericLight('light1', new BABYLON.Vector3(0, 1, 0), scene);
    // Create a built-in "sphere" shape; its constructor takes 6 params: name, segment, diameter, scene, updatable, sideOrientation
    var sphere = BABYLON.Mesh.CreateSphere('sphere1', 16, 2, scene, false, BABYLON.Mesh.FRONTSIDE);
    // Move the sphere upward 1/2 of its height
    sphere.position.y = 1;
    // Create a built-in "ground" shape; its constructor takes 6 params : name, width, height, subdivision, scene, updatable
    var ground = BABYLON.Mesh.CreateGround('ground1', 6, 6, 2, scene, false);
    // Return the created scene
    return scene;
// call the createScene function
var scene = createScene();
// run the render loop
// the canvas/window resize event handler
window.addEventListener('resize', function(){

Preview release

Preview version of 4.1 can be found here. If you want to contribute, please read our contribution guidelines first.



Please see the Contributing Guidelines

Useful links

  • Official web site:
  • Online playground to learn by experimentating
  • Online sandbox where you can test your .babylon and glTF scenes with a simple drag'n'drop
  • Online shader creation tool where you can learn how to create GLSL shaders
  • 3DS Max exporter can be used to generate a .babylon file from 3DS Max
  • Maya exporter can be used to generate a .babylon file from 3DS Max
  • Blender exporter can be used to generate a .babylon file from Blender 3d
  • Unity 5 (deprecated) exporter can be used to export your geometries from Unity 5 scene editor(animations are supported)
  • glTF Tools by KhronosGroup


To get a complete list of supported features, please visit our website.


Babylon.js is automatically built using Gulp. Further instructions can be found in the documentation or in the readme at /Tools/Gulp.

You can’t perform that action at this time.