Skip to content

📦 Ids

Defines small identifier value types used across the Inventory system.

These are lightweight wrappers around normalized strings, used to provide consistent identifier semantics across APIs.

🎯 Purpose

Provide canonical identifier types for items and containers, with consistent normalization and equality behaviour.

🧩 What Lives Here

  • ItemGuid → normalized item identifier
  • ContainerId → normalized container identifier
  • InventoryContainerIds → convenience constants for common container IDs

⚠️ Important Notes

  • These types wrap strings with normalization and equality semantics
  • They do not perform lookup or validation
  • They are safe to pass across runtime and editor APIs

🧠 Usage Guidance

ItemGuid

Represents a canonical item identifier.

  • values are normalized on construction
  • empty or whitespace input results in an empty identifier
  • equality compares normalized values

ContainerId

Represents a canonical container identifier.

  • values are normalized on construction
  • empty input defaults to a common container identifier
  • equality compares normalized values

InventoryContainerIds

Provides common container identifiers for convenience.

Custom identifiers are supported.

Why wrappers

Using identifier types helps:

  • centralize normalization
  • avoid repeated string handling
  • improve clarity at API boundaries

🚫 Not for Production Use

This folder does not:

  • Perform item lookup
  • Create or manage containers
  • Validate identifiers against existing data
  • Define equipment slot identifiers
  • Handle persistence