modding-doc-affix-system

To define new affixes in the Hyforged system, you create JSON stat definitions in the Server/Hyforged/Affixes/Definitions directory, add them to an affix pool, and wire them to the AffixService for runtime rolling onto items.

An affix pool is a JSON-defined collection grouping specific affixes for targeted item rolling. The Hyforged system uses these pools with targeting rules to determine which stat definitions can be randomly applied to a given item during runtime.

Yes, the Hyforged affix system supports multi-stat and triggered-effect affixes through its JSON schemas. It provides step-by-step guidance and examples for common patterns to translate these complex designs into mod data.

After defining an affix in the resources directory and adding it to a pool, you test it by rolling the affix onto an item. The system provides workflow guidance for testing and debugging affixes, pools, and related runtime rules.

Yes, the affix system enforces frontmatter metadata and JSON schemas for all affix and pool definitions. This ensures consistent design and proper integration with the API and modding documentation when building content.

Incorrect rolling often stems from misconfigured pool targeting rules or JSON schema validation errors. The system provides debugging guidance to check your definitions, pool wiring, and AffixService integration to resolve these runtime issues.