KeyAll v1.0

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

The Problem With Basic Schedulers

You run crate key giveaways, daily rewards, or vote party commands at regular intervals. But players barely notice. The command executes silently in the background. No anticipation. No excitement. No retention value.

Other servers have countdown systems, but they're either poorly made (lag spikes, memory leaks, broken displays) or lack features (no Discord notifications, no PlaceholderAPI integration, no conditional execution).

You need a scheduler that turns routine commands into server events.

The Event-Driven Automation System

KeyAll isn't a cron plugin with a countdown tacked on. It's a visual event system that executes commands. Players see particle tornados spiraling around them, boss bars counting down, titles appearing at key moments, and Discord notifications building hype.

This is command automation that increases player retention by making scheduled events feel significant.


[ATTACH type="full" alt="1776617643113.png"]1296535[/ATTACH]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Features That Turn Commands Into Events

Dual Scheduling System
Choose between interval or time-specific modes:

1. Interval Mode: Execute every X minutes with automatic countdown adjustment
2. Times Mode: Execute at specific times (13:00, 16:00, 20:00) with smart detection

Switch modes in config. No plugin restart needed. Reload takes effect immediately.
Business value: Flexibility. Use intervals for crate keys, specific times for daily events.

Spectacular Particle Tornado Effect
Spiral animation around every online player:

1. Progressive color gradient (Gold → Yellow → White)
2. Decreasing radius (2.5 blocks → 0.3 blocks)
3. Rising height animation
4. Configurable duration (default 10 seconds)
5. Smooth 3-point spiral pattern

Players know something big is coming before the command executes.
Business value: Visual anticipation = player engagement. Players stay online for events.

Particle Ring Completion Effect
Customizable ring explosion when countdown hits zero:

1. Configurable radius, particle type, count, duration
2. END_ROD, ENCHANT, FIREWORK options
3. Circular pattern around player position
4. Synchronized across all online players

Business value: Reward moment feels special. Players associate the effect with receiving rewards.

Flexible Display System
Three display modes for different server styles:

1. Boss Bar: Progress bar at top of screen with color/overlay customization (YELLOW, PINK, BLUE, RED, etc.)
2. Action Bar: Text above hotbar for minimal UI impact
3. None: Silent execution for background commands

Every message supports legacy color codes (&a, &l) AND hex colors (RRGGBB).
Business value: Matches your server's visual theme without code changes.

Dynamic Title Countdown
Dramatic titles at configurable intervals:

1. Default: 10, 5, 3, 2, 1 second warnings
2. Fully configurable fade in/stay/fade out timing
3. Custom messages per language file
4. Supports color codes and hex colors

Business value: Creates urgency. Players rush to get online before timer expires.

Advanced Sound System
Two-tier sound design:

1. Countdown Sounds: Ticks during countdown (PLING, NOTE_BLOCK, etc.)
2. Reward Sounds: Celebratory sound on completion (LEVELUP, ORB_PICKUP)
3. Volume and pitch control per sound type
4. Configurable or disable entirely

Business value: Audio reinforcement of event importance. Players hear the difference.

Smart Conditions System
Commands only execute when conditions are met:

1. Minimum Players: Require X players online (prevents rewards when server is empty)
2. World Restrictions: Require at least one player in specific worlds
3. Announce Skip: Debug logging when conditions fail

Failed conditions don't break the schedule. Plugin waits for next execution window.
Business value: Prevents wasted reward executions on empty servers. Saves economy balance.

Discord Webhook Integration
Real-time notifications to Discord channels:

1. Countdown start notifications with time remaining
2. Execution confirmation with timestamp
3. Custom embed colors and formatting
4. Configurable webhook name and avatar
5. Async HTTP requests (zero server lag)

Business value: Engages players who aren't online yet. They see Discord notification and log in.

PlaceholderAPI Deep Integration
12+ placeholders for scoreboards and holograms:

1. %keyall_next% - Time until next execution
2. %keyall_countdown% - Current countdown seconds
3. %keyall_countdown_active% - Boolean status
4. %keyall_mode% - Schedule mode
5. %keyall_interval% - Interval minutes
6. %keyall_command% - Configured command
7. %keyall_next_time% - Next scheduled time (TIMES mode)
8. %keyall_online_players% - Player count
9. And more...

Business value: Builds anticipation on scoreboards. Players watch countdown in real-time.

Multi-Language Support
4 languages included (EN, PL, ES, DE) with easy expansion:

1. All messages in lang/ YAML files
2. Countdown text, titles, errors fully translatable
3. Add custom languages by creating new .yml files
4. Hot-reload language changes

Business value: International networks use one plugin for all regions.

Admin Control Commands
Full control without server restarts:

1. /keyall reload - Hot-reload config and restart scheduler
2. /keyall info - View next execution time and settings
3. /keyall trigger - Manually start countdown with full effects
4. /keyall countdown - Demo countdown without executing command

Business value: Test configurations live. No trial-and-error with server restarts.

Performance Architecture
Built for production servers:

1. Config value caching for fast access
2. Thread-safe scheduler management
3. Async HTTP for Discord webhooks
4. No memory leaks on reload
5. Proper task cleanup on disable
6. Tested on 150+ player servers

Business value: Reliability. Your scheduled events never skip or double-execute.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Why This Beats Basic Schedulers

1. Event Feel vs Silent Execution
Other schedulers execute commands in the background. KeyAll makes each execution feel like a server event. Players remember when it happens because of the visual and audio buildup.

2. Modern Paper API Implementation
Built for Paper 1.21+ with Adventure API components. Not outdated Bukkit code ported forward. This uses modern text components, proper scheduler APIs, and safe async patterns.

3. Zero Configuration Guesswork
Every option has comments explaining what it does. Example values are production-ready. You can use default settings and get a polished experience immediately.

4. Integration Ecosystem
PlaceholderAPI and Discord webhooks aren't afterthoughts. They're core features with full configuration control. Your scoreboards and Discord server stay synchronized with countdown state.

5. Maintenance Included
Paper API changes? Minecraft updates? New particle effects? Maintained. You're not buying a "works now, breaks later" plugin.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Who Needs KeyAll

Networks With Crate Systems
Schedule key giveaways every hour. Players know to be online when countdown starts. Retention increases because missing the countdown = missing free keys.

Economy Servers
Daily money drops at specific times (12:00, 18:00, 00:00). Discord notifications bring players back online. Vote party integration for player count thresholds.

Survival/RPG Servers
Boss spawn announcements with 60-second countdown. Event start notifications. Periodic buff application commands with visual fanfare.

Prison/Skyblock Servers
Sell boost activation at intervals. Mine reset warnings with countdown. Automatic rankup key distribution with Discord cross-promotion.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Technical Requirements

1. Minecraft: Paper 1.21+ (no Spigot support)
2. Java: 21+
3. Optional: PlaceholderAPI (for placeholder integration)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━