# Incremental Loading System

> Learn about the incremental loading system in Babylon.js.

Source: https://doc.babylonjs.com/features/featuresDeepDive/importers/incrementalLoading

## How To Use the Incremental Loading System

To support incremental loading (introduced in v1.5.0), go to [this page](https://github.com/BabylonJS/Exporters/tree/master/Tools/MakeIncremental) to get a tool that converts your .babylon file to a .incremental.babylon file alongside its associated resources (_.babylonmeshdata_ and _.babylongeometrydata_ files).

These files can be used just like a standard _.babylon_ scene except that they will allow **Babylon.js** to load meshes and textures on the fly. This means that the meshes and the textures will not be loaded at startup but only when they become active (when the active camera can see them).

You have to put the _.babylonmeshdata_ and _.babylongeometrydata_ files in the same folder as the _.incremental.babylon_ file.

You can find a demo of an incremental scene here: [Playground: Incremental Loading Example](https://playground.babylonjs.com/#JA1ND3#1017) - Simple Example of incremental loading assets.

## Detailed Step-by-Step

For users who are less experienced with command-line tools, here's a more detailed step-by-step guide to using the tool:

1. Get the Exporters project (by either using git or downloading the ZIP):
   ![Exporters project](https://doc.babylonjs.com/img/importers/incremental_loading/incr_step_1.webp "Babylon.js Exporters project")

2. Download and install [.NET Core 3.1](https://dotnet.microsoft.com/en-us/download/dotnet/3.1)

3. Open a command prompt (cmd.exe should do the trick) and navigate to the MakeIncremental directory:
   ![MakeIncremental directory](https://doc.babylonjs.com/img/importers/incremental_loading/incr_step_3.webp "Navigating to the MakeIncremental directory")

4. Type `dotnet build` at the command prompt:
   ![.NET build](https://doc.babylonjs.com/img/importers/incremental_loading/incr_step_4.webp "Building the project")

5. Navigate to the directory where the build files were written, `\bin\Debug\netcoreapp3.1\`:
   ![Build directory](https://doc.babylonjs.com/img/importers/incremental_loading/incr_step_5.webp "Navigating to the build directory")

6. Type the command `MakeIncremental.exe /i:my-scene.babylon`, where `my-scene.babylon` is the name of your scene (if your scene is named something else, just change what's after the `:` symbol):
   ![Run command](https://doc.babylonjs.com/img/importers/incremental_loading/incr_step_6.webp "Running the MakeIncremental command")

7. The script will generate quite a few files. You will need all of them except your original `my-scene.babylon`. Copy them to a directory your project can access (in this example, it's `/src`):
   ![Generated files](https://doc.babylonjs.com/img/importers/incremental_loading/incr_step_7.webp "Files generated by the MakeIncremental command")

8. And you're ready to load it into Babylon!

```javascript
await BABYLON.AppendSceneAsync("src/my-scene.incremental.babylon", scene);
console.log("My incremental file was loaded! WOHOO!");
```

## Node.js based incremental file converter

This script can be used to generate incremental files from Babylon scenes. It can be run directly from Node, or it can be integrated into build scripts. More information about how to install and configure the script can be found [here](https://www.npmjs.com/package/babylonjs-make-incremental).
