# 📦 UpgradedTrashCans — MelonLoader Mod for *Schedule I*

This mod adds **two purchasable trash can upgrades** and a new **trash grabber pro** to the Hardware Store in *Schedule I*:

- 🗑️ **Trash Bin** – 40 capacity
- 🗑️ **Trash Compactor** – 100 capacity
- 🤖 **Trash Grabber Pro** – 50 capacity

These upgraded trash cans & grabber appear alongside the default model and function identically, but with improved stats and visual tinting.

---

## 🛒 Default Shop Settings

| Variant           | Price  | Capacity | Pickup Radius  | Unlock Rank  | Tier  |
|-------------------|--------|----------|----------------|--------------|-------|
| Default           | $25    | 20       | 4.0 units      | N/A          | N/A   |
| Trash Bin         | $250   | 40       | 5.0 units      | Hoodlum      | 1     |
| Trash Compactor   | $1000  | 100      | 8.0 units      | Hustler      | 5     |
| Trash Grabber     | $750   | 50       | N/A            | Hustler      | 1     |

- 🏗️ Placed using the normal building grid.
- 💾 Persist across save/load cycles.
- 🖼️ Custom shop icons and model tinting for each variant.
- 🧼 Color tint is visible even when stored on a shelf.
- 🔄 All models reuse base game prefabs with enhanced behavior.

---

## ⚙️ Customization (Optional)

Settings can be changed in-game via the **Mod Manager Phone App**, including:

- 🛠️ **Capacity**
- 🎯 **Cleaner Pickup Radius** (for trash cans)
- 🎨 **Color Tint**
- 🎖️ **Rank & Tier Unlock**
- 💸 **Price**
- 🔓 **Unlock Immediately** (bypass rank restrictions)

**To customize:**
1. Open the Mod Manager Phone App
2. Tap into **Upgraded Trash Can**
3. Adjust any value to your liking  
*Changes apply on next scene load.*

---

## 🔄 **Multiplayer Sync**
  
- The **host’s settings** are automatically synced to all clients
- Sync includes:
  - Capacity
  - Trash Can Radius
  - Color
  - Required rank & tier
  - UnlockImmediately flag
- Clients wait for settings to become available using a safe fallback retry loop
- Version compatibility is checked between host and client before applying settings
- Clients will not inject upgraded items if host mod is disabled or missing

---

## 📁 Installation

1. Install **MelonLoader** for *Schedule I*
2. Drop `UpgradedTrashCans.dll` into the `Mods` folder
3. Launch the game and enjoy smarter waste management

---

## 🐞 Bug Reporting

If you encounter a bug, please help by enabling debug logging:

- Open the **Mod Manager Phone App** and locate UpgradedTrashCan config
- Scroll to the bottom and locate the **Enable Debug Logging** toggle
- Turn it on and reproduce the issue
- Logs will be written to the MelonLoader console/logs folder

You can submit bugs with logs attached via NexusMods.

---

## 🧪 Notes
- Settings are applied automatically on scene load
- If joining a multiplayer session, client settings will be overridden by the host
- The mod uses `LobbyData` for robust cross-player sync

---
© 2024 j0ckinjz. Licensed under Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)