Drop Pools

Per-Mob Drop Pools

This page explains how to configure per-mob weighted card drops using settings/drop-pools.yml.

What it does

• Lets you define custom drop pools per entity type (for example zombie, skeleton, ender_dragon).

• Supports optional custom-name matching (namecheck) for custom mobs.

• Supports weighted outcomes:

• card_<cardId> to drop a specific card id (random active version across rarity/series).

• rarity_<rarityId> to drop a random active card from that rarity.

• Supports dropmin and dropmax to drop multiple cards per kill.

• Supports optional per-pool dropchance (out of 100,000).

If no pool matches, the plugin uses the existing default drop logic from chances.yml.

File location

• plugins/TradingCards/settings/drop-pools.yml

Default template is shipped at:

• tradingcards-plugin/src/main/resources/settings/drop-pools.yml

Basic format

config-version: 1

zombie:
  namecheck: "Jeffrey" # optional
  drops:
    enabled: true
    dropmin: 1
    dropmax: 1
    dropchance: 100000 # optional, 1..100000. If omitted, default mob-group chance is used.
    card_zombie:
      dropchance: 9900
    rarity_common:
      dropchance: 100

Option reference

• Entity key:

• Any Bukkit EntityType id, case-insensitive (zombie, skeleton, creeper).

• namecheck:

• Optional exact name match for the mob custom name.

• Color codes are supported in matching.

• drops.enabled:

• Enables/disables the pool.

• drops.dropmin:

• Minimum number of card rolls to drop when this pool triggers.

• drops.dropmax:

• Maximum number of card rolls to drop when this pool triggers.

• drops.dropchance:

• Optional pool trigger chance out of 100000.

• If omitted, plugin uses normal hostile/neutral/passive/boss chance from chances.yml.

• Entry keys under drops:

• card_<cardId> with dropchance weight.

• rarity_<rarityId> with dropchance weight.

• Weights are relative, not percentages.

Weight behavior

• Entries are selected by weight.

• Example:

• card_zombie: 9900

• rarity_common: 100

• Total is 10000, so card_zombie has 99% weight and rarity_common has 1% weight.

Notes and validation

• Invalid entity keys are ignored with a warning.

• Invalid entry keys are ignored with a warning.

• Non-positive entry weights are ignored.

• If a pool is enabled but has no valid entries, it logs a warning and drops nothing from that pool.

• Rarity ids in rarity_<id> are matched case-insensitively.

Reloading

• After changes, run your plugin reload command so configs are reloaded.

• TradingCards internal reload path reloads drop-pools.yml.