vertx-game-server - GitLite

KO | EN

gitlite — search

#python #react #ai #llm #go #nodejs #windows #awesome #cli #vue #pytorch #mcp #ios #openai

vertx-game-server

(★ 124)

Keynote Demo 2016 Balloon Vert.x Game Engine/Service

File Explorer

Download Latest Version (.zip)

.gitignore
Dockerfile
drools-score-summary.json
drools-score.json
pom.xml
README.md

# Installation Guide

1. Get the code

git clone https://github.com/burrsutter/vertx-game-server

Downloads the entire project code from GitHub to your computer.

cd vertx-game-server

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

docker build -t vertx-game-server .

Builds a runnable image based on the Dockerfile.

docker run -p 8080:80 vertx-game-server

Runs the built image as an actual container.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

3. Maven (Java)

Medium

Prerequisites

Git Needed to download the project code from GitHub.
JDK (Java) Required to build and run Java projects.
Maven The build tool used for the mvn command.

mvn clean package -DskipTests

Installs dependencies and builds the project using Maven.

mvn compile exec:exec@run

Installs dependencies and builds the project using Maven.

vertx run src/main/java/com/redhat/middleware/keynote/MainVerticle.java -cluster -cp target/game-service.jar --redeploy=src/main/**/* --launcher-class=io.vertx.core.Launcher --on-redeploy="mvn compile package -DskipTests"

Installs dependencies and builds the project using Maven.

✅ A BUILD SUCCESS message means it worked. The output is created under target/.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Vert.x Game Server

This project is an implementation of the Game server on top of Vert.x.

It provides the HTTP endpoints and websockets for the _game_ part of the demo.

## Structure

The projects is composed by 3 verticles:

* `MainVerticle` just deploys the 2 other verticles
* `ServerVerticle` creates a HTTP server and manage HTTP requests and web sockets, data is computed by the `GameVerticle`
* `GameVerticle` manages the game. It is written in Groovy
 
This architecture lets us increase the number of instances of the `GameVerticle` to face the load. The `ServerVerticle` and `GameVerticle` are communicating using the event bus. So, potentially, the `GameVerticle` instances can be located on different computers.

## Build and Run

```
mvn clean package -DskipTests
```

It generates a _fat jar_ in `target`:  ` game-service-1.0.0-SNAPSHOT-fat.jar`

Launch it with: `java -jar target/game-service-1.0.0-SNAPSHOT-fat.jar - cluster`

Tests are simulating a couple of loads, so may takes a bit of time to run.

## Fast run for dev

```
mvn compile exec:exec@run
```

## Redeploy for Dev

```
vertx run src/main/java/com/redhat/middleware/keynote/MainVerticle.java -cluster -cp target/game-service.jar --redeploy=src/main/**/* --launcher-class=io.vertx.core.Launcher --on-redeploy="mvn compile package -DskipTests"
```

## Configuration

You can pass a configuration object using: `-conf my-configuration.json`.

This configuration can contain:

* `game-verticle-instances` : the number of `GameVerticle` instances, 1 by default, can be 0
* `server-verticle-instances` : the number of `ServerVerticle` instances, 4 by default, can be 0
* `port`: the HTTP server port, `9001` by default
* `number-of-teams`: the number of teams, 4 by default
* `score-broadcast-interval`: the period in ms between 2 score broadcast, 2500 by default

export ACHIEVEMENTS_SERVER=localhost
export ACHIEVEMENTS_SERVER_PORT=9090
export SCORE_SERVER=localhost
export SCORE_SERVER_PORT=8080
export SCORE_USER=kiewb
export SCORE_PASSWORD=kiewb