editor material - magemonkeystudio/divinity GitHub Wiki

🪨 Editor: Material

The Material option controls what base materials the item can use. This is especially powerful when paired with model data to create randomized item appearances.

How to Use

  • Click the Material icon in the editor.
  • You'll see two key toggles and two editable lists:
    • Whitelist – The list of allowed materials.
    • Whitelist Reversed – If enabled, the list becomes a blacklist instead.
    • Model Data – Optional per-material values that can be used for cosmetic variations.

Material Configuration Flow

  1. Toggle Whitelist Reversed to control filtering logic.
  2. Add New Material
    • Opens a material selector GUI.
  3. Add Model Data to Material
    • Input one or more integers (e.g., 1001, 1002).
    • If multiple values are added, one will be chosen at random during generation.

Example Use Case

Whitelist:

  • PAPER → Model Data: [1, 2, 3]
  • BONE → Model Data: [5]

Result: the item will randomly pick from PAPER (model 1–3) or BONE (model 5).

Tips

  • Combine with Custom Model Data for resource pack customization.
  • Use reversed whitelist to exclude materials instead of allowing only some.

Return to: Item Generator Module