Creating Dynamic Items

Example Item Schema

{
  "type": "WEAPON",
  "subtype": "SWORD",
  "rarity": "RARE",
  "properties": {
    "damage": {"base": 10, "scaling": "strength"},
    "durability": 100,
    "requirements": {
      "level": 5,
      "strength": 8
    }
  },
  "tags": ["melee", "slashing", "metal"],
  "generation_rules": {
    "name_patterns": ["[Material] [Type] of [Effect]"],
    "valid_materials": ["iron", "steel", "silver"],
    "possible_effects": ["frost", "flame", "thunder"]
  }
}

Core Item Schema

{
  // Basic identification
  "id": "unique-item-identifier",
  "name": "Stormbringer",
  "description": "A blade that crackles with lightning energy",
  
  // Classification
  "type": "WEAPON",           // Primary category
  "subtype": "SWORD",         // More specific type
  "rarity": "EPIC",           // Rarity tier
  "level": 45,                // Item power level
  "tags": ["magic", "lightning", "one-handed", "metal"], // Searchable traits

  // Core Stats
  "base_stats": {
    "damage": 120,
    "attack_speed": 1.3,
    "durability": 400,
    "value": 5000
  },

  // Requirements
  "requirements": {
    "level": 42,
    "strength": 35,
    "class": ["warrior", "paladin"]
  },

  // Visual representation
  "appearance": {
    "model_id": "sword_curved_01",
    "texture": "lightning_metal",
    "scale": 1.05,
    "glow_effect": "electric_blue",
    "equip_position": {"x": 0.2, "y": -0.1, "z": 0.05}
  },
  
  // Game mechanics
  "behaviors": {
    "equip_effect": "apply_lightning_aura",
    "use_ability": "chain_lightning",
    "cooldown": 60,          // seconds
    "proc_chance": 0.15
  },

  // Lore & flavor
  "lore": {
    "origin": "Forged in the heart of an eternal storm",
    "creator": "Archmage Keldorn",
    "age": 327,
    "notable_owners": ["Storm Queen Aelisa", "Lord Commander Thorne"]
  },

  // Meta information
  "meta": {
    "generation_date": "2023-09-15T14:22:31Z",
    "generation_context": "thunder_mountain_boss_drop",
    "version": "1.2"
  }
}

Example Property Generation

System: Generate properties for a magical sword found in an ancient frost giant's lair.

Response: {
  "name": "Rimefrost Blade",
  "base_properties": {
    "damage": 15,
    "attack_speed": 1.2,
    "durability": 200
  },
  "magical_properties": {
    "frost_damage": 5,
    "cold_resistance": 20,
    "special_effect": "Chance to freeze targets"
  },
  "lore_properties": {
    "origin": "Forged in the eternal ice of the Giant's Reach",
    "age": "Several centuries old",
    "previous_owner": "Frost Giant Jarl Kolvir"
  },
  "condition": {
    "current": "frozen",
    "restoration_needed": false,
    "special_handling": "Must be kept below freezing"
  }
}

Example Image Generation

POST /generate/images

{
  "client_id": "player_12345",
  "client_id": "unique_player_id",
  "prompt": "A frost-covered longsword with ancient Nordic runes etched along its blade. The pommel features a sapphire that pulses with cold energy. The blade appears to be made of enchanted ice-steel, fantasy style, game item, 3/4 view, cool blue ambient light",
  "negative_prompt": "broken, rusted, dull, modern",
  "style": "game_item",
  "width": 512,
  "height": 512,
  "steps": 15
}

{
  "image": "base64_encoded_image_data",
  "metadata": {
    "width": 512,
    "height": 512,
    "format": "png",
    "style": "game_item"
  }
}

Example Context-Based Generation

System: Generate a merchant's inventory based on their location and current events.

Context:
- Desert trading post
- Recent sandstorm
- Nearby oasis discovered
- Traveling alchemist visiting

Response: {
  "inventory": [
    {
      "name": "Sand Goggles",
      "type": "EQUIPMENT",
      "rarity": "COMMON",
      "properties": {
        "vision": "Clear sight in sandstorms",
        "durability": 50
      },
      "price": {"base": 25, "modifier": 1.5},
      "stock": 5,
      "description": "Essential protection against the recent storms"
    },
    {
      "name": "Oasis Water Flask",
      "type": "CONTAINER",
      "rarity": "UNCOMMON",
      "properties": {
        "capacity": 5,
        "effect": "Water stays cool for 24 hours"
      },
      "price": {"base": 40, "modifier": 1.2},
      "stock": 3,
      "description": "Made from the newly discovered oasis's blessed waters"
    }
  ]
}

Power Budget Framework

The power budget system allocates a fixed amount of "power points" based on item level and rarity:

{
  "power_budget_system": {
    "base_formulas": {
      "base_budget": "10 + (level * 5)",           // Linear scaling with level
      "rarity_multipliers": {                      // Higher rarities get more budget
        "COMMON": 0.8,
        "UNCOMMON": 1.0,
        "RARE": 1.3,
        "EPIC": 1.6,
        "LEGENDARY": 2.0,
        "MYTHIC": 3.0
      },
      "slot_modifiers": {                          // Different equipment slots get different allocations
        "WEAPON": 1.0,                            // Full budget
        "CHEST": 0.9,                             // 90% of budget
        "HELMET": 0.6,
        "LEGS": 0.75,
        "BOOTS": 0.5,
        "GLOVES": 0.5,
        "ACCESSORY": 0.4
      }
    },
    
    "stat_costs": {                                // Each stat has a power cost per point
      "damage": 1.0,                             // 1 damage = 1 power point
      "armor": 0.8,                              // 1 armor = 0.8 power points
      "health": 0.2,                             // 1 health = 0.2 power points
      "critical_chance": 5.0,                     // 1% crit = 5 power points
      "movement_speed": 10.0,                     // 1% speed = 10 power points
      "special_effects": {                        // Special effects have fixed costs
        "on_hit_fire": 25,
        "lifesteal": 40,
        "aoe_damage": 35
      }
    },
    
    "distribution_rules": {
      "primary_stat_percent": 0.6,                // 60% of budget goes to primary stats
      "secondary_stat_percent": 0.3,              // 30% to secondary stats
      "special_effect_percent": 0.1,              // 10% to special effects
      "max_special_effects_by_rarity": {          // Limit special effects by rarity
        "COMMON": 0,
        "UNCOMMON": 0,
        "RARE": 1,
        "EPIC": 1,
        "LEGENDARY": 2,
        "MYTHIC": 3
      }
    }
  }
}

Dynamic Balance Adjustment

Use the AI to analyze and adjust item balance:

// 1. Input item to balance check
const itemToCheck = {
  "name": "Dragonfire Bow",
  "level": 10,
  "rarity": "RARE",
  "properties": {
    "damage": 45,
    "fire_damage": 20,
    "attack_speed": 1.5
  }
};

// 2. Balance analysis response
const balanceAnalysis = {
  "power_budget": {
    "expected": 100,    // Based on level & rarity
    "current": 135,     // Sum of weighted stats
    "adjustment_needed": true
  },
  "stat_breakdown": {
    "damage": {"value": 45, "power_cost": 45, "expected_range": "30-40"},
    "fire_damage": {"value": 20, "power_cost": 40, "expected_range": "10-15"},
    "attack_speed": {"value": 1.5, "power_cost": 50, "expected_range": "1.2-1.4"}
  },
  "suggested_adjustments": [
    {
      "property": "damage",
      "current": 45,
      "suggested": 35,
      "reason": "Above curve for level 10 rare weapon",
      "power_saved": 10
    },
    {
      "property": "fire_damage",
      "current": 20,
      "suggested": 15,
      "reason": "Secondary damage too high for level",
      "power_saved": 10
    },
    {
      "property": "attack_speed",
      "current": 1.5,
      "suggested": 1.4,
      "reason": "Slightly faster than expected",
      "power_saved": 15
    }
  ],
  "rarity_assessment": {
    "property_count": "valid",     // Number of properties matches rarity
    "power_level": "overtuned",    // Too powerful for stated rarity
    "recommendation": "Adjust stats down or increase rarity to EPIC"
  },
  "economic_impact": {
    "relative_value": "Very high for level",
    "market_disruption": "High - would devalue similar items",
    "suggested_value": 850
  },
  "adjusted_item": {
    "name": "Dragonfire Bow",
    "level": 10,
    "rarity": "RARE",
    "properties": {
      "damage": 35,
      "fire_damage": 15,
      "attack_speed": 1.4
    },
    "power_budget": {
      "total": 100,
      "breakdown": {"damage": 35, "fire_damage": 30, "attack_speed": 35}
    }
  }
}

Guided Creation Framework

A player-accessible interface for generating items with appropriate constraints:

// Player submission to item creation system
{
  "player_id": "user_12345",
  "creation_context": {
    "player_level": 25,
    "crafting_skill": 78,         // 0-100 scale
    "specialization": "blacksmith",
    "location": "dwarven_forge",
    "available_materials": [
      {"name": "steel_ingot", "quality": "high", "quantity": 5},
      {"name": "fire_essence", "quality": "medium", "quantity": 2},
      {"name": "dragon_scale", "quality": "flawless", "quantity": 1}
    ],
    "unlocked_patterns": ["curved_blade", "balanced_grip", "flame_enchant"]
  },
  
  "item_intent": {
    "type": "WEAPON",
    "subtype": "SWORD",
    "preferred_stats": ["fire_damage", "attack_speed"],
    "playstyle": "aggressive",
    "name_preference": "something related to dragons",
    "description": "I want a curved sword that channels the power of dragon fire"
  },
  
  "customization_choices": {
    "blade_shape": "curved",
    "primary_material": "steel_ingot",
    "enchantment_focus": "fire_essence",
    "special_component": "dragon_scale"
  }
}

{
  "generated_item": {
    "name": "Draconis Edge",
    "type": "WEAPON",
    "subtype": "SWORD",
    "rarity": "RARE",           // Based on crafting skill and materials
    "level": 25,               // Matches player level
    "description": "A curved blade of polished steel with a dragon scale embedded in the pommel. The edge glows with an inner fire when drawn.",
    
    "properties": {
      "damage": 42,
      "attack_speed": 1.4,
      "fire_damage": 18,
      "durability": 220
    },
    
    "special_effect": {
      "name": "Dragon's Fury",
      "description": "Has a 10% chance to engulf the target in flames, dealing 5 fire damage per second for 3 seconds",
      "trigger": "on_hit",
      "proc_chance": 0.1
    },
    
    "appearance": {
      "model_base": "curved_sword",
      "material_tint": "#747474",  // Steel color
      "glow_effect": "fire_orange",
      "special_features": ["dragon_scale_pommel", "glowing_runes"]
    },
    
    "crafting_quality": 78,     // Based on player's crafting skill
    "creation_signature": "Forged by [PLAYER_NAME]"
  },
  
  "material_consumption": [
    {"material": "steel_ingot", "amount": 4},
    {"material": "fire_essence", "amount": 2},
    {"material": "dragon_scale", "amount": 1}
  ],
  
  "experience_reward": 350,    // Crafting XP granted
  
  "balance_evaluation": {
    "power_level": "appropriate_for_level",
    "uniqueness": "sufficiently_distinct",
    "economic_impact": "moderate_value"
  },
  
  "additional_unlocks": {
    "new_pattern": "dragon_infusion",
    "unlock_message": "Working with dragon materials has taught you how to better infuse their power!"
  }
}

Multi-Layer Generation Process

The complete item generation pipeline:

// 1. Generation Context Collection
const generationContext = {
  // Location and environmental factors
  "location": {
    "area_name": "Frostpeak Mountains",
    "biome_type": "alpine",
    "danger_level": 7,   // 1-10 scale
    "nearby_elements": ["ice", "stone", "wind"],
    "local_culture": "northern_tribes"
  },
  
  // Source information (where/how the item is obtained)
  "source": {
    "source_type": "enemy_drop",
    "enemy_type": "frost_giant",
    "enemy_rank": "elite",
    "enemy_level": 35
  },
  
  // Player and game state
  "player": {
    "level": 32,
    "class": "ranger",
    "recent_upgrades": ["bow", "boots"],
    "playstyle": "mobility_focused"
  },
  
  // Rarity distribution settings
  "rarity_weights": {
    "COMMON": 50,
    "UNCOMMON": 30,
    "RARE": 15,
    "EPIC": 4,
    "LEGENDARY": 1
  },
  
  // Generation control
  "generation_flags": {
    "enforce_theme": true,
    "allow_unique_effects": true,
    "bias_towards": "weapons",
    "restrict_types": []
  }
};

// 2. Generation Process
function generateProcedural(context) {
  // Determine item base type and rarity first
  const itemType = selectItemType(context);
  const itemRarity = rollRarity(context.rarity_weights);
  
  // Select base template based on type
  const baseTemplate = getBaseTemplate(itemType, context.source);
  
  // Calculate power budget based on level, rarity, etc.
  const powerBudget = calculatePowerBudget(context.player.level, itemRarity, itemType);
  
  // Generate core properties
  const coreProps = generateCoreProperties(baseTemplate, powerBudget);
  
  // Add thematic elements based on context
  const thematicProps = addThematicProperties(coreProps, context.location);
  
  // Apply special effects based on rarity and source
  const withEffects = addSpecialEffects(thematicProps, itemRarity, context.source);
  
  // Generate descriptive elements
  const withDescriptions = generateDescriptions(withEffects, context);
  
  // Final balance check and adjustments
  return performBalanceCheck(withDescriptions, context.player);
}

Advanced Name Generation

Generating thematic and meaningful item names:

{  
  "messages": [
    {
      "role": "system",
      "content": "Generate a thematically appropriate name for an item based on its properties and context. Respond with only the name, no additional text."
    },
    {
      "role": "user",
      "content": "Item type: Bow\nRarity: Epic\nKey properties: Increases attack speed, grants stealth when standing still\nTheme: Ancient elven forest\nMaterials: Rare darkwood, silverthread string\nHistorical context: Created during a war between elves and demons"
    }
  ],
  "temperature": 0.7,
  "max_tokens": 15
}

Intuitive Combination System

Allow players to discover crafting possibilities through experimentation:

// Player attempts to combine items
{
  "player_id": "user_12345",
  "crafting_action": "combine",
  "ingredients": [
    {"item_id": "iron_sword", "quantity": 1},
    {"item_id": "fire_essence", "quantity": 2}
  ],
  "crafting_tool": "blacksmith_anvil",
  "player_description": "I want to infuse this sword with fire power"
}

// System analyzes combination logic
function analyzeCombination(ingredients, tool, description) {
  // Check for known recipes first
  const knownRecipe = checkKnownRecipes(ingredients, tool);
  if (knownRecipe) return processKnownRecipe(knownRecipe, ingredients);
  
  // No known recipe, check for valid theoretical combinations
  const compatibility = checkMaterialCompatibility(ingredients);
  if (!compatibility.compatible) {
    return {
      success: false,
      message: compatibility.reason,
      alternative_suggestion: suggestAlternative(ingredients)
    };
  }
  
  // Generate a new item based on the combination logic
  return generateDynamicCombination(ingredients, tool, description);
}

// Response with new item
{
  "success": true,
  "result": {
    "item": {
      "id": "fire_infused_iron_sword_12345",
      "name": "Flamebrand Iron Sword",
      "type": "WEAPON",
      "rarity": "UNCOMMON",
      "properties": {
        "damage": 15,            // Base from iron sword
        "fire_damage": 7,        // Added from fire essence
        "durability": 80,        // Slightly reduced from base
        "special_effect": "5% chance to ignite targets"
      }
    },
    "consumed_ingredients": ["iron_sword", "fire_essence", "fire_essence"],
    "crafting_exp": 25,
    "new_recipe_discovered": true,
    "flavor_text": "As the fire essence melds with the blade, the metal takes on a reddish hue and radiates a gentle warmth."
  }
}

Example API Implementation

// Request to generate multiple themed items with specific format constraints
POST /v1/generate/items

{
  "client_id": "game_session_12345",
  "client_id": "game_session_12345",
  "generation_context": {
    "location": "volcanic_cavern",
    "enemy": "fire_elemental",
    "player_level": 35,
    "theme": "fire_and_lava"
  },
  "items": [
    {
      "type": "WEAPON",
      "subtype": "STAFF",
      "rarity": "RARE",
      "focus": "casting_speed"
    },
    {
      "type": "ACCESSORY",
      "subtype": "AMULET",
      "rarity": "EPIC",
      "focus": "fire_resistance"
    }
  ],
  "constraints": {
    "power_budget": "standard",
    "naming_style": "fantasy",
    "ensure_uniqueness": true
  },
  "response_format": { "type": "json_object" }
}