dice-tower/README.md
Arindy 4da0d7b1f0
All checks were successful
CI / deploy (push) Successful in 5m39s
CI / deploy (pull_request) Successful in 5m38s
caps the number of allowed dice
2025-02-22 13:53:49 +01:00

2.0 KiB

Dice-Tower

... they see them rolling ...

Dice-TowerKey FeaturesStart ContainerHow To Build from scratchCreditsLicense


Key Features

  • Connect to a room with others
  • Configure your dice (theme and color)
  • Roll any dice
  • See the dice roll (Can be used as a Browser Source in OBS)
  • Watch roll results (also available as Browser Source in OBS)

Start Container

You can start dice-tower with docker compose

Create a compose.yml-File with following content:

services:
  dice-tower:
    container_name: dice-tower
    image: git.arindy.de/arindy/dice-tower:latest
    restart: always
    ports:
      - "8080:8080"
    environment:
      DICE_LIMIT: 30    # OPTIONAL: amount of dice allowed to roll (default: 30)

Run the container with:

docker compose up -d

How To Build from scratch

To clone and run this application, you'll need git, java21 and docker.

# Clone this repository
$ git clone https://git.arindy.de/arindy/dice-tower.git

# Go into the repository
$ cd dice-tower

# Build the binary
$ ./mvnw clean verify -Pnative

# Build the container
$ docker build -f src/main/docker/Dockerfile.native-micro -t dice-tower .

# run the container in the background
$ docker run --network host -d dice-tower 

# Visit the dice-tower in your browser on http://localhost:8080

Credits

This software uses the following open source packages:

License

GPL-3