Troubleshooting

Common issues and solutions for the Ultimate tier systems.

Modifier System Issues

Modifier doesn't seem to apply

• Check target: Ensure the target has an ISimpleAttributeDataSource component
• Check attribute name: Verify the targetAttribute matches exactly
• Check conditions: If using conditions, verify they're being met
• Check requirements: Verify requiredLevel and requiredModifiers are satisfied
• Check incompatibilities: Ensure no incompatibleModifiers are active

Modifier values not showing in Inspector

• Modifiers write to modifierBonus, not baseValue
• Check that you're looking at the correct property
• totalValue = baseValue + formulaBonus + modifierBonus

Conditions never evaluate to true

• For percentage comparisons, threshold is 0-100 (not 0-1)
• Check that the attribute exists and has valid values
• Use the generated CanApply method to debug condition evaluation

Assets not auto-created after generation

• Wait for Unity to finish compiling
• Check the console for error messages
• Try triggering a recompile (Ctrl+R or Assets > Reimport All)
• Check the asset path in Step 3 settings

Character Template Issues

Template doesn't apply all values

• Check that UseOverride is enabled for each attribute
• Vital-type attributes may be calculated by the Influence System
• Only override base attributes, not derived ones

Template wizard shows "No attributes found"

• Ensure you've selected a valid AttributeData asset
• The asset must implement ISimpleAttributeDataSource
• Check that the asset has attribute definitions

Code Generation Issues

Compilation errors after generation

• Check for namespace conflicts
• Ensure the namespace is valid C# (no spaces, special chars)
• Check the console for specific error messages

Generated code has wrong values

• Regenerate the code from the wizard
• Delete the Generated folder and regenerate
• Check wizard configuration before generating

Performance Issues

Modifier tracker causing lag

• Call ClearAll() when changing scenes if not using persistent modifiers
• Remove expired modifiers promptly
• Avoid calling GetActiveModifiers() every frame

Too many modifiers active

• Use maxStacks to limit stacking
• Set appropriate durations
• Remove unnecessary modifiers when done

Getting Help

If you can't resolve your issue:

1. Check the console for error messages
2. Review the relevant documentation sections
3. Check the Asset Store Q&A for similar issues
4. Contact support with:
   • Unity version
   • Simple Attribute Forge version
   • Steps to reproduce
   • Console error messages