Skip to content

Configuration

Jump to bottom
okereke-dev edited this page Jul 1, 2026 · 3 revisions

Configuration

The config file is generated automatically at plugins/RPGLoot/config.yml on the first server start. Edit it and restart the server (or /reload confirm) to apply changes.

Full config.yml

# Chance that a hostile mob drops a rarity item on death (0.0 - 1.0)
drop-chance: 0.08

# How bonus stats are displayed in item lore
# Options: percentage | absolute | mixed
stat-display: percentage

# Show floating damage numbers in combat (true/false)
damage-numbers: true

# Drop chance per rarity (%) — auto-normalized if they don't sum to 100
rarity-weights:
  common: 50
  uncommon: 30
  rare: 13
  hero: 5
  legendary: 2

# Items injected into vanilla structure chests on first generation
structure-loot:
  enabled: true
  # Probability that a recognized structure chest receives an RPGLoot item (0.0 - 1.0)
  inject-chance: 0.25

# Boss drops — guaranteed RPGLoot weapon on death
# min-rarity and max-rarity define the rarity range (inclusive)
boss-drops:
  enabled: true
  warden:
    chance: 1.0
    min-rarity: RARE
    max-rarity: LEGENDARY
  wither:
    chance: 1.0
    min-rarity: RARE
    max-rarity: LEGENDARY
  elder-guardian:
    chance: 0.8
    min-rarity: RARE
    max-rarity: HERO
  ender-dragon:
    chance: 1.0
    min-rarity: RARE
    max-rarity: LEGENDARY

Options reference

drop-chance

Type Default Range
Decimal 0.08 0.0 – 1.0

The probability that a hostile mob drops a rarity item when killed by a player.

  • 0.0 — never drops
  • 0.08 — 8% chance per kill (default)
  • 1.0 — always drops

stat-display

Type Default Options
String percentage percentage · absolute · mixed

Controls how attack damage, speed, and defense bonuses are shown in the item lore.

Option Example output
percentage Attack Damage: +20%
absolute Attack Damage: +1.40
mixed Attack Damage: +1.40 (+20%)

Bows and crossbows always show Projectile weapon since they have no ATTACK_DAMAGE attribute.

damage-numbers

Type Default
Boolean true

Toggles floating damage numbers in combat. When enabled, a number appears above the target on every hit, color-coded by type (normal, crit, bleed, heal, smash).

rarity-weights

Type Default total
Integer map Recommended to sum to 100

Sets the relative drop chance of each rarity tier when a drop occurs. If the values don't sum to 100, the plugin auto-normalizes them and logs a warning:

[RPGLoot] WARNING: rarity-weights sum to 95 instead of 100 — weights have been normalized automatically.

structure-loot

Controls injection of RPGLoot items into vanilla structure chests.

Key Type Default Description
enabled Boolean true Enable/disable structure loot entirely
inject-chance Decimal 0.25 Probability a recognized chest receives an item

Set inject-chance: 0.0 to disable injection while keeping the feature enabled for future use.

Structure loot never contains Netherite. Max rarity per structure type is fixed (see Drop System).

boss-drops

Controls the guaranteed boss drop behavior.

Key Type Default Description
enabled Boolean true Enable/disable all boss drops
<boss>.chance Decimal varies Probability the boss triggers a drop on death
<boss>.min-rarity String RARE Minimum rarity for the rolled drop
<boss>.max-rarity String varies Maximum rarity for the rolled drop

Valid boss keys: warden · wither · elder-guardian · ender-dragon

Valid rarity values: COMMON · UNCOMMON · RARE · HERO · LEGENDARY

If an invalid rarity string is supplied, a warning is logged and the default value is used.

Example — make Warden always drop Legendary:

boss-drops:
  warden:
    chance: 1.0
    min-rarity: LEGENDARY
    max-rarity: LEGENDARY

Clone this wiki locally