KeyAll
Scheduled command automation built around player experience.
Paper 1.21+ | Multi-Event | Weighted Rewards | Discord | Vault | PlaceholderAPI
Your scheduled rewards fire every hour. Nobody cares.
The command runs in the background. Players miss it. Those who catch it get no visual feedback that anything special happened. Your crate key giveaway lands with the same impact as a server restart notice.
Events without buildup are not events. They are cron jobs.
KeyAll turns scheduled command execution into something players actually watch for. A 60-second countdown appears on the boss bar. Titles flash at 10, 5, 3, 2, 1 seconds. Sounds build. Particles spiral. Discord sends a notification. Players who are offline see it and log in.
The command executes. Players felt it.
Core System
Multiple Independent Events
Drop a .yml file into
plugins/KeyAll/events/ and it loads as a completely independent event with its own schedule, rewards, display settings, conditions, and webhook configuration. No limit on event count. Each event runs separately without interfering with others.Two Scheduling Modes
- INTERVAL - fires every X minutes. Configure once, runs forever.
- TIMES - fires at specific times of day in 24-hour format (12:00, 18:00, 22:00). Precise to the minute, adjusts automatically across midnight.
Hot Reload
/keyall reload reloads all events, restarts all schedulers, and applies configuration changes without touching anything else on the server. No restart, no downtime.Reward System
Single Command Execution
The baseline. Any console command runs when the event fires. One line in config. Works with every plugin on your server.
Weighted Reward Pool
Define a pool of commands with individual weights. When the event fires, one reward is selected by weighted random draw and executed. Configure legendary crate keys at weight 10, common keys at weight 60. The math works exactly as expected.
Command Queue
Execute a sequence of commands with configurable delays between each. Defined in ticks. Use this for multi-step events: announce, wait 2 seconds, execute reward, wait 4 seconds, close broadcast. No external task scheduling plugin needed.
Per-World Rewards
Override the main reward pool for players in specific worlds. Players in the nether world get nether crate keys. Players in the end get end rewards. Each world entry has its own weighted pool. Falls back to global rewards for unlisted worlds.
Vault Economy Integration
Give money to online players at event fire time. Configure a fixed amount or a random range with min and max values. Works with any Vault-compatible economy plugin.
Participation Claim System
When enabled, players must run
/keyall claim to receive their reward. Configure a time window (in seconds) after the event fires. Set a maximum claim count if you want scarcity. Set to -1 for unlimited. Broadcasts who claimed. Window-expired message fires automatically when time runs out.Countdown Experience
Display Modes
- Boss Bar - persistent bar at top of screen with configurable color (YELLOW, BLUE, GREEN, PINK, PURPLE, RED, WHITE) and overlay style (SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20)
- Action Bar - text above hotbar, minimal screen footprint
- NONE - silent execution for background automation that should not surface to players
Title Announcements
Large titles appear at configurable second thresholds. Default set fires at 10, 5, 3, 2, 1. Title and subtitle text are fully configurable per event. Fade in, stay, and fade out timing is configurable in ticks.
Chat Announcements
Broadcast a chat message at configurable second thresholds. Separate from title intervals. Default set fires at 60, 30, 10, 5, 3, 2, 1. Message text is configurable per event.
Sounds
Two-tier sound system. Countdown sound plays at each chat announcement threshold. Reward sound plays on execution. Volume and pitch are configurable per sound type. Any Bukkit sound key is valid.
Particles
Optional particle effects at countdown completion. A ring effect fires at the player's location with configurable radius, particle type, count, and duration. Tornado effect option for more dramatic presentations.
Conditions
Events only execute when your conditions are met. If conditions fail, the event is skipped silently or with an announcement depending on your config. The schedule continues normally.
- Minimum Players - require at least X players online before the event fires. Prevents rewarding an empty server.
- World Restrictions - require at least one player to be present in specific worlds. Useful for world-specific events.
- Announce Skip - optionally broadcast to all online players when an event is skipped due to conditions not being met.
Integrations
Discord Webhook
Sends embed notifications to a Discord channel. One notification when the countdown starts, one when the command executes. Configurable username, avatar URL, embed color, countdown message, and execution message. All HTTP requests are asynchronous.
Telegram Bot
Sends text messages to a Telegram chat via bot API. Countdown and execution messages configurable independently. Toggle each notification type separately.
Slack Webhook
Posts messages to a Slack channel. Same independent configuration as the other webhooks. Supports Slack markdown formatting in message text.
PlaceholderAPI
Every event exposes placeholders for scoreboards and holograms. Primary event placeholders:
- %keyall_next% - time until next execution (formatted as MM:SS or HH:MM:SS)
- %keyall_next_formatted% - long format (1h 23m, 45m 10s)
- %keyall_next_seconds% - raw seconds
- %keyall_countdown% - countdown seconds remaining (0 if not active)
- %keyall_countdown_formatted% - formatted countdown
- %keyall_countdown_active% - true/false
- %keyall_paused% - true/false
- %keyall_mode% - INTERVAL or TIMES
- %keyall_interval% - configured interval minutes
- %keyall_command% - configured command string
- %keyall_enabled% - true/false
- %keyall_display_type% - BOSSBAR/ACTIONBAR/NONE
%keyall_event_EVENTNAME_FIELD% for multi-event setups.Statistics
SQLite database records every event execution. Stores event name, timestamp, player count, and reward executed. Query stats with
/keyall stats [event] [limit]. Database file is configurable. Disable entirely in global config if not needed.Administration
Status GUI
/keyall gui opens an inventory interface showing all loaded events at a glance. Status indicators, next execution time, pause state. Dynamically sizes based on event count. No commands needed to check what is running.Command Reference
/keyall reload- reload all configs and restart all schedulers/keyall info- view schedule mode, next execution, current settings/keyall list- list all loaded events with status and next execution/keyall trigger [event]- manually start a countdown and execute/keyall skip [event]- skip the current countdown without executing/keyall pause [event]- pause a specific event scheduler/keyall resume [event]- resume a paused event scheduler/keyall stats [event] [limit]- view execution history/keyall gui- open the status GUI/keyall claim [event]- claim a participation reward
Permissions
keyall.admin- full administrative access (default: op)keyall.gui- access to the status GUI (default: op)keyall.use- use /keyall claim (default: true)keyall.claim- claim participation rewards (default: true)
Multi-Language
English, Polish, Spanish, and German included. Every message in the plugin comes from the language file. Change the language in global config. Add new languages by creating additional files in the
lang/ folder. Missing keys fall back to English automatically.Who Uses KeyAll
Crate and Economy Servers
Hourly key drops with a 60-second buildup bring players back from AFK. Discord notification fires before countdown starts. Players who were offline log in for the reward. Participation claim system adds first-come scarcity to your most valuable drops.
Survival and RPG Networks
World boss spawn announcements with full countdown presentation. Different worlds get different reward pools. Conditions ensure the event only fires when enough players are in the right world.
Prison and Skyblock Servers
Sell boosts, mine resets, and periodic buffs fire on exact schedules. TIMES mode lines up with your server's daily peak hours. Stats database gives you a historical log of every execution to verify reliability.
Networks With Multiple Game Modes
One plugin, multiple events, each independently configured. Hub event every 30 minutes, survival event at 18:00 and 22:00, minigame event triggered manually. All from one install.
If your rewards don't have a countdown, they don't have an audience.
Configure your first event in under 5 minutes. Your players will ask what changed.
