Troubleshooting

This page contains answers to common questions or issues that may occur as you try to develop HoloOcean.

I can’t open HoloOcean in Unreal Engine on Windows

Often, the issue is with the Visual Studio setup. Open the Visual Studio Installer and modify your Visual Studio setup. Please verify that you have all of the Unreal Engine requirements downloaded.

../_images/double-check-vs-setup.png

Try clicking on the holodeck.uproject file again and saying “yes” to rebuild if prompted.

If there is still an error, you will need to manually build the project in Visual Studio. Right click on the holodeck.uproject file and select “Generate Visual Studio project files.” Please see Compiling if you have issues opening the project in Visual Studio.

There are some errors in the Unreal Engine source code that also could be preventing issues. These files can be changed without affecting HoloOcean.

“Holodeck could not be compiled” on Linux

If you see the error below when opening HoloOcean on Linux:

  • “Missing Holodeck Modules” listing Holodeck, SonarHistogramModule, ShaderIncludePlugin

  • Rebuild results in: “Holodeck could not be compiled. Try rebuilding from source manually.”

It is very likely that your Linux Unreal Engine 5.3 download doesn’t include the ISPC compiler binary necessary for our new FFT-based ocean waves. To fix this you will need to install ISPC v1.18.0 manually, you can do this by following these instructions:

1. Download the Linux release

cd /tmp
wget https://github.com/ispc/ispc/releases/download/v1.18.0/ispc-v1.18.0-linux.tar.gz
tar -xzf ispc-v1.18.0-linux.tar.gz

This creates ispc-v1.18.0-linux/bin/ispc.

2. Copy it into your engine install

Replace <UE_ROOT> with the path to your Unreal Engine 5.3 install (the folder containing Engine/):

mkdir -p <UE_ROOT>/Engine/Source/ThirdParty/Intel/ISPC/bin/Linux/
cp /tmp/ispc-v1.18.0-linux/bin/ispc \
   <UE_ROOT>/Engine/Source/ThirdParty/Intel/ISPC/bin/Linux/ispc
chmod +x <UE_ROOT>/Engine/Source/ThirdParty/Intel/ISPC/bin/Linux/ispc

3. Verify it runs

<UE_ROOT>/Engine/Source/ThirdParty/Intel/ISPC/bin/Linux/ispc --version

Expected output:

Intel(r) Implicit SPMD Program Compiler (Intel(r) ISPC), 1.18.0 (build commit ... LLVM 13.0.1)

4. Rebuild Holodeck

cd <UE_ROOT>
./Engine/Build/BatchFiles/Linux/Build.sh HolodeckEditor Linux Development \
  -project="<PATH_TO_HOLODECK>/Holodeck.uproject" -Progress

Replace <PATH_TO_HOLODECK> with your HoloOcean project path.

You’re done! Reopen the project in the editor and it should load normally.

Note

This is a one-time setup step per engine install. You won’t need to repeat it unless you download a fresh copy of the engine.

None of my changes to code are showing up when I run HoloOcean

If you changed any c++ files, you must compile HoloOcean either from from the Unreal Engine editor, or from Visual Studio. Please see Compiling.

If you changed any python files, you must go to holoocean/client and run pip install .

I added new objects to my level but they don’t show up on sonar

First, make sure the proper collision settings are enabled. Please see Collision Settings for Objects and Sonar .

Also make sure to delete any octrees previously made for your level. Octrees need to be regenerated whenever new objects are added to an environment.