🧰 Mirror Server-Authoritative Inventory System

This repository contains a modular and fully server-authoritative inventory system designed for multiplayer games built with Unity + Mirror.

It's lightweight, easy to integrate, and strictly separates client-side visuals from server-side logic for cheat prevention and reliable synchronization.

---

✨ Features

• 🔐 Server-authoritative architecture: All actions (add, move, remove) are handled and validated on the server.
• 📦 Dynamic containers: Add/remove inventory containers on the fly (e.g. pockets, backpacks, chests…).
• 🧱 Grid-based slots: Each container is a 2D grid. No Tetris-style shapes or rotations.
• ♻️ Smart stacking: Automatically stacks items if possible (up to max stack size).
• 🖱️ Drag & drop movement: Intuitive client-side interface with visual ghost slot.
• 🔄 Efficient sync: Only updates changed slots, not the entire inventory.
• 🧪 Debug shortcuts: Quick testing with keyboard inputs to add/remove containers in runtime.
• 🛠️ Custom Editor Tools: Includes an in-Editor tool to give items to players and visualize inventory states in real-time.

---

🔌 Setup Instructions

To get started with the inventory system:

1. Create your item(s):

   • Use the menu: Inventory > Create Item
   • This generates a ScriptableObject (ItemSO) representing your item.

2. Create the item database:

   • Use the menu: Inventory > Create Database
   • This creates the base database ScriptableObject (ItemDatabaseSO).

3. Scan and register items:

   • Select your newly created database asset.
   • In the Inspector, click the Scan All Items button to automatically find and index all ItemSO assets in the project.

4. Item IDs are auto-incremented:

   • Every time a new item is created or scanned, its itemID is automatically incremented and saved via PlayerPrefs.

5. Add the database singleton to your scene:

   • Drag the DatabaseReader prefab into your scene.
   • This ensures item data is available at runtime.

6. Register item prefabs in Mirror:

   • All item prefabs (that can be dropped or spawned in-game) must be added to Mirror’s Network Manager prefab list, otherwise they won’t sync properly across the network.

7. Use the sample scene:

   • You can check out the included example scene to see the system already set up and working.

---

🚧 Current Limitations

• ❌ No persistent save/load (no JSON or database integration yet).
• ❌ No item rotation or shapes (not a Tetris-style system).
• ❌ No container permission system (e.g. for shared storage).
• ❌ No client feedback on failed actions (e.g. no room available).

---

🔧 Made with

• Unity 6000.0.34f1
• Mirror 96.0.1
• A basic item database using ScriptableObjects (ItemSO) for defining item stats

---

📜 License

This project is licensed under the MIT License – free to use in commercial or non-commercial projects.
Attribution is appreciated but not required.