Skip to content
◆ TTS-STUDIO docs Discord

Plugins / CrateForge

Mob Key Drops

Mob Key Drops

CrateForge allows hostile mobs to drop crate keys when killed. Drop chances are configured per mob type in config.yml.

Configuration

Mob key drops are configured in the mob-drops section of plugins/CrateForge/config.yml:

# config.yml — Mob Key Drop Configuration

mob-drops:
  enabled: true   # Master switch — set to false to disable all mob drops

  drops:
    # Each entry: mob type → key to drop → chance
    - mob: ZOMBIE
      key-id: common_key
      chance: 0.01          # 1% drop chance (0.0 to 1.0)

    - mob: SKELETON
      key-id: common_key
      chance: 0.01

    - mob: CREEPER
      key-id: common_key
      chance: 0.02          # 2% — slightly more common from creepers

    - mob: SPIDER
      key-id: common_key
      chance: 0.005         # 0.5%

    - mob: ENDERMAN
      key-id: rare_key
      chance: 0.005         # 0.5% for a rarer key

    - mob: BLAZE
      key-id: rare_key
      chance: 0.01

    - mob: WITHER_SKELETON
      key-id: rare_key
      chance: 0.02

    - mob: ELDER_GUARDIAN
      key-id: legendary_key
      chance: 0.05          # 5% from rare boss mob

    - mob: WITHER
      key-id: legendary_key
      chance: 1.0           # 100% — always drops a legendary key

    - mob: ENDER_DRAGON
      key-id: legendary_key
      chance: 1.0

Field Reference

Field Type Required Description
mob-drops.enabled Boolean Yes Master toggle for all mob drops
drops[].mob String Yes Bukkit EntityType name (uppercase)
drops[].key-id String Yes Key ID to drop (must exist in keys/)
drops[].chance Double Yes Drop probability: 0.0 = never, 1.0 = always

Chance Value Reference

Chance Value Percentage Meaning
1.0 100% Always drops
0.1 10% 1 in 10 kills
0.05 5% 1 in 20 kills
0.01 1% 1 in 100 kills
0.005 0.5% 1 in 200 kills
0.001 0.1% 1 in 1,000 kills
0.0 0% Never drops (same as removing the entry)

All Supported Mob Types

Any valid Bukkit EntityType can be used. Common hostile mobs:

ZOMBIE          SKELETON        CREEPER         SPIDER
CAVE_SPIDER     ENDERMAN        BLAZE           GHAST
WITCH           WITHER_SKELETON ZOMBIE_PIGLIN   HOGLIN
PIGLIN_BRUTE    RAVAGER         EVOKER          VINDICATOR
PILLAGER        DROWNED         HUSK            STRAY
PHANTOM         GUARDIAN        ELDER_GUARDIAN  WARDEN
WITHER          ENDER_DRAGON    SHULKER         SILVERFISH

Note: Use the exact EntityType name from the Bukkit API — always uppercase, underscores for spaces.

Boss Drop Setup

Configure guaranteed key drops from bosses:

mob-drops:
  enabled: true
  drops:
    - mob: WITHER
      key-id: legendary_key
      chance: 1.0             # Wither always drops a legendary key

    - mob: ENDER_DRAGON
      key-id: legendary_key
      chance: 1.0             # Dragon always drops a legendary key

    - mob: ELDER_GUARDIAN
      key-id: rare_key
      chance: 0.5             # 50% chance from Elder Guardian

    - mob: WARDEN
      key-id: legendary_key
      chance: 0.25            # 25% chance from Warden

Tips

Tip: Give bosses (Wither, Ender Dragon) guaranteed key drops to reward players who defeat them.

Tip: Keep common mob drop rates very low (0.5%–2%) to prevent key inflation. Players should feel lucky when a key drops.

Tip: Consider giving different mobs different key tiers — common mobs drop common keys, rare mobs drop rare keys.

Warning: Setting chance: 1.0 on common mobs like Zombie will flood players with keys very quickly. Use low chances for common mobs.

Home | Key Format | Crate Format | Commands & Permissions