EdEvents

What is EdEvents?

EdEvents runs server-wide events on a schedule or on command: "mine the most blocks in 15 minutes", "first player to 1000 ores", "the whole server mines 1,000,000 blocks together"... Every player sees a personal boss bar and action bar with the time left, their score and the leader, and when the event ends the winner is announced in chat with their skin face rendered in chat next to your own lines.

It detects the prison / dungeon plugin installed on the server at startup. Nothing to configure - drop it in and start an event.

Features

• 3 event types - LEADERBOARD (most progress wins, placements 1/2/3...), FIRST_TO_GOAL (first to reach the goal wins instantly) and COMMUNITY (everyone contributes to one shared goal).
• 5 objectives - blocks mined, mobs killed, damage dealt, currency earned and CUSTOM (fed by command or API).
• Filters - by block type (wildcards), mob id, world, currency and permission. Build "only ores", "only bosses" or "only diamond blocks" events.
• Automatic scheduler - random interval or fixed times, weighted events, cooldowns, minimum players and "starting soon" countdowns.
• Boss bar + action bar - per player, per event, colour and style configurable. Plugs into the host plugin's action bar instead of overwriting the mining bar.
• Chat heads - the winner's skin face drawn in chat, fully configurable line by line.
• Rewards - for placements, participation, community goals, losers and everyone. 20 action types: commands, messages, titles, sounds, give-eco through the installed economy, and actions in your prison plugin's own syntax.
• Offline rewards - winners who are offline get their rewards queued and delivered when they join.
• Milestones & countdowns - announce when the server or a player hits 1k / 5k / 10k, and count down the last seconds.
• Join info - players logging in mid-event are told what is running and how to take part.
• Player toggles - /events toggle bossbar | actionbar | messages.
• Statistics & history - wins, top 3 finishes, events played, best score, event history. H2 (default) or MySQL.
• 60+ placeholders - for scoreboards, tab, holograms and menus (PlaceholderAPI).
• Fully async - lock-free progress counting, displays built off the main thread, async saves. Zero TPS impact.
• Developer API - Bukkit events for start, progress, win and end, plus a simple API to feed progress from your own plugins.
• Everything configurable - every message, title, sound, boss bar, action bar and reward, per event, with global defaults so event files stay tiny.

Supported plugins

• EdPrison - blocks mined (hand + explosions/fills), currency earned. Rewards in every currency and level track.
• PinnaPrison - blocks mined (hand + enchant/bomb/drill/autominer sweeps), currency earned. Rewards in every currency.
• EdTools - blocks mined (own swings + enchant batches), currency earned. Rewards in every currency.
• EdDungeons - mobs killed, damage dealt, currency earned. Rewards in every currency.
• No host plugin - vanilla block breaks, mob kills and damage still work.

Block events count only raw blocks mined by hand by default. Set count-enchant-blocks: true on an event to also count enchant, explosion, bomb and drill blocks.

7 example events included

• Mining Frenzy - classic leaderboard with milestones and a participation reward.
• Ore Rush - only ores count (block filter with wildcards).
• Race to 1000 - first player to 1000 blocks wins, with a personal-progress boss bar.
• Community Mine - the whole server mines towards one goal, with milestones, community and top-contributor rewards.
• Mob Slayer - mob-kill leaderboard.
• Boss Hunt - first to kill a boss wins.
• Money Maker - earn the most of a currency.

Each event is one small YAML file in plugins/EdEvents/events/. Copy one, change the objective and the rewards, done.

Example event file

enabled: true
name: "&6&lMining Frenzy"
description:
  - "Mine the most blocks in 15 minutes!"
duration: 15m
type: LEADERBOARD
objective:
  type: BLOCKS_MINED
scheduler:
  weight: 10
  cooldown: 2h
  min-players: 3
milestones: [1000, 5000, 10000]
rewards:
  placements:
    1:
      - "[GIVE-ECO] tokens 5000"
      - " &aYou won &6Mining Frenzy&a!"
    2:
      - "[GIVE-ECO] tokens 2500"
    3:
      - "[GIVE-ECO] tokens 1000"
  participation:
    min: 100
    actions:
      - "[GIVE-ECO] tokens 250"

Commands

Aliases: /edevents, /events, /ev, /miningevents

• /events - running event (time left, your score, leader) or the next automatic one.
• /events list - every configured event.
• /events info - details of a running event.
• /events top - leaderboard.
• /events next - when the next automatic event starts.
• /events stats - wins, top 3, played, best score.
• /events toggle [bossbar|actionbar|messages|all] - hide / show displays.

• /events start <event> - start an event, optionally with a custom duration.
• /events stop [event|all] - end an event now.
• /events extend <time> - add time to a running event.
• /events skip - start the next automatic event now.
• /events pause / /events resume - pause / resume the scheduler.
• /events progress <player> <event> <amount> - add progress (feed CUSTOM events from anywhere).
• /events setprogress <player> <event> <amount> - set a player's progress.
• /events reload - reload everything.

Every argument tab-completes. Full list of commands, permissions and placeholders in the documentation.

Support

Join the Discord for support, suggestions and updates: https://discord.gg/7RapfdQ7VH