Buildat

A small engine for networked 3D games.

The server runs C++ modules compiled at runtime. The client runs a whitelisted subset of Urho3D's Lua API in a sandbox; scripts and data come from the server.

Voxel worlds, replication, and worldgen are builtin modules. Nothing requires a block game. Digger is a finite voxel example. Infidigger streams an infinite world with the same modules.

Further reading:

• doc/design.txt
• doc/conventions.txt
• doc/client_api.txt
• doc/client_commands.txt
• doc/todo.txt

Buildat Linux How-To

Install dependencies

$ # Dependencies for Urho3D
$ sudo apt-get install libx11-dev libxrandr-dev libasound2-dev libgl1-mesa-dev
$ sudo yum install libX11-devel libXrandr-devel alsa-lib-devel

Build

Urho3D 1.7.1 is bundled in 3rdparty/Urho3D and is configured/built as part of this project (shared library, Lua, safe Lua). -DURHO3D_LIB_TYPE=SHARED is required for the module interface.

$ cd $wherever_buildat_is
$ mkdir Build  # Capital B is a good idea so it stays out of the way in tabcomplete
$ cd Build
$ cmake .. -DCMAKE_BUILD_TYPE=Debug  # Add -DURHO3D_64BIT=true on 64-bit systems
$ make -j4

You can use -DBUILD_SERVER=false or -DBUILD_CLIENT=false if you don't need the server or the client, respectively.

Optional: -DURHO3D_LUAJIT=TRUE builds the bundled LuaJIT instead of Lua. URHO3D_HOME still overrides the bundled tree if you need an external build.

Play

$ $wherever_buildat_is/Build/bin/buildat

Local game or connect to a server.

Server and client

For development or hosting, run the two binaries separately:

Terminal 1:

$ $wherever_buildat_is/Build
$ bin/buildat_server -m ../games/minigame

Terminal 2:

$ $wherever_buildat_is/Build
$ bin/buildat_client -s localhost

Client command sequence (CI / visual checks)

The client can run a one-shot command script and exit. Screenshots, delays, and injected keyboard/mouse input:

$ bin/buildat_client -c $'delay 2000\nscreenshot /tmp/menu.png'
$ bin/buildat_client -c @commands.txt

See doc/client_commands.txt.

Modify something and see stuff happen

Edit something and then restart the client (CTRL+C in terminal 2):

$ cd $wherever_buildat_is
$ vim games/minigame/main/client_lua/init.lua
$ vim games/minigame/main/main.cpp
$ vim builtin/network/network.cpp

Buildat Windows How-To

Use Mingw-w64 in an MSYS environment. Make sure to use a pthreads version of Mingw-w64. Windows threads are not supported ATM.

$ cd /path/to/buildat
$ mkdir Build
$ cd Build
$ cmake .. -G "MSYS Makefiles" -DCMAKE_BUILD_TYPE=Debug -DURHO3D_LUAJIT=TRUE
$ make -j4

Running the server:

$ bin/buildat_server.exe -m ../games/minigame -c "c++ -Lbin -lbuildat_server_core"