Relocate Neos Folders

From Neos Wiki
Jump to navigation Jump to search
Other languages:
English • ‎日本語


Neos has two locations, outside of the main installation directory which store files that help Neos run:

  1. Cache - Store's temporary copies of assets downloaded while you are using Neos.
  2. Database/Data - Stores a local copy of your items and things that you are working on, your login status and settings.

Folder Default Locations

Cache

By default the cache can be found in: %USERPROFILE%\AppData\Local\Temp\Solirax\NeosVR

To get there easily:

  1. Push Windows Key + R
  2. Type/Copy this %USERPROFILE%\AppData\Local\Temp\Solirax\NeosVR into the Run box that appears
  3. Press Enter or the Ok button

Database/Data

By default the data folder can be found in: %USERPROFILE%\AppData\LocalLow\Solirax\

To get there easily:

  1. Push Windows Key + R
  2. Type/Copy this %USERPROFILE%\AppData\LocalLow\Solirax\ into the Run box that appears
  3. Press Enter or the Ok button


If you have a unique drive setup, or want more control about where these files are stored, then this guide is for you.

Relocating these folders

The following steps have the potential for data loss so please be careful.

Preparations

As these folders refer to each other in some places, it is best to start fresh with no existing contents when relocating these folders. This will result in a smoother experience but will result in some data loss unless these preparations are followed:

  1. Ensure that your Neos reports "All Synced" at the top centre of your dash.
  2. If you have anything saved in your Local Home, make sure it is backed up to your cloud home.
  3. Take a note of your settings, in the settings tab. Some of these will reset.
  4. Make sure you have your username and password to hand, you will be logged out.
  5. If you use 2FA for logging in, make sure you have your device handy, you'll need it to login.

Adding command line arguments

To relocate these folders to another location:

  1. Add either of the following command line flags to Neos(following the instructions below) to relocate the folders:
    • -DataPath path_here - Instructs Neos to use the location you specify for the Data folder. Any absolute path syntax supported by the underlying platform's file system libraries can be used here, such as DOS-style or UNC paths.
    • -CachePath Insert_filepath_here - Instructs Neos to use the location you specify for the 'Cache folder. Any absolute path syntax supported by the underlying platform's file system libraries can be used here, such as DOS-style or UNC paths.
  2. Leave these in the command line arguments, permanently or Neos will go back to using the default locations

Entering these command line arguments, differs depending on your platform.

For the Steam build

  1. Open Steam
  2. Right click on Neos VR in your library
  3. Select "Properties" and then "Set Launch Options".
  4. Enter the command you chose, exactly as it appears above and Run Neos.

Setting custom launch options via Steam

Now, if Neos is launched via Steam, the custom launch commands will take effect.

Commands entered via this method will not take effect if Neos is launched any other way, such as via the Neos Launcher or by directly launching the Neos.exe.


For the Standalone build

You have two options:

Using the Neos Launcher

  1. Find the Neos Launcher for the standalone. You can do this by double clicking on the NeosLauncher.exe in the NeosVR install folder
  2. Check the "Use custom bootstrap class" option
  3. Enter your command line arguments in the box below this checkbox.

NeosLauncherCommandLineArguments.png

Launch arguments entered this way will only take effect if the Neos Launcher is used to start Neos.

Use a shortcut

It is possible to use launch commands via a custom shortcut targeting the Neos.exe file.

To create a shortcut:

  1. Find the Neos install folder and right-click on the Neos.exe.
  2. In the context menu click 'Create Shortcut'
  3. Move the 'Neos.exe - Shortcut' file to somewhere more convenient (such as the Desktop).
  4. Right-click on the shortcut file and click 'Properties' in the context menu.
  5. This opens a dialog window. Select the 'Shortcut' tab.
  6. In the 'Target' text box add a space after the Neos.exe filepath and then add your command line arguments.
  7. Click 'Apply' and 'OK'.

Now, if Neos is launched by double clicking on the shortcut it will launch using the custom options. These will not be applied if a different method is used to start Neos.

Setting custom launch options for a Shortcut

There is also a tutorial by ProbablePrime.


Cleaning Up

You can delete the old location's folders once the new locations are in use.