Configuration

Edit the files in plugins/DexSpawners/, then /dexspawners reload. Changing the storage type needs a full restart. Texts support MiniMessage, & codes and &#rrggbb hex.

General

general:
  max-stack: 1000               # per block; ranks: dexspawners.stack.<n>
  default-player-limit: -1     # total owned; ranks: dexspawners.limit.<n>
  require-silk-touch: true
  explosion-protection: true
  ownership: true               # only owner + trusted can open / break
  convert-natural-spawners: true # right-click a dungeon spawner to claim it
  natural-spawner-drops: true
  confirm-break-above: 64
  on-break-storage: collect     # collect | sell | lose
  disabled-worlds: []

◆

Breaking always asks first if stored items would be lost, with the exact count. There's no "drop" option on purpose — a big stack can hold 400k+ items.

Generation

generation:
  always-active: false
  activation-mode: owner        # owner | any — who has to be nearby
  activation-range: 64
  afk-check: false              # Essentials / CMI, or a built-in movement check
  afk-timeout: 300
  max-xp-per-spawner: 5000

Spawner types

In spawners.yml, the key is the mob name. Any vanilla mob not listed uses the default block, so every mob is supported.

types:
  BLAZE:
    display-name: 'Blaze'
    icon: BLAZE_ROD
    interval: 30                 # seconds between generations
    xp: 10                       # per cycle, per stacked spawner
    base-capacity: 400
    loot:
      - { material: BLAZE_ROD, min: 0, max: 1, chance: 100 }

Upgrades

Four tracks in upgrades.yml, five levels each, paid through Vault. cost-per-stack: true multiplies the cost by the stack size.

Track	Value means	Level 1 → 5
Speed	Interval multiplier	0.90 → 0.50 (twice as fast)
Storage	Capacity multiplier	1.5× → 5×
Loot	Drop multiplier	1.25× → 2.5×
Experience	XP multiplier	1.25× → 3×

speed:
  enabled: true
  levels:
    1: { cost: 5000, value: 0.90 }
    5: { cost: 250000, value: 0.50 }

Selling

sell:
  price-sources:                 # first one with a price wins
    - dexworth
    - internal                 # prices.yml
    - essentials               # EssentialsX worth.yml
  tax-percent: 0.0
  confirm: true
  actionbar-summary: true

Items with no price anywhere aren't sold — they stay in storage. Ranks get a sell bonus with dexspawners.sellmulti.<x>, e.g. dexspawners.sellmulti.1.5.

Sell Wand

sell-wand:
  material: BLAZE_ROD
  name: '<accent>Sell Wand'
  glow: true
  default-uses: 100             # -1 = infinite
  default-multiplier: 1.0

Holograms & anti-xray

holograms:
  provider: display            # display | decentholograms | fancyholograms
  view-range: 32
  line-of-sight: true          # no holograms through walls
anti-xray:
  enabled: true                # Paper only
  reveal-range: 48
  check-interval: 10

Menu colour & storage

gui:
  colour: '&#00fc88'
  allow-player-choice: true     # /dexspawners colour
  colours: { green: '&#00fc88', aqua: '&#00e1ff', purple: '&#b266ff', gold: '&#ffbf00', red: '&#ff4d4d', pink: '&#ff66c4' }
storage:
  type: sqlite                 # yaml | sqlite | mysql
  autosave-interval: 120