Skip to main content
Installing LiricCasino takes only a few minutes. The plugin generates all of its configuration files automatically on first start, so there is no manual setup beyond placing the required dependencies. Follow the steps below to get your casino up and running.

​
Dependencies

Before you install the plugin JAR, make sure these dependencies are in place:
LiricCasino uses SQLite by default, so you do not need to set up an external database to get started. A casino.db file is created automatically inside plugins/LiricCasino/. If you prefer MariaDB for a multi-server setup, you can switch to it in config.yml after the first start — see the Configuration page for details.

​
Installation Steps

1

Verify your Java and server version

LiricCasino requires Java 21 or newer and runs on Paper or Spigot 1.20.x – 1.21.x. Folia is also supported. Check your Java version before continuing:
You should see version "21" or higher in the output. If not, update your Java runtime before proceeding.
2

Download the plugin JAR

Grab the latest CasinoLiric.jar (version 2.0.3) from the official distribution page. Always download from the official source to ensure you have the correct, unmodified file.
3

Install Vault and your economy plugin

Download Vault and your chosen economy plugin (for example, EssentialsX or CMI) and place both JARs in your server’s plugins/ folder. LiricCasino will not load without Vault present.
If you want PlaceholderAPI support, add that JAR to plugins/ as well.
4

Drop CasinoLiric.jar into plugins/

Copy the downloaded CasinoLiric.jar into your server’s plugins/ folder alongside Vault and your economy plugin. No further file editing is required at this stage.
5

Start or restart your server

Start your server (or run /restart if it is already running). LiricCasino will detect Vault on startup and automatically generate all configuration files inside plugins/LiricCasino/:
Once the server finishes loading, you will see LiricCasino’s startup message in the console confirming that Vault and the economy plugin were found.
6

Place physical games in your world

Some games — Roulette, Slots, Blackjack, and Poker — require a physical in-world object before players can use them. Use the setup command as an operator or a player with the casino.admin permission.For Roulette, Blackjack, and Poker, stand at the location where you want the game to appear and run:
For the Slot Machine, look directly at the block you want to attach the machine to (within 5 blocks), then run:
GUI-only games (Scratch Cards, Lottery, CoinFlip, Rock Paper Scissors, Tic Tac Toe, Horse Racing) are accessible immediately via their commands — no setup step needed.

​
Verifying the Installation

After your server restarts, check the console for LiricCasino’s startup message confirming that Vault and the economy plugin were detected. You can also run the following command in-game or from the console:
If you see a success message, LiricCasino loaded correctly. You can then open any game with /casino <game> or its shortcut alias:
Grant yourself the casino.admin permission (or use operator status) to access setup, delete, and reload commands. Regular players only need the default permissions to play all enabled games.