editor armor trimmings - magemonkeystudio/divinity GitHub Wiki

🛡️ Editor: Armor Trimmings

The Armor Trimmings editor allows you to define decorative trims for armor pieces using Minecraft’s official trim system (1.20+). This system combines a trim material, trim pattern, and weight, then randomly selects one during item generation.

🎛️ How It Works

  1. Open the Item Generator Editor and click the Armor Trimmings icon.
  2. You'll see a list of current trimming entries and an option to add new ones.

Each trimming consists of:

  • Trim Material – The ingot or gem used in the trim (e.g., Copper, Netherite, Emerald).
  • Trim Pattern – The visual style (e.g., Rib, Vex, Dune).
  • Weight – The chance this trimming is selected during generation.

A default “None” entry is included, which applies no trim (you can adjust or remove it).

➕ Adding a New Trimming

Click the redstone dust icon labeled "Add new trimming" to begin. You'll be guided through 3 steps:

🧱 Step 1: Choose Trim Material

Pick from valid materials like:

  • Netherite
  • Redstone
  • Copper
  • Amethyst
  • Emerald
  • Iron
  • Diamond
  • Lapis

Each material affects the color and effect of the applied trim.

🧿 Step 2: Choose Trim Pattern

Select from all available armor trim templates, such as:

  • Rib
  • Vex
  • Dune
  • Sentry
  • Coast
  • Ward
  • Eye
  • Spire
  • Silence
  • Tide
  • Wayfinder
  • Shaper
  • Host

These define the visual design applied to the armor.

⚖️ Step 3: Set Weight

Enter a numeric weight (e.g., 10.0) which controls the chance of this trim appearing. Higher weight = more likely.

⚙️ How Trims Are Chosen

Each trimming (including "None") is part of a weighted pool. When generating armor:

  • The system rolls based on weights.
  • Only one trim is selected per item (or none).
  • Only trim-compatible items (like helmets, chestplates, leggings, boots) will receive a trim.

📝 Example Setup

armor-trimmings:
  none: 50.0
  netherite:rib: 0
  netherite:dune: 0
  netherite:wild: 10.0

In this example:

  • 50% chance for no trim
  • 10% chance to apply the Wild pattern with Netherite
  • Rib and Dune are included but disabled (0%)

✅ Tips

  • Keep the “None” entry if you want trims to be optional.
  • Use higher weights for common visuals, lower weights for rare styles.
  • Combine with Tier to make high-tier gear visually distinct.

Return to: Item Generator Module