Capture Performance Profiles

DANGER

Currently, Superluminal is only available for Windows. If you are using a linux server, you can set up a temp windows server to capture the profile. Superluminal is planning on adding linux support in the future.

Superluminal is a powerful tool that allows you to capture performance profiles for your server. This can help you identify performance bottlenecks and optimize your server for better performance and also provides us information to help you better regarding performance issues.

Below are the steps to capture a performance profile using Superluminal:

Setup Superluminal

1. Download SuperluminalCmd.zip here.
2. Extract it to a folder anywhere on your computer. Just make sure it's easy to access; e.g. C:\Superluminal.
3. Ensure everything is extracted correctly and you have the SuperluminalCmd.exe file in the folder.

Capture Performance Profile

1. Open Command Prompt or Terminal as an administrator.
2. Navigate to the folder where you extracted Superluminal. You can do this by running the following command (for our example, we extracted it to C:\Superluminal):

cd /D "C:\Superluminal"

3. Run the Path of Titans server as specified in the Running the Server guide.
4. Wait until the server starts lagging or has performance issues. You do not want to do a capture for a long time, as it will generate a large file.
5. Once you have experienced the performance issue, start a capture by running the following command in the terminal window earlier:

SuperluminalCmd attach windows --process-name PathOfTitansServer-Win64-Shipping

TIP

If you are running more than one server process at a time and need to attach to a specific server process, you can specify this command instead:

SuperluminalCmd attach windows --process-id 2045

Replace 2045 with the process ID of the server you want to capture. You can find the process IDs in Task Manager.

WARNING

Please note players in-game may experience more lag while the capture is running.

6. Here is what the output will look like, keep the capture running for at least 1-2 minutes and stop it. Again, please take care to not capture for too long otherwise the capture will be too large and have performance problems and issues loading / saving it.

C:\Superluminal>SuperluminalCmd attach windows --process-name PathOfTitansServer-Win64-Shipping
Capture started. Press:
- s to stop capturing
- ctrl+c to cancel
Capture in progress: 2s 996ms (99.00 MiB)

7. Once you have captured the performance profile, you can stop the capture by pressing s and it should display the following message:

Capture stopped -- writing profile information to disk -

8. With the capture profile, you can upload it to a file sharing site like dropbox and send us a link to the file through support ticket or the channel you are using to get server-related support.

INFO

Alternatively, if you are not already paying for a file storage service, we can give you a place to upload these files. Please notify the support team if you need this.

Details

Final output should look like this:

Capture in progress: 43s 578ms (1.24 GiB)
Capture stopped -- writing profile information to disk [Done]
Capture was successfully written to 'C:\Superluminal\2024-11-11_15-45-34_PathOfTitansServer-Win64-Shipping.etl'