Skip to content

Getting Started with Schola

Install Prerequisites

While other Integrated Development Environments (IDEs) can be used, Visual Studio Code is recommended along with the C/C++ Extension Pack. Please see the Unreal Engine documentation for more information.

Install Schola

  1. Add Schola to a project as an Unreal Engine Plugin, either by downloading the source, or via git.
  1. Create a folder named Schola in the Plugins folder of your Unreal Engine project.
  2. Download the zipped source code from the Schola Repository
  3. Unzip the repository. Copy the contents of the Schola folder to the Schola folder you created in your project.

If you experience an error installing the repository with git due to a large file sizes, run the following command to increase the git buffer size:

Terminal window
git config –global http.postBuffer 524288000
  1. Make sure pip is updated before installing the schola python package from Plugins/Schola/Resources/python.
Terminal window
python -m pip install --upgrade pip
pip install ./Plugins/Schola/Resources/python[all]

Schola installs the cpu version of pytorch by default, to install other versions of pytorch follow the instructions at Pytorch Get Started.

To install Pytorch with ROCm on Linux, we recommend following the guide at Install Pytorch for Radeon GPUs.

  1. Using an editor of your choice, such as Visual Studio or Visual Studio Code compile the project source. The Schola plugin will not appear in the editor, or be useable until the project has been compiled.
  2. Launch your project as normal in Unreal Engine. You should see the Schola plugin in the Plugins section of the project settings.

Building 3rd-Party Dependencies for Schola (Optional)

Schola comes bundled with all of its c++ dependencies already. However, if you want to use a different version of a dependency, or unreal engine you may build them from source.

Building gRPC from source for Schola

  1. Install Prerequisites

While other Integrated Development Environments (IDEs) can be used, Visual Studio Code is recommended along with the C/C++ Extension Pack. Please see the Unreal Engine documentation for more information.

  1. Build gRPC using the scripts in /Resources/Build, by running the following from the Plugin Root Dir
Terminal window
# Install Required Packages for Running the Build Script
sudo apt update
sudo apt-get -y install cmake git automake autoconf libtool-bin pkg-config build-essential
# Change this to your Unreal Engine path
UE_ROOT="~/UnrealEngine/UE_5.5"
export UE_ROOT
bash ./Resources/Build/linux_dependencies.sh

Regenerated Protobuf and gRPC Code

  1. Follow the steps in the Building Schola from source section to build gRPC from source, and get an up to date version of protoc.exe.
  2. Run the following command to regenerate the protobuf and gRPC code.
Terminal window
python schola-build-proto --plugin-folder . --add-type-stubs

The —add-type-stubs flag is optional and will generate .pyi files for the generated code. This is useful for IDEs that support type stubs for better code completion. However, not all protobuf/gRPC features are supported in the .pyi files. If you encounter issues when generating try running without the flag.