The Wayback Machine - https://web.archive.org/web/20190222124426/https://github.com/BabylonJS/Babylon.js
Skip to content
Please note that GitHub no longer supports Internet Explorer.

We recommend upgrading to the latest Microsoft Edge, Google Chrome, or Firefox.

Learn more
Babylon.js: a complete JavaScript framework for building 3D games with HTML 5 and WebGL http://www.babylonjs.com
Branch: master
Clone or download
Latest commit c405567 Feb 22, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update ISSUE_TEMPLATE.md Jan 31, 2019
.vscode Fixy Fixy Feb 10, 2019
Exporters Moved Exporters to https://github.com/BabylonJS/Exporters Oct 14, 2017
Playground Nightly Feb 21, 2019
Tools Fix #5941 Feb 19, 2019
Viewer update md file Feb 15, 2019
assets New BRDF Feb 8, 2019
dist Nightly Feb 21, 2019
gui nightly Feb 18, 2019
inspector added lensrenderingpipeline to inspector Feb 20, 2019
loaders Fix WebRequest references (There were quite a lot!) Feb 20, 2019
localDev Merge branch 'pickerdialog' into master Dec 6, 2018
materialsLibrary Update mixMaterial.ts Feb 11, 2019
postProcessLibrary First pass for ocean post-process Feb 1, 2019
proceduralTexturesLibrary Merge remote-tracking branch 'upstream/master' into libToModules Jan 7, 2019
sandbox not needed Feb 1, 2019
serializers Fix none relative imports Jan 29, 2019
src Try to fix tests Feb 22, 2019
tests Try to fix tests Feb 22, 2019
.gitattributes Ignore whitespace and new lines from windows OS Nov 25, 2015
.gitignore Update .gitignore Feb 20, 2019
.travis.yml Test Feb 14, 2019
CNAME Create CNAME May 4, 2018
bower.json Update bower.json to latest version Jan 2, 2017
contributing.md Update contributing.md Dec 8, 2018
favicon.ico Browser stack readyness Jan 5, 2018
license.md Moved license to a separate file Jun 23, 2017
package.json 4.0.0-alpha.28 Feb 20, 2019
readme-es6.md Break Down Mesh Builder Dependency Jan 15, 2019
readme.md Merge Jan 8, 2019
tsconfigRules.json Move manual tsc to prevent issues Dec 15, 2018
tslint.json Full build Sep 26, 2018
what's new.md Updated polgyonMesh.ts Feb 20, 2019

readme.md

Babylon.js

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.

CDN

Additional references can be found on https://cdn.babylonjs.com/xxx where xxx is the folder structure you can find in the /dist folder like https://cdn.babylonjs.com/gui/babylon.gui.min.js

For the preview release, use the following URLs:

Additional references can be found on https://preview.babylonjs.com/xxx where xxx is the folder structure you can find in the /dist/preview release folder like https://preview.babylonjs.com/gui/babylon.gui.min.js

npm

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": [
        "babylonjs",
        "anotherAwesomeDependency"
    ],
    ...

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.

Usage

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
    camera.setTarget(BABYLON.Vector3.Zero());
    // 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
engine.runRenderLoop(function(){
    scene.render();
});
// the canvas/window resize event handler
window.addEventListener('resize', function(){
    engine.resize();
});

Preview release

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

Documentation

Contributing

Please see the Contributing Guidelines

Useful links

  • Official web site: www.babylonjs.com
  • 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

Features

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

Build

Babylon.js is automatically built using Gulp. For further instructions see the readme at /Tools/Gulp.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.
Morty Proxy This is a proxified and sanitized view of the page, visit original site.