Headless (server) mode support

Modified on Fri, 19 Mar 2021 at 04:47 PM

Watch the full tutorial:





In headless mode, the game runs without any kind of rendering saving performace when running as a dedicated server.


To build the game in headless mode, enable the "Server Build" checkbox in Build Settings:



Mac OS users: On Mac server build, when you run the game, it keeps bouncing on the task bar as if it was hung. But it's working. Alternatively (on Mac), you can select the game build, right click -> Show Contents -> Mac OS folder and drag the executable to the terminal and run it from there where you will see logs.


Configuring the game through settings file


Since there's no menu visible to choose game settings in server mode, Pirates of Voxel Play can detect a configuration file named "server.config" at the same path than the executable.


This is an example of such file:


serverMode=1
cannibalsAmount=1
wildLifeAmount=1
birdsAmount=1
islandSize=1


The "serverMode" parameter can be 0 or 1. When building a headless server you must include this parameter and set it to 1.

Rest of parameters are optional and can be 0 (low or small), 1 (average) or 2 (high or big).




Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article