Configuration

TrimEditor generates plugins/TrimEditor/config.yml on first run. Reload changes in-game with /te reload.

config-version

config-version: 2

Tracks the config schema. Do not edit this by hand. On startup TrimEditor compares it against the current version and runs migration if they differ.

requirements

requirements:
  enabled: false
  require-template: false
  require-material: false
  consume-template: true
  consume-material: true

When enabled is false (the default), editing trims is free and every pattern and material is offered.

Turn on enabled, then choose what is required:

Key	Meaning
require-template	Needs the matching smithing template for the selected pattern
require-material	Needs the matching trim material item
consume-template	Takes one template on successful apply when templates are required
consume-material	Takes one material on successful apply when materials are required

Required options are hidden from the picker when the player lacks the item or permission. If the player has no usable required template/material at all, /te does not open the editor.

Costs are validated and consumed only on a successful apply, after the held item's fingerprint passes. Players with trimeditor.bypass.cost skip requirements and money costs entirely.

economy

economy:
  enabled: false
  cost: 0.0

When enabled, TrimEditor uses Vault if it is installed and withdraws cost on a successful apply. Without Vault or enough balance, the trim is refused and no items are consumed.

gui

gui:
  cooldown-ms: 300

cooldown-ms is the minimum delay between accepted button clicks, per player, in milliseconds. It guards against double-clicks and click-spam. Set it to 0 to disable the cooldown.

sounds

Each editor action plays a configurable sound:

sounds:
  open:
    enabled: true
    sound: minecraft:block.smithing_table.use
    volume: 0.75
    pitch: 1.15

Field	Meaning
enabled	Whether to play this sound at all
sound	A namespaced sound key (minecraft:… or a resource-pack key)
volume	0.0 and up; also controls how far the sound carries
pitch	0.5 (low) to 2.0 (high)

Available actions: open, select-pattern, select-material, apply, page, close, deny.

Language

Player-facing text lives in a separate language file using MiniMessage formatting. The prefix is prepended to admin messages; normal player messages are sent without a prefix. Edit the strings to retheme or translate, then /te reload.

Migration

On every startup TrimEditor:

1. reads your config.yml,
2. adds any keys that are missing from your file (new options in an update), leaving all existing values untouched,
3. bumps config-version to the current schema,
4. saves the file only if something actually changed.

This means upgrading the jar never overwrites your settings. You simply gain the new defaults for keys you did not have yet.

Safety

Independent of configuration, every apply is guarded by an item fingerprint. When the editor opens, TrimEditor records a fingerprint of the held armor that includes its type, current trim, enchantments, name, lore and custom data (but ignores durability). On apply it re-checks the held item against that fingerprint; if the item is gone or has changed, the edit is cancelled and nothing, items or money, is consumed.