C# API Reference

Assembly: SortAndShelveToolkit.Runtime.dll

ItemInstance Class

Namespace: SortAndShelveToolkit.Runtime.Items
Attached to physical sortable props.

Public Properties

public ItemDefinition Definition { get; }
public bool IsHeld { get; }
public bool IsPlaced { get; }
public Rigidbody Rigidbody { get; }
public Collider Collider { get; }

Public Methods

public void OnPickedUp(Transform holdParent);
public void OnDropped(Vector3 throwForce);
public void SetPlacedOnShelf(ShelfSlot slot);
public void SetReleasedFromShelf();
public void HighlightItem(Color highlightColor, float duration = 1.0f);

ShelfSlot Class

Namespace: SortAndShelveToolkit.Runtime.Shelving
Attached to individual resting slots on shelves.

Public Properties

public ShelfZone ShelfZone { get; }
public ItemInstance CurrentItem { get; }
public bool IsOccupied { get; }

Public Methods

public bool CanAcceptItem(ItemInstance item);
public bool PlaceItem(ItemInstance item);
public ItemInstance RemoveItem();
public void SetShelfZone(ShelfZone zone);

ShelfZone Class

Namespace: SortAndShelveToolkit.Runtime.Shelving
Categorized drop receptacle managing a group of slots.

Public Properties

public CategoryDefinition TargetCategory { get; }
public string DisplayName { get; }
public int TotalCapacity { get; }
public int OccupiedCount { get; }
public bool IsFull { get; }

PhysicsSleeper Class

Namespace: SortAndShelveToolkit.Runtime.Core.Utilities
Kinematic sleep manager attached to physical items.

Public Properties

public bool IsSleepingKinematic { get; }

Public Methods

public void WakeUp(bool wakeNeighbors = true);
public void ForceSleep();

CompletionTracker Class

Namespace: SortAndShelveToolkit.Runtime.Progression
Single source of truth tracking level progress, time, and stars.

Public Properties

public int TotalItemsToPlace { get; }
public int ItemsPlaced { get; }
public int ItemsRemaining { get; }
public float CompletionPercentage { get; }
public float ElapsedTime { get; }
public bool IsLevelComplete { get; }

CurrencyManager Class

Namespace: SortAndShelveToolkit.Runtime.Progression
Progression wallet managing player coins.

Public Properties

public int CurrentBalance { get; }

Public Methods

public void AddCurrency(int amount, Vector3 worldPosition);
public bool CanAfford(int cost);
public bool TrySpendCurrency(int cost);

UpgradeManager Class

Namespace: SortAndShelveToolkit.Runtime.Progression
Manages purchases for Carry Capacity, Walk Speed, Interact Reach, and Item Highlighting.

Public Methods

public int GetUpgradeLevel(UpgradeType type);
public float GetCurrentValue(UpgradeType type);
public bool TryPurchaseUpgrade(UpgradeType type);

SaveManager Class

Namespace: SortAndShelveToolkit.Runtime.SaveSystem
Atomic persistence manager.

Public Methods

public void SaveGame();
public bool LoadGame();
public void RecordLevelCompletion(string levelId, int stars, float completionTime);
public int GetLevelStars(string levelId);