When I decided to create GDX-Proto, I had been playing with libgdx's 3D API for about 6 months on and off. I often see libgdx users at a loss when it comes to starting with 3D. The 2D side of libgdx is well documented and has many examples and tutorials, but when it comes to 3D, there are much less resources available (side note: Xoppa's 3D tutorial series are a must read!)
I made GDX-Proto to show how one might implement all the basic pieces you need to create a simple FPS (first person shooter) with libgdx. I don't recommend using GDX-Proto to create a game, since it might be a little rough in some areas, but I think it is a great resource to see how one could implement physics, graphics, and networking for a 3d game.
A pre-built jar of the desktop demo can be downloaded here.
Android APK The apk is currently setup just to launch a localclient
To play a simple local, singleplayer demo run the
desktop:run gradle task
There are also many command line options available, such as setting screen size, starting a server, choosing what hostname to connect to, etc. To see a full list:
desktop:dist gradle task to create the desktop jar.
the desktop jar file should be located in:
Then run the desktop jar with the command argument
To start a local, non-networked single-player demo:
java -jar desktop.jar
To start a server:
java -jar desktop.jar -s
To start a server and connect to it yourself:
java -jar desktop.jar -s -c
To connect to an online server, www.example.com, port 19000:
java -jar desktop.jar -c -a "www.example.com" -p 19000
If you wish to run a headless server, run the
:headless:dist gradle task, and run:
java -jar headless.jar -s
Here is an example usage output, but for a more up-to-date version run -h on the command line.
-a,--address <arg> supply hostname address to connect to -c,--client connect to server as a client -d,--lag-delay <arg> simulate lag with argument = milliseconds of lag -h,--help print help -p,--port <arg> specify TCP port to either host on (server) or connect to (client) -s,--server start online server -z,--screensize <arg> suppley screen size in the form of WIDTHxHEIGHT, i.e. 1920x1080
Contributions are welcome! If you have a large contribution you wish to make, make an issue first for discussion to make sure it's something that could be included in the project.