Using the Virtual File System - Lumberyard User Guide

Using the Virtual File System

If you're a developer who frequently changes assets, the Virtual File System (VFS) might help your work flow. In this environment, the Asset Processor serves all asset files to the running application. If assets are modified, they reload without you restarting the application.

To set up VFS

  1. Navigate to the lumberyard_version/dev directory.

    In a text editor, open thebootstrap.cfg and set remote_filesystem to 1. This causes the runtime to turn on VFS.

  2. Enter the following values.

    remote_ip= connect_to_remote=1 wait_for_connect=0
  3. (Optional) To send traffic to the shader compiler through VFS, edit the dev/system_android_es3.cfg file and set r_AssetProcessorShaderCompiler to 1.

  4. Build the APK as you normally would.

  5. If you haven't already, enable asset building for Android. See Preparing Your Assets for Android.

  6. Start Asset Processor.

  7. To tell your Android device to send traffic to Asset Processor, enter the following command.

    adb reverse tcp:45643 tcp:45643

Running the VFS

After you set up VFS, run it for your game project.

To run the VFS build

  • Launch your game by doing one of the following:

    • On your device's home screen, tap the app icon.

    • Use the Android Studio Debugger.


To verify a connection from PC-GAME with the es3 platform, click the Connections tab in Asset Processor. Server files from your PC can affect load time, so it might take a few moments for the game to appear.