Skip to content

Dynamic Tiers

Jump to bottom
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

The tier_base field is a String referencing a vanilla or modded tier hardcoded in. It provides default values for durability, speed, damage_bonus, incorrect_blocks_for_drops, enchantability, repair_ingredient, and thus also material_ingredient. These can still be overriden if desired.

If you are adding a dynamic tier to support a mod's tools, you most likely want to reference their existing tier. You can do this by finding their tier name in your client or server logs upon joining a world if the mod is installed. After selecting a tier base, all that's really required is to set the mod id, material name, and color.

If a tier base is not available or sufficient, it can be supplemented by defining all the fields it provides individually. If no tier base is provided and a single field listed above is missing, the pack will fail to load.

Examples

Overriding

Disabling

Clone this wiki locally