Skip to main content

Configuration

All settings live in plugins/KeyAllPro/config.yml. Run /keyall reload after any changes.

Full Config Reference​

Timer​

interval: 3600        # Seconds between automatic key drops (default: 1 hour)
persist-timer: true   # Resume countdown after server restart (vs. reset to full)
KeyTypeDefaultDescription
intervalinteger3600Seconds between drops
persist-timerbooleantruePersist countdown across restarts

Crates​

crate-mode: ROTATION  # ROTATION or RANDOM

crates:
  - name: "VoteCrate"
    weight: 60
    give-command: "crates give %player% vote 1"
  - name: "RareCrate"
    weight: 40
    give-command: "crates give %player% rare 1"
KeyTypeDescription
crate-modestringROTATION — cycles through crates in order; RANDOM — picks by weight each drop
namestringDisplay name shown in announcements
weightintegerRelative chance in RANDOM mode (higher = more frequent)
give-commandstringConsole command run for each player; %player% = player name

Warnings​

warning-times: [300, 60, 30, 10, 5]   # seconds before drop to send warnings

Warnings fire at each listed second before the drop. Add or remove values as needed.

Notifications​

notifications:
  chat:
    enabled: true
    message: "&6[KeyAll] &eKey drop in &a{time}&e!"
  action-bar:
    enabled: true
    message: "&6Key drop in &a{time}"
  title:
    enabled: false
    title: "&6Key Drop!"
    subtitle: "&eIn {time}"
    fade-in: 10
    stay: 40
    fade-out: 10
  bossbar:
    enabled: true
    color: YELLOW     # PINK, BLUE, RED, GREEN, PURPLE, WHITE, YELLOW
    style: SOLID      # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
    message: "&6Key Drop &7— &e{time} remaining"
  sound:
    enabled: true
    sound: ENTITY_EXPERIENCE_ORB_PICKUP
    volume: 1.0
    pitch: 1.0

Rank Bonuses​

rank-rewards:
  enabled: true
  vip:
    permission: "keyallpro.rank.vip"
    bonus-keys: 1
  mvp:
    permission: "keyallpro.rank.mvp"
    bonus-keys: 2
  elite:
    permission: "keyallpro.rank.elite"
    bonus-keys: 3

Players with the rank permission receive additional key drops on top of the base amount.

Bonus Chance​

bonus-reward:
  enabled: true
  chance: 10          # Percentage (0-100) chance per player per drop
  bonus-keys: 1       # Extra keys awarded when chance triggers

Daily Double​

daily-double:
  enabled: true
  day: SATURDAY       # MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY
  multiplier: 2.0     # All keys × this value on the specified day

Offline Players​

offline-rewards:
  enabled: true
  deliver-on-join: true   # Give pending keys when player joins

If a player was offline during a drop, their keys are stored in pending-rewards.yml and delivered on next login.

PlaceholderAPI Variables​

PlaceholderExample Output
%keyall_time%14m 32s
%keyall_next_crate%VoteCrate