Import/Export

JSON import/export for modifiers and schema documentation.

Importing Modifiers from JSON

Open the Modifier Wizard (Window > Simple Attribute Forge > Modifier Wizard)
Go to Step 2 (Configure Modifiers)
Click "Import JSON..."
Select your JSON file
Choose how to handle import:
- Replace All - Clear existing modifiers and import
- Add to Existing - Keep existing modifiers and add new ones
Modifiers will be validated and populated from the file

Validation: Import checks that modifier names are not empty, each modifier has at least one modification, and all target attributes exist in your attribute system.

Exporting Schema

Export a JSON schema that documents the modifier format. This is useful for:

AI-assisted modifier generation
External tools integration
Documentation purposes

Open the Modifier Wizard
Go to Step 2
Click "Export Schema..."
Choose format: JSON, Markdown, or Both

JSON Format

The import/export uses modifierGroups as the root array key:

{
  "version": "3.0",
  "exportDate": "2026-01-22",
  "description": "Simple Attribute Forge Modifier System Export",
  "modifierGroups": [
    {
      "name": "Strength Potion",
      "description": "Temporarily increases Strength",
      "tag": "consumable",
      "duration": 30,
      "priority": 100,
      "stackable": false,
      "maxStacks": 1,

      "isDebuff": false,
      "isHidden": false,
      "canBeDispelled": true,
      "persistsThroughDeath": false,
      "refreshOnReapply": true,

      "requiredLevel": 0,
      "category": "buff",
      "incompatibleModifiers": [],
      "requiredModifiers": [],

      "modifyRegenRate": false,
      "regenRateType": "Flat",
      "regenRateValue": 0,
      "modifyRegenDelay": false,
      "regenDelayType": "Flat",
      "regenDelayValue": 0,
      "disableRegeneration": false,

      "modifications": [
        {
          "targetAttribute": "Strength",
          "type": "Flat",
          "value": 10,
          "modifyBaseValue": true,
          "modifyCurrentValue": false,
          "modifyMinValue": false,
          "modifyMaxValue": false,
          "isPermanent": false,
          "applyOverTime": false,
          "tickInterval": 1.0,
          "removeWhenConditionsMet": false,
          "enableConditions": false,
          "conditions": [],
          "modifierConditions": []
        }
      ]
    }
  ]
}

Minimal Format

Only required fields (defaults apply for omitted fields):

{
  "modifierGroups": [
    {
      "name": "Quick Buff",
      "tag": "buff",
      "duration": 10,
      "modifications": [
        {
          "targetAttribute": "Strength",
          "type": "Flat",
          "value": 5
        }
      ]
    }
  ]
}

Schema Exporter

The schema exporter (SimpleModifierSchemaExporter.cs) generates comprehensive documentation including:

All available fields and their types
Enum values for types like ModifierType and ComparisonType
Validation rules and constraints
Example modifiers
AI instructions for generating valid JSON