Omega Chat Games

Omega Chat Event is a premium but FREE automated chat event plugin that keeps your server community engaged and active. It automatically launches interactive chat-based mini-games where players race to be the first to answer correctly and win real in-game rewards.

How It Works
Every few minutes (configurable, randomised interval), the plugin picks a random event type and broadcasts it to all online players. A question or scrambled word appears in chat, on screen as a title, and in the action bar — with a live boss bar countdown. The first player to type the correct answer in chat wins automatically. Rewards execute instantly, stats are recorded, and the leaderboard updates. It runs entirely hands-off — no staff needed.

✨ Images
Math Event:

Scramble Event:

Scramble Event:

Title Start Message:

Boss bar for timer:


✨ Features
Three Unique Event Types
Event Type How It Works Pre-built Questions
Math Players solve a math problem (addition, subtraction, multiplication, mixed) ~97 questions
Word A word is displayed — first to type it wins ~116 words
Scramble A word is scrambled — first to unscramble it wins ~116 Minecraft-themed words
That's 330+ pre-built questions out of the box — no setup required.

⚙️ Fully Automated Scheduling

• Randomised interval between events (configurable min/max, default 10–15 minutes)
• Automatically pauses when no players are online (saves resources)
• Requires a configurable minimum player count to start
• Won't start a new event if one is already active
• Configurable event duration (default: 30 seconds)
• Manual start/stop via commands for admin control

Dual Reward System
Rewards are fully configurable per event type with two modes:

Chance-Based Mode — One reward is randomly selected from a weighted list:

yaml
rewards:
- chance: 50
command: "eco give %player% 5000"
- chance: 30
command: "eco give %player% 3000"
- chance: 20
command: "eco give %player% 10000"

Guaranteed Mode — All listed commands execute for the winner:

yaml
rewards:
- "eco give %player% 5000"
- "crate key give %player% vote 1"

• Any console command works as a reward (eco give, crate key give, lp user, give, etc.)
• Customisable reward display message per event type (shown to winner)
• The %player% placeholder is replaced with the winner's name

Player Statistics & Leaderboard

• Tracks total wins, math wins, word wins, and scramble wins per player
• Persistent storage via YAML (data.yml) — survives restarts
• Configurable leaderboard size (default: top 10)
• /ocg stats [player] — view your own or others' statistics
• /ocg top — view the global leaderboard

Boss Bar Integration

• Live countdown timer shown above the hotbar
• Configurable boss bar color and overlay style
• Custom title with live event type and time remaining
• Full colour code support in the boss bar title
• Boss bar reads the same colour format as everything else (legacy & codes)

Per-Event Sound Effects
Each event type can play a unique configurable sound:

yaml
sounds:
math:
enabled: true
sound: BLOCK_NOTE_BLOCK_PLING
volume: 1.0
pitch: 1.0

Sounds play to all online players when an event starts.

Multi-Channel Broadcasts
Each broadcast channel can be independently toggled:

• Chat messages — event start, question, and timer in chat
• Title + Subtitle — big screen-centre announcement with fade in/stay/fade out
• Action bar — persistent countdown text above the hotbar

Anti-Repetition System

• Prevents the same question or word from appearing twice in a row
• Configurable cache size (default: remembers last 20)
• Falls back to a random pick if the cache is exhausted

Multi-Format Colour Support

• Legacy colour codes (&6, &c, &l, etc.)
• MiniMessage tags (<gradient>, <bold>, <red>, etc.)
• Automatic detection — the parser checks for < tags and falls back to legacy

Commands
Base command: /omegachatgames (aliases: /ocg, /chatgames)

Command Description Permission Default
/ocg start <math|word|scramble> Manually start an event omegachatgames.start OP
/ocg stop Stop the active event omegachatgames.stop OP
/ocg reload Reload all config files omegachatgames.reload OP
/ocg next View time until next scheduled event omegachatgames.next Everyone
/ocg info View plugin information & total events run omegachatgames.info Everyone
/ocg stats [player] View win statistics for self or another player omegachatgames.stats Everyone
/ocg top View the global leaderboard omegachatgames.top Everyone
✅ Full tab completion is supported on all commands and sub-arguments.

Running /ocg with no arguments shows a permission-filtered help menu.

Permissions
Permission Description Default
omegachatgames.admin Full access to all features (parent permission) OP
omegachatgames.start Start events manually OP
omegachatgames.stop Stop active events OP
omegachatgames.reload Reload configuration OP
omegachatgames.next View next event time Everyone
omegachatgames.info View plugin info Everyone
omegachatgames.stats View statistics Everyone
omegachatgames.top View leaderboard Everyone
omegachatgames.admin is a parent that automatically grants all sub-permissions.

PlaceholderAPI Integration
Soft-depends on PlaceholderAPI — the plugin works fine without it, but Placeholders are available when it's installed.

Placeholder Description
%omegachatgames_current_event% Current active event type (e.g. "Math"), or "None"
%omegachatgames_last_winner% Name of the last event winner
%omegachatgames_last_event% Last event type that ran (e.g. "Word")
%omegachatgames_next_event% Time until next scheduled event (e.g. "8m 30s"), or "Paused"
%omegachatgames_total_events% Total number of events that have run
%omegachatgames_total_wins% The viewing player's total wins across all types
%omegachatgames_math_wins% The viewing player's math event wins
%omegachatgames_word_wins% The viewing player's word event wins
%omegachatgames_scramble_wins% The viewing player's scramble event wins
%omegachatgames_top_player% Name of the #1 player on the leaderboard
%omegachatgames_top_player_wins% Total wins of the #1 player
That's 11 placeholders.

Configuration Files
The plugin generates 6 files on first run:

1. config.yml — Main Settings
yaml
# Event scheduling interval (in seconds)
event-interval:
min-seconds: 600
max-seconds: 900

# Duration of each event (in seconds)
event-duration: 30

# Minimum players required to start events
minimum-players: 1

# Pause scheduler when no players are online
pause-with-no-players: true

# Enabled event types
enabled-events:
- MATH
- WORD
- SCRAMBLE

# Anti-repetition system
anti-repeat:
enabled: true
cache-size: 20

# Boss bar configuration
bossbar:
enabled: true
title: "&6%event% Event &8- &e%time%s remaining"
color: YELLOW
style: SOLID

# Storage system (YAML or MYSQL)
storage:
type: YAML

# Broadcast settings
broadcast:
chat: true
title: true
actionbar: true

# Sound settings per event type
sounds:
math:
enabled: true
sound: BLOCK_NOTE_BLOCK_PLING
volume: 1.0
pitch: 1.0
word:
enabled: true
sound: ENTITY_EXPERIENCE_ORB_PICKUP
volume: 1.0
pitch: 1.0
scramble:
enabled: true
sound: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.0

# Leaderboard size
leaderboard-size: 10

2. messages.yml — Every Message Customisable
All messages support %prefix% and event placeholders (%event%, %question%, %time%, %player%, %answer%). Legacy & colour codes and MiniMessage tags both work.

3. rewards.yml — Per-Event-Type Reward Configuration
Chance-based and guaranteed modes with custom display messages.

4. events/math-event.yml — ~97 Math Questions
Addition, subtraction, multiplication, and mixed operations.

5. events/word-event.yml — ~116 Words
Science, nature, geography, mythology, and more.

6. events/scramble-event.yml — ~116 Minecraft-Themed Words
Mobs, blocks, items, biomes, and gameplay terms — perfect for scrambling.

Installation & Setup

1. Drop OmegaChatGames.jar into your plugins/ folder
2. Restart your server
3. (Optional) Install PlaceholderAPI for placeholder support
4. Edit the config files to customise rewards, messages, and scheduling
5. Events start automatically — or use /ocg start <type> to test

Requirements:

• Java 21+
• Paper/Spigot 1.20+ (compiled against Paper 1.20.4)
• PlaceholderAPI (optional — soft-depend)

Technical Details (for server admins & reviewers)

• No NMS — uses only the public Paper API, fully future-proof
• Async chat handling — answer detection uses AsyncChatEvent at LOWEST priority for zero performance impact
• Correct winning message cancellation — the winner's chat message is cancelled when it matches the answer, so it doesn't show double in chat
• Safe reload — /ocg reload cleanly stops the scheduler, reloads all configs, and restarts without memory leaks
• Case-insensitive answer matching — answers are trimmed and compared case-insensitively
• Scramble guarantee — the scramble algorithm ensures the scrambled word is never identical to the original
• Modular architecture — separate managers for config, storage, events, and scheduling
• Console command execution — reward commands are dispatched from the console sender on the main thread (required for economy/permission plugins)