OreAcle

# 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: ```text /chatgames ``` Alias: ```text /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 ` | 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. ```yaml 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: ```text eco give %player% 150 say hello &fYou received &e150 coins&f. &e%player% won a ChatGame! ``` Common pl