Skip to content

📦 Unity Integration

Core Unity-facing runtime integration for the Inventory system.

This folder contains the scene-level entry points that connect inventory systems to a Unity scene.

🎯 Purpose

Provide the runtime bridge between inventory systems and Unity scene objects.

🧩 What Lives Here

  • SceneInventoryService → scene-scoped runtime service managing containers and mutations
  • InventoryResolve → helper for locating the active service from Unity contexts

⚠️ Important Notes

  • This is the primary Unity-facing integration layer
  • It defines how inventory exists and is accessed within a scene
  • Additional Unity helpers are organised into subfolders

🧠 Usage Guidance

Scene service

SceneInventoryService acts as the central runtime owner for inventory within a scene.

It manages container lifecycle, mutation flow, and change notifications.

Service resolution

InventoryResolve provides a standard way for Unity components to locate the active service.

Resolution may use scene context or fallback search behaviour.

Integration pattern

Typical Unity components:

  • resolve the service
  • access containers through the service
  • react to changes through service events

Subfolder structure

  • Authority → Unity-facing authority components
  • Components → optional helper MonoBehaviours
  • Internal → lifecycle and plumbing helpers

🚫 Not for Production Use

This folder does not:

  • Define item data or authoring models
  • Implement container internals
  • Provide UI presentation
  • Replace service contracts