Extensible Java-based server for games and realtime web applications

Serverville is an easy to setup self-contained java server that provides many backend features commonly needed by games, mobile applications and web services. The main features are:

• Authentication and session management
• Robust admin APIs
• Rich key-value data storage
• Virtual currencies
• Extensible via embedded javascript/typescript or external server processes
• Client-to-client realtime communication

Serverville requires Java 8 or later to run. It currently also requires a MySQL database

Building Serverville requires Apache Ant (So oldschool! How antique!)

In the root directory, type: ./build.sh

This will invoke Ant to build the Serverville jar and place it and all dependencies in ./build

Before Serverville is run, a MySQL schema must be created for it. To do this, create and empty schema and run ./src/sql/Schema.sql into it.

Next you must setup your serverville.properies and log4j2.xml config files. Copy the contents of ./sample-config to wherever you want Serverville's working directory to be, and edit serverville.properties to fill in your MySQL schema URL, username and password.

From your Serverville working directory, run java -jar serverville.jar and the server should either start up or tell you why it couldn't. In addition, runscripts are available in ./src/scripts to provide more robust examples of how to start and stop Serverville.

Coming someday to Serverville:

• Documentation!
• Clustering support
• Sharded MySQL support
• Durable caching layer to reduce database load
• Inventory support
• Admin website
• Remote javascript debugging