Game Systems

Creating Dynamic Items

Generate rich, contextual items that adapt to your game's world state and player interactions using our item generation API.

Quick Start Guide

1. Define Base Item

Start with core properties like name, type, and basic attributes

2. Add Context

Include relevant lore, crafting conditions, or world state

3. Generate Details

Let the API flesh out descriptions and special properties

Key components of item systems

Item Types

Define different categories of items with unique properties and behaviors.
Properties & Attributes

Set up dynamic attributes that affect item behavior and value.
Item Visualization

Generate consistent item artwork using our image generation API.
Contextual Generation

Create items that fit your game's current state and location.
Balance & Scaling

Ensure items remain balanced and appropriate for player progression.

Item Types

Define different categories of items with their own unique properties and generation rules.

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"]
  }
}

Common Item Types

Equipment: Weapons, armor, accessories
Consumables: Potions, food, scrolls
Resources: Crafting materials, currencies

Special Types

Quest Items: Story-specific objects
Containers: Items that hold other items
Unique Items: One-of-a-kind artifacts

Properties & Attributes

Define how items interact with your game systems through properties and attributes.

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"
  }
}

Item Visualization

Generate visual representations of your items using our image generation API. This helps create consistent item art that matches your item descriptions and properties.

Example Image Generation

API Request

POST /generate/images

{
  "api_key": "your_api_key",
  "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
}

Tips for Item Image Generation

Be Specific: Include details about material, color, and distinctive features
Add Style Tags: Append style descriptors after your main description (e.g., "fantasy, game item, realistic")
Use Negative Prompts: Exclude unwanted features to improve consistency
Consider View Angle: Specify the viewing angle for better item presentation

Available Styles

Base Styles

• game_item: Standard game inventory style
• character: Character portraits and models
• skill_icon: Ability and skill icons

Style Tags

• fantasy: Fantasy game aesthetic
• realistic: Photorealistic rendering
• cartoon: Stylized appearance

Response Format

The API returns a JSON object containing the base64-encoded image data:

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

Contextual Generation

Create items that are appropriate for their context and location in your game world.

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"
    }
  ]
}

Balance & Scaling

Ensure your generated items remain balanced and appropriate for player progression.

Scaling Factors

Player Level: Base power scaling
Zone Difficulty: Location-based adjustments
Rarity Tiers: Quality multipliers

Balance Checks

Power Budget: Total stat allocation
Unique Effects: Special property limits
Economic Impact: Value and rarity checks

Example Balance Check

System: Validate and adjust item properties for balance.

Input Item:
{
  "name": "Dragonfire Bow",
  "level": 10,
  "rarity": "RARE",
  "properties": {
    "damage": 45,
    "fire_damage": 20,
    "attack_speed": 1.5
  }
}

Balance Analysis: {
  "power_budget": {
    "expected": 100,
    "current": 135,
    "adjustment_needed": true
  },
  "suggested_adjustments": [
    {
      "property": "damage",
      "current": 45,
      "suggested": 35,
      "reason": "Above curve for level 10 rare weapon"
    },
    {
      "property": "fire_damage",
      "current": 20,
      "suggested": 15,
      "reason": "Secondary damage too high for level"
    }
  ],
  "rarity_check": {
    "property_count": "valid",
    "power_level": "needs adjustment",
    "uniqueness": "acceptable"
  }
}

Common Item Patterns

Do ✓

Use consistent property names
Include contextual descriptions
Validate balance constraints

Don't ✗

Generate without context
Skip balance validation
Ignore economic impact

Want to learn more?

Check out our guides on building NPCs and creating quests.