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

Identifiers only; nothing here resolves or validates them

This folder does not:

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