FoChatGames

FoChatGames adds quick chat-based minigames that keep players active between normal server events. Players race to answer prompts in chat, winners receive configurable rewards, and staff can manage game timing, rewards, stats, logs, and world access without digging through every file manually.

Features

• Run seven game types: Completion, Guess The Number, Math, Trivia, Type, Unreverse, and Unscramble.
• Start games automatically on a configurable delay, or launch random, specific, and custom games manually.

• Reward winners with console commands, player commands, or item rewards using independent rolls or weighted reward mode.
• Track wins, best records, last-start status, and win logs in SQLite for player stats and admin review.
• Configure chat, hover text, titles, subtitles, actionbar messages, and sounds for game start, win, and end events.
• Manage timing, enabled games, chances, reward chances, and world blacklists from the in-game admin editor.

Dependencies

• PlaceholderAPI - Optional. Enables FoChatGames placeholders for scoreboards, tab lists, and other supported plugins.

Commands

• /fochatgames - Main command. Aliases: /chatgames, /chatgame, /focg, /cg.
• /chatgames help - Show available commands.
• /chatgames statistics [player] - View your stats, or another player's stats with permission.
• /chatgames toggle - Toggle chat-game messages and sounds for yourself.
• /chatgames start [game] - Start a random or specific game manually.
• /chatgames custom <game> <settings...> - Start a custom prompt and answer game.
• /chatgames stop [game] and /chatgames stopall - Stop active games.
• /chatgames status - View when each game type last started.
• /chatgames logs global|player ... - Review recent win logs.
• /chatgames editor - Open the admin editor.
• /chatgames reload - Reload config, messages, games, word lists, and GUI files.

Permissions

• fochatgames.admin - Access admin commands, the editor, and update notices.
• fochatgames.help - View help.
• fochatgames.statistics - View your own statistics.
• fochatgames.statistics.others - View another player's statistics.
• fochatgames.toggle - Toggle personal chat-game messages and sounds.
• fochatgames.start, fochatgames.custom, fochatgames.stop, fochatgames.stopall - Manage running games.
• fochatgames.status, fochatgames.logs, fochatgames.reset - View status/logs and reset player stats.

Placeholders

Requires PlaceholderAPI.

• %fochatgames_next% / %fochatgames_seconds_until_next% - Seconds until the next scheduled game.
• %fochatgames_active% - Whether a game is currently active.
• %fochatgames_active_game% - Active game key, or blank if no game is active.
• %fochatgames_wins% / %fochatgames_wins_raw% - Player's total wins.
• %fochatgames_record% / %fochatgames_record_raw% - Player's best record time.
• %fochatgames_enabled% - Whether the player has chat-game messages and sounds enabled.
• %fochatgames_<game>_wins% / %fochatgames_<game>_record% - Per-game wins and record time for completion, guess_the_number, math, trivia, type, unreverse, or unscramble.

<dependency>
  <groupId>me.foesio</groupId>
  <artifactId>FoChatGames</artifactId>
  <version>1.7</version>
  <scope>provided</scope>
</dependency>

import me.foesio.foChatGames.api.ChatGamesService;
import me.foesio.foChatGames.api.ChatGameEndEvent;

ChatGamesService api = Bukkit.getServicesManager().load(ChatGamesService.class);
if (api != null) api.activeGame();

@EventHandler
public void onChatGameEndEvent(ChatGameEndEvent event) {
    Bukkit.getLogger().info(event.getClass().getSimpleName());
}