Item Entity

Item Entity

The items_item entity represents in-game items with comprehensive inventory management, equipment functionality, and modifier support.

Key Properties

  • key: Unique item identifier
  • type: Item type reference (equipment, usable, single, combinations)
  • group_id: Item group for categorization
  • label: Display name
  • description: Item description
  • qty_limit: Maximum quantity per inventory slot
  • uses_limit: Maximum number of uses
  • useTimeOut: Cooldown between uses (milliseconds)
  • execTimeOut: Execution timeout (milliseconds)
  • customData: JSON custom properties

Item Types

  • ITEM_BASE (10): Base item class
  • EQUIPMENT (1): Equippable items with modifiers
  • USABLE (2): Consumable items
  • SINGLE (3): Stackable items
  • SINGLE_EQUIPMENT (4): Stackable equipment
  • SINGLE_USABLE (5): Stackable consumables

Related Systems

  • Inventory Management: Add, remove, quantity control with limits
  • Exchange System: Player-to-player trading and NPC shops
  • Modifiers: Stat bonuses and effects via @reldens/modifiers
  • Item Groups: Categorized inventories with separate limits

Database Relations

  • items_types: Item type classification
  • items_group: Item grouping and categorization
  • items_item_modifiers: Stat modifiers applied by item
  • objects_items_inventory: Items in world objects
  • objects_items_requirements: Items required for interactions
  • objects_items_rewards: Items given as rewards

Implementation

Items are configured via the admin panel under the Items section. Each item can have multiple modifiers that apply when equipped or used. The items system supports complex inventory management with group-based limits, trading between players, and NPC shop interactions.

Package

Implemented in @reldens/items package with full documentation at D:\dap\work\reldens\npm-packages\reldens-items\CLAUDE.md

Go Up