Skip to content
Matcha! Mods

Transmutation Builder

Transmutation Builder

Section titled “Transmutation Builder”

The Transmutation Builder is an interactive tool that helps you create transmutation configuration files without writing JSON manually.

Features

Section titled “Features”
  • Visual Rule Builder: Create conversion rules with a user-friendly interface
  • Condition Builder: Build complex logical conditions with AND/OR operators
  • Operation Sequencer: Define operations in the correct order
  • Live JSON Preview: See the generated JSON in real-time
  • Validation: Ensures all required fields are filled correctly
  • Export: Copy JSON directly to your configuration files

Using the Builder

Section titled “Using the Builder”

Rule Information

Unique identifier for this conversion rule
Higher values = checked first (1000+: critical, 100-999: high, 0: default, -100: fallback)

Condition Builder

Define when this rule should match an item

Operations

Define transformations to apply (executed in order)

Generated JSON

 
 
 
 
  

Tips
Section titled “Tips”


1. Start with Priority
Section titled “1. Start with Priority”


Set the priority first to understand where this rule will fall in the evaluation order:


    

  • 1000+: Critical conversions
    • 

  • 100-999: High priority
    • 

  • 1-99: Normal
    • 

  • 0: Default (fallback rules)
    • 



2. Build Specific Conditions
Section titled “2. Build Specific Conditions”


Use all conditions to ensure your rule only matches the items you intend:


{
  "type": "all",
  "all": [
    {"type": "component_exists", "path": "..."},
    {"type": "component_equals", "path": "...", "value": "..."}
  ]
}


3. Sequence Operations Correctly
Section titled “3. Sequence Operations Correctly”


Remember that operations execute in order:


    

  1. Copy or read data first
    2. 

  2. Transform item ID
    3. 

  3. Set new components
    4. 

  4. Clean up old data last
    5. 



4. Test Your Rules
Section titled “4. Test Your Rules”


After generating JSON:


    

  1. Copy to config/alchemy/transmutations/yourfile.json
    2. 

  2. Enable logConversions in config.json
    3. 

  3. Test with a few items first
    4. 

  4. Monitor server logs for conversion messages
    5. 



Common Patterns
Section titled “Common Patterns”


Plugin Item Migration
Section titled “Plugin Item Migration”


Condition: component_exists → path to plugin marker
Operation 1: set_item_id_from_lookup → map old IDs to new
Operation 2: remove_component → clean up plugin data


Data Restructuring
Section titled “Data Restructuring”


Condition: component_exists → old data location
Operation 1: set_component → create new structure with from_source
Operation 2: remove_custom_data_key → remove old data


Conditional Conversion
Section titled “Conditional Conversion”


Condition: all → [exists check, equals check for type]
Operation 1: set_item_id_from_component → use embedded new ID
Operation 2: copy_component → preserve important data
Operation 3: remove_component → cleanup


Next Steps
Section titled “Next Steps”