Simple Attribute Forge Ultimate

Advanced Formula & Influence System for Unity

Welcome to Simple Attribute Forge Ultimate

Simple Attribute Forge Ultimate extends the base Simple Attribute Forge system with powerful mathematical formula relationships, breakpoint conditions, and automated orchestration. Create complex RPG mechanics through visual editors without writing formula code.

Requirements: This Ultimate system requires the base Simple Attribute Forge system to be installed and configured first. The Ultimate system integrates seamlessly with existing attribute containers through the three-tier value architecture.

System Architecture

Three-Tier Value Integration

The Pro system integrates perfectly with the base system's three-tier architecture:

totalValue = baseValue + formulaBonus + modifierBonus

Where:
-baseValue    - Base attribute value (equipment, upgrades)
-formulaBonus - Calculated by Pro system formulas  
-modifierBonus - Temporary effects (buffs, debuffs)

Formula Data Flow

Formulas read from baseValue and write to formulaBonus, preventing feedback loops:

Step 1: Read baseValue from source attributes

↓

Step 2: Execute 7-step mathematical pipeline

↓

Step 3: Write result to formulaBonus

↓

Step 4: Base system calculates totalValue

Key Features

Visual Formula Editor

Create complex mathematical relationships through intuitive GUI. Seven-step pipeline system handles flat bonuses, percentages, multipliers, and conditional breakpoints.

Breakpoint System

Conditional effects that activate based on attribute values. Support for threshold and step-based triggers with multiple conditions.

Code Generation

Generates complete orchestrator MonoBehaviour with typed methods, validation, and performance optimizations. No manual coding required.

Import/Export

Full JSON import/export with schema validation. Share formulas between projects or version control your attribute systems.

Performance Optimized

Smart dependency tracking, automatic caching, configurable update modes, and circular dependency prevention.

Runtime Testing

Built-in test panel for formula validation, live calculation preview, and debugging tools. Test edge cases before deployment.

Regen Rate Targeting

Formulas can target RegenerationRate or RegenerationDelay for Vital attributes. Create dynamic regen systems driven by stats like Level or Endurance.

7-Step Formula Pipeline

Every formula follows the same mathematical pipeline for consistent, predictable results:

Mathematical Formula

Result = PostFlat + ((Start + Flat) × (1 + AddPct% - SubPct%) × Multipliers)

1 Starting Point: Choose Zero or use target attribute's baseValue

2 Flat Bonuses: Add/subtract values based on source attributes (STR × 2)

3 Additive Percentages: Percentage increases (INT adds 5% spell damage)

4 Subtractive Percentages: Percentage decreases (Encumbrance reduces movement)

5 Multipliers: Static multiplication factors (Equipment bonus ×1.2)

6 Post-Flat Bonuses: Final flat adjustments (Set bonus +50)

7 Apply Mode: How result affects target (Override, Add, or Subtract)

Getting Started

Prerequisites

Simple Attribute Forge (base system) installed and configured
Generated attribute container implementing ISimpleAttributeDataSource
Unity 2021.3 or later

Quick Setup Process

Open Influence Wizard: Window → Simple Attribute Forge → Influence Wizard
Setup Tab: Select your AttributeData ScriptableObject
Formulas Tab: Create your first formula (e.g., STR affects Damage)
Configuration Tab: Set system name and export paths
Generate Tab: Create orchestrator and formula assets

Ready to go! Your orchestrator will automatically manage formula calculations and integrate with your existing attribute system.

Core Concepts

Formula Assets

Formulas are stored as ScriptableObject assets that can be edited in the Inspector after creation. This data-driven approach allows for easy modification without recompiling code.

Orchestrator Component

The generated orchestrator MonoBehaviour manages all formula execution, dependency tracking, and performance optimization. It implements IAttributeProvider for seamless integration.

Dependency Management

The system automatically tracks which formulas depend on which attributes, enabling smart recalculation that only updates affected formulas when values change.

Update Modes

Smart: Event-driven updates (recommended for most games)
Interval: Fixed-time updates (performance-critical scenarios)
Manual: Explicit control (turn-based games)

Real-World Applications

RPG Character Progression

Level affects Health and Mana, STR affects Damage and Carry Capacity, INT affects Mana and Spell Damage with breakpoint bonuses.

Equipment Systems

Weapon damage formulas, armor defense calculations, set bonuses through post-flat bonuses, conditional effects.

Combat Mechanics

Critical hit calculations, damage resistance formulas, healing effectiveness, status effect interactions.

Progression Systems

Skill point allocation effects, talent tree bonuses, prestige system multipliers, achievement bonuses.

Documentation Sections

Quick Start Guide

Step-by-step tutorial for creating your first formula system. Includes complete RPG character example with level progression.

Formula Pipeline

Deep dive into the 7-step mathematical pipeline. Understanding each step with detailed examples and use cases.

Formula Examples

Extensive collection of real-world formula patterns. From basic stat scaling to complex conditional systems.

Breakpoint System

Advanced conditional logic system. Create threshold-based bonuses and step-based scaling with multiple conditions.

Wizard Interface

Complete guide to the visual formula editor. Learn keyboard shortcuts, testing tools, and advanced features.

Orchestrator Setup

Configuring and using the generated orchestrator component. Performance tuning and integration patterns.

API Reference

Complete API documentation for all Pro system classes, interfaces, and extension methods.

Migration Guide

Upgrading from base system to Pro. Breaking changes, integration steps, and compatibility information.

Import/Export

JSON schema documentation, sharing formulas between projects, and version control integration.

Troubleshooting

Common issues and solutions. Debug tools, performance optimization, and integration problems.

Demo Scene

Walkthrough of the included demo scene. Understanding the complete implementation example.

System Requirements

Technical Requirements

Unity 2021.3 or later
Simple Attribute Forge (base system) installed
Generated attribute container with ISimpleAttributeDataSource implementation
.NET Standard 2.1 compatible

Performance Characteristics

Zero GC allocation during formula calculation
Smart dependency tracking minimizes recalculation
Configurable update modes for different game types
Built-in circular dependency prevention
Optional caching for high-frequency calculations

Quick Integration Preview

Here's how easy it is to add formula relationships to your existing attributes:

1 Existing Base System: You already have CharacterAttributes with Health, Mana, STR, etc.

// Your existing generated component
public class CharacterAttributes : MonoBehaviour, ISimpleAttributeDataSource
{
    public SimpleRuntimeAttribute health;    // baseValue: 100
    public SimpleRuntimeAttribute strength;  // baseValue: 10
    public SimpleRuntimeAttribute level;     // baseValue: 1
}

2 Add Pro System: Create formula "Level affects Health"

Level Health Formula

Target: Health

Flat Bonus: Level × 10 (each level adds 10 health)

Apply Mode: Add to Base

3 Result: Automatic formula calculation integrated with your existing system

// Automatically calculated by orchestrator:
health.baseValue = 100        // Your original value
health.formulaBonus = 50      // Level 5 × 10 = 50
health.totalValue = 150       // Final calculated value

Zero Code Required! The Pro system integrates seamlessly with your existing attribute containers through the three-tier architecture.

Simple Forge Product Family

You're viewing documentation for Simple Attribute Forge Ultimate - the advanced formula system that extends the base Simple Attribute Forge with mathematical attribute relationships.

Base Version (Free)

Complete attribute generation system:

Full attribute wizard
Complete code generation
Coroutine-based regeneration
Event system
Performance optimizations
JSON import/export
Demo manager
Full documentation

Influence System (Current)

Adds the Influence System:

Attribute relationships
Formula-based influences
7-step mathematical pipeline
Breakpoint system
Visual formula editor
Auto-calculation chains
Performance optimization
Advanced debugging tools

Ultimate Version ($49.99)

Everything in Ultimate PLUS Modifier System & Character Templates:

Complete modifier framework
Conditional modifiers
ARPG regeneration modifiers
Buff/debuff behavior flags
Priority, stacking, duration
Character Template System
Class-based starting attributes
JSON import/export

Complete Edition - Coming Soon

Everything in Ultimate PLUS Forge Suite:

ItemForge - complete item system
QuestForge - quest generation
DialogueForge - conversation system
Integrated systems workflow
AAA-ready game templates
Lifetime updates
Premium support

Compatibility Promise: Each version builds on the previous one. Ultimate extends Base without breaking existing functionality. Your current attribute code continues to work unchanged.

Version & Support

Current Version

Simple Attribute Forge Ultimate v1.0 - Advanced Formula System

Support & Resources

Documentation: Complete guides and API reference included
Demo Scene: Working example with multiple formula types
JSON Export: Schema documentation for external tool integration
Extension Methods: Compatibility layer for existing code

Credits

Created by Living Failure - Extending Unity game development capabilities through visual tools and automated code generation.