Skip to content

Dynamic Tiers

RoarkCats edited this page Aug 9, 2026 · 8 revisions

Data Structure

Dynamic Tiers are data-driven and can be defined or changed with a datapack.
Tiers can be defined under the following directories:

<Pack>/data/<namespace>/dynamic_multitools/dynamic_tier/<tier>.json

Format

  • String: mod_id (optional, defaults to minecraft) - Used to generate recipes from standard tool ID paths, part of material translation key
  • String: material - Used to generate recipes from standard tool ID paths, part of material translation key
  • Int: color (optional, defaults to -1) - Decimal RGB color tinting for texture layer 1 (tool head)
  • Int: rod_color (optional, defaults to -1) - Decimal RGB color tinting for texture layer 0 (tool rod), default rod texture is wooden, best left at -1
  • String: tier_base (optional) - Used as a base tier from which to pull values from an existing hardcoded tier
    • Tier base does not recognize Dynamic Tiers, only regular tool tiers logged when joining a server
    • Tier string should be lowercase and supports partial matching regex
    • If tier string matches multiple tiers, the first will be used (order may vary on server load)
  • Int: durability (optional) - Sets or overrides tier durability (should be the same as tool set, config controls multiplier)
  • Float: speed (optional) - Sets or overrides tier mining speed (should be the same as tool set, config controls multiplier)
  • Float: damage_bonus (optional) - Sets or overrides tier attack damage (should be the same as tool set, added to multitool base stats)
  • Block Tag: incorrect_blocks_for_drops (optional) - Sets or overrides tier block mining level, commonly used for pickaxe ore level restrictions
  • Int: enchantability (optional) - Sets or overrides tier enchantability for enchanting tables
  • Ingredient: repair_ingredient (optional) - Sets or overrides tier anvil repair ingredient
  • Ingredient: material_ingredient (optional, defaults to repair ingredient) - Sets tier crafting material ingredient
  • Ingredient: rod_ingredient (optional, defaults to #c:rods/wooden) - Sets tier crafting rod ingredient
  • Components: default_components (optional) - Applies any additional component overrides (enchantments, custom model data, rarity, etc.)

Tier Base

Examples

Overriding

Disabling

Clone this wiki locally