Config - yeelp/Distinct-Damage-Descriptions GitHub Wiki

This page documents formatting for the config file.

General Formatting.

Damage Types: When referring to damage types in the config. They must be prepended with a ddd_ prefix. Examples include ddd_fire, ddd_force etc. The exception is for slashing, piercing and bludgeoning. While they can be referred to with ddd_slashing, ddd_piercing and ddd_bludgeoning, you can use the following shorthand: s for slashing, p for piercing and b for bludgeoning. When part of the config mentions needing a damage type, it will always follow these rules.

Damage Configs

Configs for damage entries includes Weapon/Item base damage, Projectile damage and Entity damage. Each entry will have a list of tuples (t, a) where:

  • t is a damage type.
  • a is an amount. This is the weight of that damage type in the damage distribution.

ALL WEIGHTS MUST ADD TO 1!! DDD will crash and not boot with an InvariantViolationException if the weights do not add to 1! Double check your config entries! You can also check Minecraft's output log as well, as DDD will mention which config entries are malformed.

A valid entry would be minecraft:wooden_sword;[(s, 0.5), (b, 0.5)].

Projectile Items

Projectiles can also specify which items' tooltips their damage distribution should be shown on.

Resistance Configs

Resistance configs needn't have all their weights add to 1, unlike damage configs. The resistance configs are formatted the same way as the damage configs otherwise.

Mob Immunities

Mob immunities are put in a list after the list of resistances. It is a list of damage types.

Mod Compat Config

For mod compat config entries, it is recommended to look at the default config values included. Typically they will require some sort of identifier and a distribution, as specified above for damage distributions. It should be formatted the same way.