OreAcle

OreAcle is a lightweight and configurable chat-games plugin for Spigot-compatible Minecraft servers.

It automatically starts small chat games in the server chat. Players can answer directly in chat or interact with clickable and hoverable chat components, depending on the game type. Each round can have up to three winners with separate rewards for each placement.

Features

• Automatic timed chat games
• Manual start, stop, and reload commands
• Up to 3 winners per round
• Per-placement rewards
• Points, wins, fastest answer, and stats tracking
• Leaderboards for points, wins, and fastest answers
• Configurable messages, title, prefix, words, trivia questions, rewards, and timings
• ClickHere game with hidden random 8-character alphanumeric one-round tokens
• Hover game using legacy Spigot chat components
• Lightweight <center> support for configured chat lines
• Final round summaries

Game Types

OreAcle currently includes the following game types:

• reaction - type the displayed word
• unscramble - unscramble the displayed word
• unreverse - type the original word from a reversed display
• reverse - reverse the displayed word
• fillout - complete the word with missing letters
• random - type a generated random string
• math - solve a math equation
• variable - solve for x using configurable symbols
• trivia - answer a trivia question
• clickhere - click the chat component
• hover - hover the chat component and type the shown answer

Compatibility

• Minecraft: 1.12.2
• Server software: Spigot / Paper compatible
• Java: Java 8
• Client-side install required: No

OreAcle intentionally avoids modern Minecraft APIs and Paper-only APIs, making it suitable for legacy Spigot-compatible servers.

Commands

Main command:

/chatgames

Alias:

/cg

| Command | Description |
| --------------------------- | ----------------------------------------------------------------------------------- |
| /chatgames help | Shows command help |
| /chatgames start <type> | Starts a specific game |
| /chatgames stop | Stops the active game |
| /chatgames reload | Reloads config and data files. If a game is currently active, it is silently ended. |
| /chatgames reset <player> | Resets a player's OreAcle stats |
| /chatgames top | Shows the points leaderboard |
| /chatgames wins | Shows the wins leaderboard |
| /chatgames fastest | Shows the fastest answers leaderboard |
| /chatgames stats [player] | Shows stats for yourself or another player |

Permissions

| Permission | Default | Description |
| ------------------- | -------- | -------------------------------------------- |
| chatgames.admin | OP | Start, stop, reload, and reset |
| chatgames.top | Everyone | View the points leaderboard |
| chatgames.wins | Everyone | View the wins leaderboard |
| chatgames.fastest | Everyone | View the fastest answers leaderboard |
| chatgames.stats | Everyone | View player stats |
| chatgames.play | Everyone | Participate when play permission is required |

Configuration

OreAcle generates multiple configuration files:

| File | Purpose |
| -------------- | ------------------------------------------------------- |
| config.yml | Main settings, timings, enabled games, and game options |
| messages.yml | Chat formatting and user-facing messages |
| words.yml | Word pools for word-based games |
| trivia.yml | Trivia questions and accepted answers |
| rewards.yml | Placement reward actions |
| data.yml | Stored player stats and count of rounds with at least one winner|

By default, OreAcle starts one automatic game every 30 minutes and each round lasts 20 seconds.

auto-start-enabled: true
auto-start-interval-seconds: 1800
round-duration-seconds: 20

Rewards

Rewards are configured per placement in rewards.yml.

Supported reward actions include:

[console] eco give %player% 150
[player] say hello
[message] &fYou received &e150 coins&f.
[broadcast] &e%player% won a ChatGame!

Common placeholders:

%player%
%uuid%
%place%
%time%
%time_ms%
%answer%
%points%
%prefix%
%title%
%word%
%question%
%equation%
%puzzle%

Message Formatting

OreAcle uses classic Minecraft color codes with &.

The default title is:

chatgames-title: "&1&lO&9&lre&b&lAc&3&lle"

The normal prefix is:

prefix: "&8[&1&lO&9&lre&b&lAc&3&lle&8]"

Both the title and prefix are configurable.

Configured game messages can optionally use <center> for lightweight chat centering.

Installation

1. Download the plugin jar.
2. Place it into your server's plugins/ folder.
3. Start or restart the server.
4. Edit the generated files in plugins/OreAcle/.
5. Run /chatgames reload after changing the configuration.

Notes

• ClickHere tokens are random 8-character alphanumeric internal one-round tokens.
• Old ClickHere buttons stop working once the active round changes or ends.
• ClickHere does not reveal its internal token as an answer.
• Duplicate winners are silent by default.
• Individual winner broadcasts are disabled by default.
• Final results are shown in the main round summary.
• Existing server configs are not overwritten automatically when new options are added.