FoMininingComp
Runs automatic mining competitions where players race to mine chosen blocks, then rewards top ranks with configurable commands. Admins can manage events with GUI/commands.
FoMiningComp - Scheduled Mining Competitions for Paper
Run recurring mining competitions with automatic timing, live score tracking, and configurable top-rank rewards.
FoMiningComp lets you run repeatable mining events without manual setup every round. Define which blocks count, choose durations, set world restrictions, and reward your top miners with console commands. It is built for server owners who want competitive mining loops that stay easy to manage.
Features
- Run competitions automatically with configurable initial delay and interval between rounds.
- Track only the blocks you choose per competition (for example stone rush vs ore hunt).
- Exclude specific worlds from scoring to keep events fair and controlled.
- Show live competition progress with an optional BossBar timer.
- Broadcast start/end messages and optionally broadcast exactly which blocks players should mine.
- Reward top 1-5 players with custom console commands and placeholders like
%player%,%score%, and%rank%. - Manage everything in-game with a GUI editor: create competitions, edit durations/materials, toggle settings, and change rewards.
- Expose PlaceholderAPI placeholders for scoreboards, tab lists, and HUDs.
End-of-competition result broadcasts with winner and ranked scores.
PlaceholderAPI (Optional)
If PlaceholderAPI is installed, FoMiningComp registers placeholders such as:
%fominingcomp_time_remaining%%fominingcomp_time_until_next%%fominingcomp_active_id%%fominingcomp_active_name%%fominingcomp_next_id%%fominingcomp_status%%fominingcomp_player_score%%fominingcomp_player_rank%%fominingcomp_top_1_player%/%fominingcomp_top_1_score%(also ranks 2-5)
Dependencies
- No hard dependency required for core functionality.
- PlaceholderAPI is optional (only needed for placeholder support).
- Economy plugins are optional and only needed if your reward commands use economy commands.
Commands
/fominingcomp help- Show command help./fominingcomp version- Show plugin version and author./fominingcomp editor- Open the in-game competition editor GUI./fominingcomp reload- Reload configuration and competition files./fominingcomp start <id>- Start a specific enabled competition now./fominingcomp stop- Stop the active competition./fominingcomp setnext <id>- Force which enabled competition runs next./fominingcomp status- Show active/next status and timers./fominingcomp list- List configured competitions.
Alias: /miningcomp
Permissions
fominingcomp.admin- Access to all FoMiningComp commands and editor tools.
Reward payouts are fully command-based, so you can integrate with economy, rank, crate, or custom reward plugins by editing reward command lines.
