Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
53 lines (27 sloc) 1.98 KB

How to build

Building on Windows

Download premake 5 and copy the premake5 executable somewhere in your path. Please make sure you have at least premake5 alpha 10.

You need Visual Studio to build the source code. If you don't have Visual Studio 2015 you can download the community edition for free.

Once you have Visual Studio installed, go to the command line under the directory and type:

premake5 solution

This creates netcode.sln and opens it in Visual Studio for you.

Now you can build the library and run individual test programs as you would for any other Visual Studio solution.

Building on MacOS and Linux

First, download and install premake 5.

Next, install libsodium.

On MacOS X, this can be done most easily with brew install libsodium.

If you don't have Brew, you can install it from

On Linux, depending on your particular distribution there may be prebuilt packages for libsodium, or you may have to build from source from here libsodium.

Now go to the command line under the directory and enter:

premake5 gmake

Which creates makefiles which you can use to build the source via:

make all

Alternatively, you can use the following shortcuts to build and run test programs directly:

premake5 test           // build and run unit tests

premake5 server         // build run a server on localhost on UDP port 40000

premake5 client         // build and run a client that connects to the server running on localhost 

premake5 stress         // connect 256 clients to a running server as a stress test

If you have questions please create an issue at and I'll do my best to help you out.


  • Glenn