> 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.md).

# rnChatGames

Fully customizable chat games for Spigot and Paper servers.

rnChatGames runs games in the chat that every player can join: unscramble a word, solve a math problem, answer a trivia question, be the first to click the right button, guess a secret number, play hangman together and more. The fastest players win rewards, climb the rankings and keep win streaks.

Everything can be changed: the games, their texts, the rewards, the menus and the words and questions, in any language.

<figure><img src="https://348500357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSlVHklG0EMAOmvfqcizu%2Fuploads%2FzljFDejLNfgDUKVGVpDi%2Frncg-real-01.png?alt=media" alt="A game running: title, boss bar and chat"><figcaption><p>A game running: title, boss bar and chat</p></figcaption></figure>

{% hint style="info" %}
**Need help?** Join our [Discord](https://discord.gg/GzxW2FANPB) and open a ticket. See [Support](/rnsetups/support.md).
{% endhint %}

## Features

* **16 games**: Unscramble, Unreverse, Reaction, Fill Out, Random Text, Math (with difficulties), Variable, Trivia, Multiple Choice, Click, Hover, Guess The Number, Completion, Hangman, Memory and Color.
* **About 2000 words per language** (English and Spanish included), plus trivia, multiple choice questions and phrases. Add your own language with one file.
* **Several winners per game** (1st, 2nd, 3rd...) with a podium and rewards for each place.
* **Rewards**: console and player commands, items, messages, titles, sounds, chances, permission-only rewards and weighted "pick one" rewards. Rewards of players who leave are kept for their next join.
* **Effects**: titles, action bars, boss bar countdown, sounds and an advancement-style popup (toast) for the winner.
* **Stats and rankings** in menus: points, wins per game, fastest times, records and win streaks. Player heads show skins, also on offline-mode servers.
* **In-game editor** (`/rncg editor`) to change almost every option, with an explanation of each one.
* **Files that never break**: updates add new options without touching yours, every change is backed up, and a file with a mistake tells you the exact line.
* **Changes apply on their own** a few seconds after saving a file.
* **SQLite or MySQL**, with a command to move the stats from SQLite to MySQL.
* **PlaceholderAPI** placeholders, including a countdown to the next game.
* **Bedrock players** (Geyser / Floodgate) get windows for the games that need clicking or hovering.
* **Each player in their own language** (optional): messages follow the language of their Minecraft client.
* **Folia** supported.

## Compatibility

|          |                                                   |
| -------- | ------------------------------------------------- |
| Server   | Spigot, Paper, Purpur and Folia (1.21.x and 26.x) |
| Java     | 21 or newer                                       |
| Optional | PlaceholderAPI, Geyser / Floodgate                |

{% hint style="info" %}
One jar for every server: on Paper and Folia the plugin uses their own features (built-in texts, region schedulers), on Spigot the Spigot ones. CraftBukkit is not supported.
{% endhint %}

## Quick start

1. Put `rnChatGames.jar` in `plugins/` and restart the server.
2. Pick your language in `config.yml` (`language: en` or `language: es`).
3. Start a game with `/rncg start` or wait for an automatic one (`/rncg next` tells you when).
4. Open `/rncg editor` to change the settings in game.

Continue with [Installation](/rnsetups/rnchatgames/getting-started/installation.md).