> For the complete documentation index, see [llms.txt](https://realisticnode.gitbook.io/rnsetups/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://realisticnode.gitbook.io/rnsetups/rnchatgames/getting-started/installation.md).

# Installation

## Requirements

* A **Spigot** or **Paper** server (1.21.x or 26.x), or a fork of Paper such as Purpur or Folia.
* **Java 21** or newer.
* Internet access on the **first start**: the server downloads the libraries the plugin needs (SQLite, MySQL driver and HikariCP; on Spigot also Adventure, the text library Paper has built in) from Maven Central once and keeps them in `libraries/`.

Optional:

* [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) for [placeholders](/rnsetups/rnchatgames/reference/placeholders.md).
* [Geyser and Floodgate](https://geysermc.org/) for [Bedrock players](/rnsetups/rnchatgames/reference/bedrock.md).

## Steps

1. Download `rnChatGames.jar` and put it in the `plugins/` folder of your server.
2. Restart the server (do not use `/reload`).
3. The plugin creates `plugins/rnChatGames/` with its files (see [Files overview](/rnsetups/rnchatgames/getting-started/files.md)).
4. Open `plugins/rnChatGames/config.yml` and set:
   * `language`: `en` (English) or `es` (Spanish). The words and questions follow the same language.
   * `automatic-games.min-players`: how many players must be online for automatic games to start (default `2`).
5. Save the file. Changes are applied a few seconds later, no restart needed.

Check the console: you should see lines like these.

```
[rnChatGames] Content (en.yml): 2082 words, 60 trivia questions, 30 multiple choice questions, 60 phrases.
[rnChatGames] Connected to the SQLite database.
```

## First test

* `/rncg start` starts a random game. `/rncg start math` starts a specific one.
* `/rncg preview unscramble` shows how a game looks, only to you, without starting it.
* `/rncg next` tells when the next automatic game starts.
* `/rncg editor` opens the settings menu.

<figure><img src="https://348500357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSlVHklG0EMAOmvfqcizu%2Fuploads%2FsKVQGXkR1GagEu3k5GQw%2Fen-preview.png?alt=media" alt="/rncg preview math shows a game only to you"><figcaption><p>/rncg preview math shows a game only to you</p></figcaption></figure>

{% hint style="success" %}
Automatic games start every 5 to 10 minutes when at least 2 players can play. Change it in `config.yml` (`automatic-games`) or in `/rncg editor` → General.
{% endhint %}
