Skip to content

Configuration

Jump to bottom
okereke-dev edited this page Jun 30, 2026 · 4 revisions

⚙️ 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

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

# 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.

damage-numbers

Type Default
Boolean true

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

Set to false to disable all damage number displays.

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.

Clone this wiki locally