KeyStorm | Global Crate Key Events

KeyStorm
Global Crate Key Events — Automated, Beautiful, Unforgettable
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✦ What is KeyStorm? ✦

KeyStorm is a premium-quality global Key All event system for your Minecraft server. It automatically monitors your player count and, when milestones are reached, rewards every online player with crate keys. Beautiful gradient announcements hype up your community, boost player retention, and keep everyone logging on for the next reward wave.

Think of it as a hype engine — players see the countdown, tell their friends to join, and everyone wins.

╔══════════════════════════════════════╗
FREE 24-HOUR TRIAL LICENSE
╚══════════════════════════════════════╝

Test the FULL plugin with ALL features before you buy!
No payment required • No limitations • Full Access

▶ ▶ ▶ CLICK HERE TO GET YOUR FREE TRIAL ◀ ◀ ◀

Join Discord → Open a ticket → Get your license instantly!

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

✦ Features ✦

Smart Player Milestones
Automatically detects when your server hits the next player threshold.
Under 40 players, milestones trigger every 5 players. At 40+, they trigger every 10 — perfect for scaling as your server grows.

Tiered Reward Scaling
Rewards get better as your community grows:
1–20 players → 1 Rare Crate Key
21–39 players → 2 Rare Crate Keys
40+ players → 1 Legendary Crate Key

Gorgeous Gradient Announcements
When a Key All is approaching, players receive stunning
hex-gradient messages that build anticipation. Shows exactly how many more players are needed before the next event fires.

⏱ Cooldown System
Built-in 42-minute cooldown prevents spam and keeps events feeling special. Fully configurable in config.yml.

Per-Player Toggle
Players can opt out of Key All notifications with a simple command. They still receive keys — just no ping.

Sound Effects
Custom sounds play on both the hype announcement and the reward moment for maximum impact.

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

✦ Commands & Permissions ✦

Code:

COMMANDS
──────────────────────────────────────
/keystorm toggle          — Toggle Key All notifications on/off
/keystorm status          — View current milestone progress
/keystorm force           — Force-trigger a Key All (admin)
/keystorm reload          — Reload configuration (admin)
/keystorm cooldown reset  — Reset the cooldown timer (admin)

PERMISSIONS
──────────────────────────────────────
keystorm.notify           — Receive Key All announcements (default: true)
keystorm.status           — View milestone status (default: true)
keystorm.admin            — Access admin commands (default: op)

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

✦ Configuration ✦

YAML:

# ╔═══════════════════════════════════════╗
# ║          KeyStorm — config.yml        ║
# ╚═══════════════════════════════════════╝

# How often (in minutes) the plugin checks player milestones
check-interval: 10

# Minimum minutes between Key All events
cooldown-minutes: 42

# Milestone step sizes
milestones:
  below-40-step: 5      # Trigger every 5 players when under 40
  above-40-step: 10     # Trigger every 10 players when 40+

# Reward tiers
rewards:
  tier-1:
    max-players: 20
    command: "crates giveKey Rare %player% 1"
    display: "<#90d5ff>1 Rare Crate Key"
  tier-2:
    max-players: 39
    command: "crates giveKey Rare %player% 2"
    display: "<#90d5ff>2 Rare Crate Keys"
  tier-3:
    min-players: 40
    command: "crates giveKey Legendary %player% 1"
    display: "&e1 Legendary Crate Key"

# Sound effects
sounds:
  announcement: "block.note_block.pling"
  reward: "entity.player.levelup"
  reward-pitch: 0.8

# Messages (supports hex colors with <#RRGGBB> format)
messages:
  # Set to false to disable
  use-gradient-title: true

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

✦ How It Works ✦

1. Every 10 minutes, KeyStorm checks the current player count against the next milestone.
2. If the milestone is close, a gorgeous gradient broadcast tells everyone how many more players are needed.
3. When a player joins and hits the exact milestone number, the Key All fires instantly.
4. Every online player receives crate keys, a level-up sound, and a celebration broadcast.
5. A cooldown activates to keep events feeling rare and exciting.

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

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

KeyStorm | Global Crate Key Events v1.0

Overview Dependencies History