Remove Item Step

Introduction

The Remove Item Step removes items from the player’s inventory, typically as payment, consumption, or quest requirements. It handles various scenarios from simple item costs to complex alternative payment options, ensuring players can spend resources as part of their cultivation journey.

This step provides flexible payment mechanisms and supports alternate item options, making it essential for creating meaningful resource costs and consumption mechanics in events.

Interface

interface RemoveItemStep {
  kind: 'removeItem';
  condition?: string;
  item: ItemDesc;
  alternates?: ItemDesc[];
  amount: string;
}

Properties

Required Properties

kind - Always 'removeItem'

• Identifies this as an item removal step

item - Primary item to remove

• Uses ItemDesc format for flexible item specification
• Must reference an existing item by name
• This is the preferred item to remove if available

amount - Quantity expression

• String expression that evaluates to the number of items to remove
• Can be literal numbers, mathematical expressions, or flag references
• Evaluated when the step executes

Optional Properties

condition - Conditional execution

• Flag expression that must be true for removal to occur
• Step is skipped if condition fails
• Useful for conditional costs based on player state

alternates - Alternative items

• Array of ItemDesc objects that can be removed instead of the primary item
• System checks primary item first, then alternates in order
• First available item type gets removed
• Useful for flexible payment systems

Examples

Simple Payment

{
  kind: 'removeItem',
  item: { name: 'Spirit Stone' },
  amount: '1'
}

Quest Item Consumption

{
  kind: 'removeItem',
  item: { name: 'Ancient Key Fragment' },
  amount: '3'
}

Variable Costs

{
  kind: 'removeItem',
  item: { name: 'Cultivation Pill' },
  amount: 'realm + 1'  // Higher realms pay more
}

Flexible Payment Options

{
  kind: 'removeItem',
  item: { name: 'Gold Spirit Stone' },
  alternates: [
    { name: 'Silver Spirit Stone' },
    { name: 'Copper Spirit Stone' }
  ],
  amount: '3'
}