Skip to content

Basic Config

Tyvor edited this page Jul 30, 2026 · 2 revisions

Basic Config

The basic config is designed for normal players and quick setup.

File: config/armor-durability-cap.properties

Example

# Armor Durability Cap
# Restart game/server after changes

enabled=true

# Max durability loss per hit: 20%
max_percent=0.20

# Flat cap per hit (-1 = off)
max_flat_damage=-1

# Minimum durability loss
minimum_damage=1

# FLOOR / ROUND / CEIL
rounding_mode=FLOOR

# Also affect compatible modded armor
affect_modded_armor=true

# Set true to generate advanced config next restart
advanced.generate_file=false

Fields

enabled

Turns the mod on or off.

max_percent

Maximum durability loss per hit as a percent of total durability.

Examples:

  • 0.20 = up to 20% of total durability per hit
  • 0.02 = up to 2% of total durability per hit

max_flat_damage

Optional flat cap per hit.

Examples:

  • -1 = disabled
  • 3 = no more than 3 durability damage per hit
  • 1 = always cap at 1 durability damage per hit

minimum_damage

Minimum durability damage when armor damage is applied.

Examples:

  • 1 = vanilla-like minimum
  • 0 = tiny hits may deal no durability damage after rounding

rounding_mode

Controls how durability values are rounded.

Available values:

  • FLOOR
  • ROUND
  • CEIL

affect_modded_armor

If true, the mod also affects compatible modded armor that uses normal durability behavior.

advanced.generate_file

If true, the mod will generate the advanced config on the next restart.

After the file is generated, restart again after editing it.

Good starting presets

Light protection

max_percent=0.20
max_flat_damage=-1
minimum_damage=1
rounding_mode=FLOOR

Strong protection

max_percent=0.05
max_flat_damage=3
minimum_damage=1
rounding_mode=FLOOR

Very strict cap

max_percent=0.01
max_flat_damage=1
minimum_damage=1
rounding_mode=FLOOR

Clone this wiki locally