feat(api): implement Diablo-style item affix system
Add procedural item generation with affix naming system: - Items with RARE/EPIC/LEGENDARY rarity get dynamic names - Prefixes (e.g., "Flaming") add elemental damage, material bonuses - Suffixes (e.g., "of Strength") add stat bonuses - Affix count scales with rarity: RARE=1, EPIC=2, LEGENDARY=3 New files: - models/affixes.py: Affix and BaseItemTemplate dataclasses - services/affix_loader.py: YAML-based affix pool loading - services/base_item_loader.py: Base item template loading - services/item_generator.py: Main procedural generation service - data/affixes/prefixes.yaml: 14 prefix definitions - data/affixes/suffixes.yaml: 15 suffix definitions - data/base_items/weapons.yaml: 12 weapon templates - data/base_items/armor.yaml: 12 armor templates - tests/test_item_generator.py: 34 comprehensive tests Modified: - enums.py: Added AffixType and AffixTier enums - items.py: Added affix tracking fields (applied_affixes, generated_name) Example output: "Frozen Dagger of the Bear" (EPIC with ice damage + STR/CON)
This commit is contained in:
177
api/app/data/affixes/prefixes.yaml
Normal file
177
api/app/data/affixes/prefixes.yaml
Normal file
@@ -0,0 +1,177 @@
|
||||
# Item Prefix Affixes
|
||||
# Prefixes appear before the item name: "Flaming Dagger"
|
||||
#
|
||||
# Affix Structure:
|
||||
# affix_id: Unique identifier
|
||||
# name: Display name (what appears in the item name)
|
||||
# affix_type: "prefix"
|
||||
# tier: "minor" (RARE), "major" (EPIC), "legendary" (LEGENDARY only)
|
||||
# description: Flavor text describing the effect
|
||||
# stat_bonuses: Dict of stat_name -> bonus value
|
||||
# defense_bonus: Direct defense bonus
|
||||
# resistance_bonus: Direct resistance bonus
|
||||
# damage_bonus: Flat damage bonus (weapons)
|
||||
# damage_type: Elemental damage type
|
||||
# elemental_ratio: Portion converted to elemental (0.0-1.0)
|
||||
# crit_chance_bonus: Added to crit chance
|
||||
# crit_multiplier_bonus: Added to crit multiplier
|
||||
# allowed_item_types: [] = all types, or ["weapon", "armor"]
|
||||
# required_rarity: null = any, or "legendary"
|
||||
|
||||
prefixes:
|
||||
# ==================== ELEMENTAL PREFIXES (FIRE) ====================
|
||||
flaming:
|
||||
affix_id: "flaming"
|
||||
name: "Flaming"
|
||||
affix_type: "prefix"
|
||||
tier: "minor"
|
||||
description: "Imbued with fire magic, dealing bonus fire damage"
|
||||
damage_type: "fire"
|
||||
elemental_ratio: 0.25
|
||||
damage_bonus: 3
|
||||
allowed_item_types: ["weapon"]
|
||||
|
||||
blazing:
|
||||
affix_id: "blazing"
|
||||
name: "Blazing"
|
||||
affix_type: "prefix"
|
||||
tier: "major"
|
||||
description: "Wreathed in intense flames"
|
||||
damage_type: "fire"
|
||||
elemental_ratio: 0.35
|
||||
damage_bonus: 6
|
||||
allowed_item_types: ["weapon"]
|
||||
|
||||
# ==================== ELEMENTAL PREFIXES (ICE) ====================
|
||||
frozen:
|
||||
affix_id: "frozen"
|
||||
name: "Frozen"
|
||||
affix_type: "prefix"
|
||||
tier: "minor"
|
||||
description: "Enchanted with frost magic"
|
||||
damage_type: "ice"
|
||||
elemental_ratio: 0.25
|
||||
damage_bonus: 3
|
||||
allowed_item_types: ["weapon"]
|
||||
|
||||
glacial:
|
||||
affix_id: "glacial"
|
||||
name: "Glacial"
|
||||
affix_type: "prefix"
|
||||
tier: "major"
|
||||
description: "Encased in eternal ice"
|
||||
damage_type: "ice"
|
||||
elemental_ratio: 0.35
|
||||
damage_bonus: 6
|
||||
allowed_item_types: ["weapon"]
|
||||
|
||||
# ==================== ELEMENTAL PREFIXES (LIGHTNING) ====================
|
||||
shocking:
|
||||
affix_id: "shocking"
|
||||
name: "Shocking"
|
||||
affix_type: "prefix"
|
||||
tier: "minor"
|
||||
description: "Crackles with electrical energy"
|
||||
damage_type: "lightning"
|
||||
elemental_ratio: 0.25
|
||||
damage_bonus: 3
|
||||
allowed_item_types: ["weapon"]
|
||||
|
||||
thundering:
|
||||
affix_id: "thundering"
|
||||
name: "Thundering"
|
||||
affix_type: "prefix"
|
||||
tier: "major"
|
||||
description: "Charged with the power of storms"
|
||||
damage_type: "lightning"
|
||||
elemental_ratio: 0.35
|
||||
damage_bonus: 6
|
||||
allowed_item_types: ["weapon"]
|
||||
|
||||
# ==================== MATERIAL PREFIXES ====================
|
||||
iron:
|
||||
affix_id: "iron"
|
||||
name: "Iron"
|
||||
affix_type: "prefix"
|
||||
tier: "minor"
|
||||
description: "Reinforced with sturdy iron"
|
||||
stat_bonuses:
|
||||
constitution: 1
|
||||
defense_bonus: 2
|
||||
|
||||
steel:
|
||||
affix_id: "steel"
|
||||
name: "Steel"
|
||||
affix_type: "prefix"
|
||||
tier: "major"
|
||||
description: "Forged from fine steel"
|
||||
stat_bonuses:
|
||||
constitution: 2
|
||||
strength: 1
|
||||
defense_bonus: 4
|
||||
|
||||
# ==================== QUALITY PREFIXES ====================
|
||||
sharp:
|
||||
affix_id: "sharp"
|
||||
name: "Sharp"
|
||||
affix_type: "prefix"
|
||||
tier: "minor"
|
||||
description: "Honed to a fine edge"
|
||||
damage_bonus: 3
|
||||
crit_chance_bonus: 0.02
|
||||
allowed_item_types: ["weapon"]
|
||||
|
||||
keen:
|
||||
affix_id: "keen"
|
||||
name: "Keen"
|
||||
affix_type: "prefix"
|
||||
tier: "major"
|
||||
description: "Razor-sharp edge that finds weak points"
|
||||
damage_bonus: 5
|
||||
crit_chance_bonus: 0.04
|
||||
allowed_item_types: ["weapon"]
|
||||
|
||||
# ==================== DEFENSIVE PREFIXES ====================
|
||||
sturdy:
|
||||
affix_id: "sturdy"
|
||||
name: "Sturdy"
|
||||
affix_type: "prefix"
|
||||
tier: "minor"
|
||||
description: "Built to withstand punishment"
|
||||
defense_bonus: 3
|
||||
allowed_item_types: ["armor"]
|
||||
|
||||
reinforced:
|
||||
affix_id: "reinforced"
|
||||
name: "Reinforced"
|
||||
affix_type: "prefix"
|
||||
tier: "major"
|
||||
description: "Heavily reinforced for maximum protection"
|
||||
defense_bonus: 5
|
||||
resistance_bonus: 2
|
||||
allowed_item_types: ["armor"]
|
||||
|
||||
# ==================== LEGENDARY PREFIXES ====================
|
||||
infernal:
|
||||
affix_id: "infernal"
|
||||
name: "Infernal"
|
||||
affix_type: "prefix"
|
||||
tier: "legendary"
|
||||
description: "Burns with hellfire"
|
||||
damage_type: "fire"
|
||||
elemental_ratio: 0.45
|
||||
damage_bonus: 12
|
||||
allowed_item_types: ["weapon"]
|
||||
required_rarity: "legendary"
|
||||
|
||||
vorpal:
|
||||
affix_id: "vorpal"
|
||||
name: "Vorpal"
|
||||
affix_type: "prefix"
|
||||
tier: "legendary"
|
||||
description: "Cuts through anything with supernatural precision"
|
||||
damage_bonus: 10
|
||||
crit_chance_bonus: 0.08
|
||||
crit_multiplier_bonus: 0.5
|
||||
allowed_item_types: ["weapon"]
|
||||
required_rarity: "legendary"
|
||||
155
api/app/data/affixes/suffixes.yaml
Normal file
155
api/app/data/affixes/suffixes.yaml
Normal file
@@ -0,0 +1,155 @@
|
||||
# Item Suffix Affixes
|
||||
# Suffixes appear after the item name: "Dagger of Strength"
|
||||
#
|
||||
# Suffix naming convention:
|
||||
# - Minor tier: "of [Stat]" (e.g., "of Strength")
|
||||
# - Major tier: "of the [Animal/Element]" (e.g., "of the Bear")
|
||||
# - Legendary tier: "of the [Mythical]" (e.g., "of the Titan")
|
||||
|
||||
suffixes:
|
||||
# ==================== STAT SUFFIXES (MINOR) ====================
|
||||
of_strength:
|
||||
affix_id: "of_strength"
|
||||
name: "of Strength"
|
||||
affix_type: "suffix"
|
||||
tier: "minor"
|
||||
description: "Grants physical power"
|
||||
stat_bonuses:
|
||||
strength: 2
|
||||
|
||||
of_dexterity:
|
||||
affix_id: "of_dexterity"
|
||||
name: "of Dexterity"
|
||||
affix_type: "suffix"
|
||||
tier: "minor"
|
||||
description: "Grants agility and precision"
|
||||
stat_bonuses:
|
||||
dexterity: 2
|
||||
|
||||
of_constitution:
|
||||
affix_id: "of_constitution"
|
||||
name: "of Fortitude"
|
||||
affix_type: "suffix"
|
||||
tier: "minor"
|
||||
description: "Grants endurance"
|
||||
stat_bonuses:
|
||||
constitution: 2
|
||||
|
||||
of_intelligence:
|
||||
affix_id: "of_intelligence"
|
||||
name: "of Intelligence"
|
||||
affix_type: "suffix"
|
||||
tier: "minor"
|
||||
description: "Grants magical aptitude"
|
||||
stat_bonuses:
|
||||
intelligence: 2
|
||||
|
||||
of_wisdom:
|
||||
affix_id: "of_wisdom"
|
||||
name: "of Wisdom"
|
||||
affix_type: "suffix"
|
||||
tier: "minor"
|
||||
description: "Grants insight and perception"
|
||||
stat_bonuses:
|
||||
wisdom: 2
|
||||
|
||||
of_charisma:
|
||||
affix_id: "of_charisma"
|
||||
name: "of Charm"
|
||||
affix_type: "suffix"
|
||||
tier: "minor"
|
||||
description: "Grants social influence"
|
||||
stat_bonuses:
|
||||
charisma: 2
|
||||
|
||||
of_luck:
|
||||
affix_id: "of_luck"
|
||||
name: "of Fortune"
|
||||
affix_type: "suffix"
|
||||
tier: "minor"
|
||||
description: "Grants favor from fate"
|
||||
stat_bonuses:
|
||||
luck: 2
|
||||
|
||||
# ==================== ENHANCED STAT SUFFIXES (MAJOR) ====================
|
||||
of_the_bear:
|
||||
affix_id: "of_the_bear"
|
||||
name: "of the Bear"
|
||||
affix_type: "suffix"
|
||||
tier: "major"
|
||||
description: "Grants the might and endurance of a bear"
|
||||
stat_bonuses:
|
||||
strength: 4
|
||||
constitution: 2
|
||||
|
||||
of_the_fox:
|
||||
affix_id: "of_the_fox"
|
||||
name: "of the Fox"
|
||||
affix_type: "suffix"
|
||||
tier: "major"
|
||||
description: "Grants the cunning and agility of a fox"
|
||||
stat_bonuses:
|
||||
dexterity: 4
|
||||
luck: 2
|
||||
|
||||
of_the_owl:
|
||||
affix_id: "of_the_owl"
|
||||
name: "of the Owl"
|
||||
affix_type: "suffix"
|
||||
tier: "major"
|
||||
description: "Grants the wisdom and insight of an owl"
|
||||
stat_bonuses:
|
||||
intelligence: 3
|
||||
wisdom: 3
|
||||
|
||||
# ==================== DEFENSIVE SUFFIXES ====================
|
||||
of_protection:
|
||||
affix_id: "of_protection"
|
||||
name: "of Protection"
|
||||
affix_type: "suffix"
|
||||
tier: "minor"
|
||||
description: "Offers physical protection"
|
||||
defense_bonus: 3
|
||||
|
||||
of_warding:
|
||||
affix_id: "of_warding"
|
||||
name: "of Warding"
|
||||
affix_type: "suffix"
|
||||
tier: "major"
|
||||
description: "Wards against physical and magical harm"
|
||||
defense_bonus: 5
|
||||
resistance_bonus: 3
|
||||
|
||||
# ==================== LEGENDARY SUFFIXES ====================
|
||||
of_the_titan:
|
||||
affix_id: "of_the_titan"
|
||||
name: "of the Titan"
|
||||
affix_type: "suffix"
|
||||
tier: "legendary"
|
||||
description: "Grants titanic strength and endurance"
|
||||
stat_bonuses:
|
||||
strength: 8
|
||||
constitution: 4
|
||||
required_rarity: "legendary"
|
||||
|
||||
of_the_wind:
|
||||
affix_id: "of_the_wind"
|
||||
name: "of the Wind"
|
||||
affix_type: "suffix"
|
||||
tier: "legendary"
|
||||
description: "Swift as the wind itself"
|
||||
stat_bonuses:
|
||||
dexterity: 8
|
||||
luck: 4
|
||||
crit_chance_bonus: 0.05
|
||||
required_rarity: "legendary"
|
||||
|
||||
of_invincibility:
|
||||
affix_id: "of_invincibility"
|
||||
name: "of Invincibility"
|
||||
affix_type: "suffix"
|
||||
tier: "legendary"
|
||||
description: "Grants supreme protection"
|
||||
defense_bonus: 10
|
||||
resistance_bonus: 8
|
||||
required_rarity: "legendary"
|
||||
Reference in New Issue
Block a user