Skip to content

Configuration EN

hp-1e edited this page Jul 12, 2026 · 1 revision

Configuration

中文

Rules are stored in config/item_nameplate_rules.json. The root object contains an entries array; every entry is one label rule.

{
  "entries": [
    {
      "desc": "Example rule",
      "target": {
        "type": "item",
        "value": "minecraft:diamond"
      },
      "text_source": {
        "type": "item_name"
      },
      "priority": 10
    }
  ]
}

Rule selection

Only one matching rule is used for an item.

  1. Higher priority wins.
  2. For equal priority, the earlier JSON entry wins.

Common fields

Field Required Meaning
desc No Documentation only.
target Yes Match target. See Rule Reference.
text_source Yes Text source. See Rule Reference.
remove_text No Strings removed from the result in order.
replace No Map of source text to replacement text.
priority No Rule priority; defaults to 0.

remove_text runs before rule-level replace. If processing yields an empty label, the original item name is used.

Clone this wiki locally