# babylonjs > > We recommend using the [ES6 package `@babylonjs/core`](https://www.npmjs.com/package/@babylonjs/core) for new projects. This UMD package is provided for compatibility. Latest version **9.27.0** (published 2026-09-17) · Apache-2.0 license · 0 weekly downloads ## Install ```sh npm install babylonjs pnpm add babylonjs yarn add babylonjs bun add babylonjs ``` ## Health **Score 63/100 (C)** — status: active. Positive: has types package; no vulnerabilities; recently updated; high maintenance score; popular repo. Warnings: low downloads; no esm support. ## Facts | | | |---|---| | Version | 9.27.0 | | Published | 2026-09-17 | | First published | 2014-03-12 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | separate (@types/babylonjs) | | Module format | CommonJS | | Dependencies | 0 | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 26070 | | Maintainers | raananw, microsoft1es, microsoft-oss-releases, vicentecartas, sebavan, ryantrem | | Keywords | 3D, javascript, html5, webgl, babylon.js | ## Links - npm: https://www.npmjs.com/package/babylonjs - Repository: https://github.com/BabylonJS/Babylon.js - Homepage: https://www.babylonjs.com - Issues: https://github.com/BabylonJS/Babylon.js/issues - npm.io page: https://npm.io/package/babylonjs ## Alternatives - [@tsparticles/shape-image](https://npm.io/package/@tsparticles/shape-image.md) — 303.7K weekly downloads - [@tsparticles/shape-line](https://npm.io/package/@tsparticles/shape-line.md) — 233.7K weekly downloads - [stringify-attributes](https://npm.io/package/stringify-attributes.md) — 58.6K weekly downloads - [mobile-drag-drop](https://npm.io/package/mobile-drag-drop.md) — 46.3K weekly downloads - [@comunica/actor-rdf-parse-html](https://npm.io/package/@comunica/actor-rdf-parse-html.md) — 29.2K weekly downloads ## Recent versions - 9.27.0 (latest) — 2026-09-17 - 5.0.0-rc.13 (preview) — 2022-03-29 - 9.26.2 — 2026-09-16 - 9.26.1 — 2026-09-14 - 9.26.0 — 2026-09-10 - 9.25.0 — 2026-09-03 - 9.23.0 — 2026-08-27 - 9.22.2 — 2026-08-24 - 9.22.1 — 2026-08-20 - 9.22.0 — 2026-08-20 - 9.21.2 — 2026-08-14 - 9.21.1 — 2026-08-13 - 9.21.0 — 2026-08-13 - 9.20.1 — 2026-08-12 - 9.20.0 — 2026-08-06 - … 924 more at https://npm.io/package/babylonjs/versions ## README # Babylon.js Getting started? Play directly with the Babylon.js API using our [playground](https://playground.babylonjs.com/). It also contains a lot of samples to learn how to use it. [![npm version](https://badge.fury.io/js/babylonjs.svg)](https://badge.fury.io/js/babylonjs) [![Build Status](https://dev.azure.com/babylonjs/ContinousIntegration/_apis/build/status/CI?branchName=master)](https://dev.azure.com/babylonjs/ContinousIntegration/_build/latest?definitionId=14&branchName=master) [![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/BabylonJS/Babylon.js.svg)](http://isitmaintained.com/project/BabylonJS/Babylon.js "Average time to resolve an issue") [![Percentage of issues still open](https://isitmaintained.com/badge/open/babylonJS/babylon.js.svg)](https://isitmaintained.com/project/babylonJS/babylon.js "Percentage of issues still open") ![Build size](https://img.shields.io/bundlephobia/minzip/babylonjs) [![Twitter](https://img.shields.io/twitter/follow/babylonjs.svg?style=social&label=Follow)](https://twitter.com/intent/follow?screen_name=babylonjs) ![Discourse users](https://img.shields.io/discourse/users?server=https%3A%2F%2Fforum.babylonjs.com) **Any questions?** Here is our official [forum](https://forum.babylonjs.com/). ## CDN > ⚠️ WARNING: The CDN should not be used in production environments. The purpose of our CDN is to serve Babylon packages to users learning how to use the platform or running small experiments. Once you've built an application and are ready to share it with the world at large, you should serve all packages from your own CDN. - - For the preview release, use the following URLs: - - A list of additional references can be found [here](https://doc.babylonjs.com/divingDeeper/developWithBjs/frameworkVers#cdn-current-versions). ## npm BabylonJS and its modules are published on npm with full typing support. To install, use: ```text npm install babylonjs --save ``` > alternatively, you can now rely on our [ES6 packages](https://doc.babylonjs.com/setup/frameworkPackages/npmSupport#es6). Using the ES6 version will allow tree shaking among other bundling benefits. This will allow you to import BabylonJS entirely using: ```javascript import * as BABYLON from 'babylonjs'; ``` or individual classes using: ```javascript import { Scene, Engine } from 'babylonjs'; ``` If using TypeScript, don't forget to add 'babylonjs' to 'types' in `tsconfig.json`: ```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](https://www.npmjs.com/~babylonjs). ## Usage See [Getting Started](https://doc.babylonjs.com/#getting-started): ```javascript // 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 using the SphereBuilder var sphere = BABYLON.MeshBuilder.CreateSphere('sphere1', {segments: 16, diameter: 2, sideOrientation: BABYLON.Mesh.FRONTSIDE}, scene); // Move the sphere upward 1/2 of its height sphere.position.y = 1; // Create a built-in "ground" shape; var ground = BABYLON.MeshBuilder.CreateGround("ground1", { width: 6, height: 6, subdivisions: 2, updatable: false }, scene); // 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(); }); ``` ## Contributing If you want to contribute, please read our [contribution guidelines](https://doc.babylonjs.com/contribute/toBabylon) first. ## Documentation - [Documentation](https://doc.babylonjs.com) - [Demos](https://www.babylonjs.com/community/) ## Useful links - Official web site: [www.babylonjs.com](https://www.babylonjs.com/) - Online [playground](https://playground.babylonjs.com/) to learn by experimentating - Online [sandbox](https://www.babylonjs.com/sandbox) where you can test your .babylon and glTF scenes with a simple drag'n'drop - Online [shader creation tool](https://cyos.babylonjs.com/) where you can learn how to create GLSL shaders - 3DS Max [exporter](https://github.com/BabylonJS/Exporters/tree/master/3ds%20Max) can be used to generate a .babylon file from 3DS Max - Maya [exporter](https://github.com/BabylonJS/Exporters/tree/master/Maya) can be used to generate a .babylon file from Maya - Blender [exporter](https://github.com/BabylonJS/BlenderExporter) can be used to generate a .babylon file from Blender 3d - Unity 5[ (deprecated) exporter](https://github.com/BabylonJS/Exporters/tree/master/Unity) can be used to export your geometries from Unity 5 scene editor(animations are supported) - [glTF Tools](https://github.com/KhronosGroup/glTF#gltf-tools) by KhronosGroup ## Features To get a complete list of supported features, please visit our [website](https://www.babylonjs.com/specifications/). --- _Source: https://npm.io/package/babylonjs · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._