editor materials

🪨 Editor: Materials

The Materials option defines which item materials the generator is allowed to use. This includes both vanilla Minecraft items and custom items from supported plugins.

How to Use

• Click the Materials icon in the editor.
• Add or remove materials using the in-game GUI.
• Optionally assign one or more model data values to each vanilla material.
• Use the Whitelist Reversed toggle to treat the list as a blacklist instead of a whitelist.

---

Supported Material Types

You can add:

• Vanilla materials (e.g., IRON_SWORD, LEATHER_HELMET)
• Oraxen items – ORAXEN_flame_blade
• ItemsAdder items – ITEMSADDER_weapons/fire_axe
• Nexo items – NEXO_arc_blade

These prefixes are required and are used to correctly resolve which plugin the material belongs to.

---

Model Data

For vanilla materials:

• You can assign one or more Custom Model Data values.
• If multiple model data values are provided, one is selected randomly during generation.
• Model data changes the item’s visual appearance via a resource pack.

Plugin-based materials (Oraxen, ItemsAdder, Nexo) do not use model data from this system — they define visuals through their own configuration.

---

%BASE_NAME% Integration

When a plugin-based material is selected, the %BASE_NAME% placeholder in the Name Format will be automatically populated using the plugin’s item name.

Plugin	%BASE_NAME% Value
Oraxen	The Oraxen item’s internal or display name
ItemsAdder	The ItemsAdder item’s registered name
Nexo	The Nexo item’s ID or display name
Vanilla	(No value — placeholder is skipped)

This lets you build display names that reflect the material’s identity without hardcoding it into the format.

---

Tips

• Use Whitelist Reversed to easily exclude unwanted materials.
• Assign multiple model data values to vanilla materials for cosmetic variety.
• For plugin-based visuals, always use the correct format:
  • ORAXEN_, ITEMSADDER_, NEXO_

Return to: Item Generator Module