Installation & Setup

Requirements

Before importing Tidy Up! — Sorting & Shelving Simulator Toolkit, verify that your project meets the following requirements:

• Unity Editor: Unity 6 (6000.0+) or Unity 2022.3 LTS+.
• Render Pipeline: Universal Render Pipeline (URP).
• Input Package: Unity New Input System (com.unity.inputsystem).
• Text Package: TextMeshPro / uGUI.
• Target Platforms: PC (Windows / Mac / Linux), Steam Deck, Consoles, Mobile, WebGL.

Method 1: Unity Asset Store (Recommended)

1. Acquire the toolkit from the Unity Asset Store.
2. Open your Unity project.
3. Navigate to Window → Package Manager.
4. In the Package Manager top-left dropdown, select Packages: My Assets.
5. Search for Tidy Up! — Sorting & Shelving Simulator Toolkit.
6. Click Download, then click Import.
7. Keep all files checked and click Import.

Method 2: Custom Package File (.unitypackage)

1. In Unity, go to Assets → Import Package → Custom Package...
2. Select your exported .unitypackage file.
3. Click Import.

Package Directory Layout

All assets reside in an organized directory structure:

Assets/SortAndShelveToolkit/
├── Art/
│   ├── Materials/          # Stylized URP surface materials
│   ├── Models/             # 3D meshes for props, shelving, furniture
│   ├── Textures/           # Diffuse and normal maps
│   └── UI/                 # 9-slice sprites, icons, and frames
├── Audio/                  # SFX clips (pickup, snap, coin, victory)
├── Documentation/          # README and QuickStart guides
├── Editor/
│   ├── Utilities/          # Audio synthesizer and scene builders
│   └── Windows/            # Dashboard, Wizard, Auditor, Importer, Theme Switcher
├── Prefabs/
│   ├── Items/              # Physical item prefabs with colliders and rigidbodies
│   └── UI/                 # HUD, Shop, Level Select, and Modal prefabs
├── Runtime/
│   ├── Audio/              # AudioManager and SoundTrigger
│   ├── Core/               # Singleton, Pooling, and Event types
│   ├── Data/               # ScriptableObject definitions (Item, Category, Upgrade)
│   ├── Environment/        # Ambient lights and decorative props
│   ├── Items/              # ItemInstance, DeliveryBox, PileGenerator
│   ├── Player/             # FirstPersonController, CarrySystem, InteractionController
│   ├── Progression/        # CompletionTracker, CurrencyManager, UpgradeManager
│   ├── SaveSystem/         # SaveManager and SaveData models
│   ├── Shelving/           # ShelfZone, ShelfSlot, ProceduralShelf
│   └── UI/                 # HUDView, ShopMenuView, SettingsMenuView, MainMenuController
├── Scenes/                 # MainMenuScene, ApothecaryDemoScene, WorkshopDemoScene
└── ScriptableObjects/      # Categories, Items, and Upgrades

Assembly Definitions

The package utilizes two isolated assembly definitions:

• SortAndShelveToolkit.Runtime.asmdef: Contains all gameplay, player, physics, shelving, UI, and progression scripts.
• SortAndShelveToolkit.Editor.asmdef: Contains all editor windows, auditors, setup wizards, and scene builders.

This guarantees modularity and prevents namespace conflicts with your game code.

The Editor Suite

Access all tools from the Unity menu under:

Tools > Nipun Interactive > Tidy Up! - Sorting & Shelving Simulator Toolkit

• ★ Toolkit Dashboard & Hub: Unified command center with quick start tabs, demo scene openers, and documentation links.
• Scene Setup Wizard: 1-click level bootstrap configuring the 5-header hierarchy, player prefab, managers, and HUD.
• Level Health & Auditor: Diagnostic window checking category quotas, shelf capacities, physics colliders, and offering 1-click auto-fixes.
• Bulk Item Importer: Spreadsheets-to-ScriptableObjects generator for rapid item authoring.
• Theme Preset Switcher: 1-click visual reskinning tool.