NexusEvents - Ultimate Live-Event Engine v1.3.0

NexusEvents 1.3.0
Two new modes, win streaks, player voting & live NPC leaderboards

The biggest content drop yet — 2 event modes, earnable titles, spectator handling, Bedrock support, and a multi-world foundation.
​

New Modes: Hot Potato & Quiz Show

• Hot Potato: pass-the-bomb elimination — a glowing item hops between players on hit or right-click, and whoever holds it when the round timer ends is out. Last survivor wins.
• Quiz Show: chat-answer trivia with first-blood scoring (first correct answer scores big, follow-ups score less). Ships with 24 ready-to-go questions in a hot-reloadable questions.yml — edit and reload live with /ne reload questions.

Win Streaks & Reward Multipliers

• Streak engine: every win builds a streak; a configurable multiplier (capped) rewards your most consistent players and resets on a loss.
• Reward integration: drop %streak% and %streak_multiplier% straight into your reward commands. Milestone streaks broadcast server-wide to fuel the hype.
• New placeholders: %nexusevents_streak%, %nexusevents_max_streak%, %nexusevents_streak_multiplier%, %nexusevents_games_played%, %nexusevents_title%.

🗳 Player Voting

• Vote for the next event: the random pool can now open a timed vote over the top candidates instead of rolling — players pick what plays next with /ne vote <event>.

🎖 Titles & Badges

• Earnable titles: unlock by wins, best streak, or games played; equip with /ne title <id> and show it anywhere via %nexusevents_title%.

Spectator System

• Clean eliminations: knocked-out players drop into spectator and are restored — game mode, location, and flight — exactly as they were when the event ends. No more stuck-in-spectator gear loss.

Citizens NPC Leaderboards

• Living leaderboards: place Citizens NPCs that display the rank-1 player of any event type — name line and skin track the champion and refresh automatically. Optional; the plugin runs fine without Citizens.

Bedrock / Floodgate Support

• Cross-play aware: detects Bedrock players through Floodgate (reflection-based, zero hard dependency) so chat-driven modes behave sensibly for everyone.

Multi-World Foundation

• World contexts: group worlds into named contexts with per-context event overrides. Disabled by default — single-world setups are completely unchanged. Inspect with /ne world.

⚙ Config Presets & Hot-Reload

• Preset system: save and load entire event configurations — five bundled presets included (competitive, casual, halloween, christmas, competitive_network). Manage with /ne preset <save|load|list|delete|info>.
• Modular reload: reload exactly what you changed — /ne reload [config|events|lang|discord|presets|questions|titles|worlds].

Drop-in update. New config sections (streaks, titles, npc-leaderboard, multi-world, hot-potato, quiz) generate with safe defaults — your existing config and language files keep working untouched.
​

NexusEvents 1.2.0
Public API, Deathmatch Mode & Advanced Admin Controls

A stable developer API, a brand-new game mode, and far more granular control over running events.
​

New: Deathmatch Mode

• Free-for-all combat in a coordinate-box arena — no schematic dependency.
• Kits & respawns: configurable kits handed out on every spawn, timed respawns in spectator mode.
• Boundary damage: players who leave the arena radius take escalating damage with an action-bar warning.
• Inventory safety: every participant's inventory and game mode are snapshotted on start and fully restored at the end — the event never eats gear.

New: Public Developer API

• NexusEventsApi facade: a stable, thread-aware entry point for live scores, running/paused state, time left, persistent stats, leaderboards, and full event control.
• EventStartEvent (cancellable): block starts during maintenance or region locks.
• EventStopEvent: carries the final score snapshot and winner for your own reward logic.
• EventRewardEvent (cancellable): mutable per-player command map — add, change, or strip rewards before dispatch.
• PlayerScoreChangeEvent (cancellable): mutable amount for boosters and anti-abuse plugins.

🛠 New Admin Controls

• /ne pause | resume <event>: freeze and resume a running event; the countdown halts while paused.
• /ne info <event>: time left, status, and the live top 3.
• /ne forcewin <event> <player>: end an event and crown a player regardless of standings.
• /ne resetstats <event> [confirm]: wipe persistent stats for an event type and clear the leaderboard cache.
• Full tab-completion & preview support for the new commands and Deathmatch.

⚙ Improvements

• Min-players check: events now refuse to start below their configured minimum, with a clear NOT_ENOUGH_PLAYERS result.
• Core engine: GameEvent gains pause/resume, forceWin, and getTopScores, with pause-safe tick guards and new subclass hooks (onPause/onResume).
• Discord embeds: end notifications now include the cached top 3 leaderboard, with tidier async sending.
• Scheduling: many async callbacks refactored onto consistent, Folia-safe scheduling paths.
• Config & language: updated resources for the new mode, commands, and messages.

Update is drop-in. Existing databases migrate automatically — no config wipe required.
​

NexusEvents 1.1.0
Seasons, Event Log & Discord Integration

Isolated competitive seasons, a persistent event log, and automatic Discord notifications.
​

New: Seasons

• Seasonal stats: each season gets its own dataset — points, wins, and history are tracked separately.
• Automatic DB migration on startup — existing databases are updated without data loss.
• New admin commands: /ne season start, season end, season list.

New: Event Log

• Persistent logging: every event is written to nexus_event_log with start/end time, winner, and winner points.
• New records: EventLogEntry and SeasonInfo for external processing via the API.
• /ne history <event>: lists the most recent completed events.

New: Discord Integration

• Webhook listener: posts automatically on event start and stop.
• Fully configurable in config.yml, with a separate webhook URL per event type supported.

🛠 Admin Tools

• /ne wins <event> [player]: total wins for a player.
• /ne preview <event>: shows current config values before the event starts (dry-run).
• /ne setup: in-game guided setup wizard for new event zones.
• Leaderboard GUI with chat fallback for environments where GUIs cannot be opened.
• Improved tab-completion across all subcommands.

⚙ Scheduler & Performance

• Folia detection: the scheduler automatically switches to the regional task scheduler when running on Folia.
• Top cache now refreshes correctly after a season change.
• SchedulerUtil abstracts Bukkit and Folia scheduling behind a single API.

Misc

• TeamManager and RewardManager hooked in for external addon logic.
• SetupManager handles the interactive zone configurator.
• New language keys for all additions (EN + DE included).