Configuration

⚙️ Configuration

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

---

📄 Full config.yml

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

# How stats are displayed in item lore
# Options:
#   percentage — "Attack Damage: +20%"           (default, recommended)
#   absolute   — "Attack Damage: +1.40"          (vanilla-style flat values)
#   mixed      — "Attack Damage: +1.40  (+20%)"  (both formats side by side)
stat-display: percentage

# Drop chance per rarity (%) — must add up to 100
rarity-weights:
  common: 50
  uncommon: 30
  rare: 13
  hero: 5
  legendary: 2

---

🔧 Options reference

drop-chance

Type	Default	Range
Decimal	0.08	0.0 – 1.0

The probability that a hostile mob drops a rarity weapon 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 and speed 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%)

ℹ️ This setting only affects melee weapons. Bows and crossbows always show Projectile weapon since they have no ATTACK_DAMAGE attribute.

---

rarity-weights

Type	Default total
Integer map	Must sum to 100

Sets the relative drop chance of each rarity tier when a drop occurs. Values are treated as percentages and must add up to exactly 100.

If the total is not 100, a warning is printed to the console on startup:

[RPGLoot] WARNING: rarity-weights in config.yml add up to 95 instead of 100. Drop chances will be skewed.

Example — increase legendary rate for a more generous server:

rarity-weights:
  common: 40
  uncommon: 30
  rare: 18
  hero: 8
  legendary: 4

See Drop System for calculated drop rates per kill at different configurations.