# DolgMod — Item Loan & Debt System
**DolgMod** adds a real-time item loan and debt system to Minecraft (**Singleplayer** and **Dedicated Servers**). Players can borrow survival items for a specified amount of real-world time (`30s`, `10m`, `2h`, `1d`) and must repay them before the timer expires—or face execution or a temporary ban.
> **Server-side friendly:** Players connecting to a server do **not** need to install this mod on their client. Everything works out of the box via vanilla BossBars and chat messages.
---
## Key Features
- **Real-Time Persistence:** Loan timers and cooldowns run on real system time and persist across server restarts (`config/dolg_mod.json` & `config/dolg_cooldowns.json`).
- **Live BossBar Countdown:** Displays a progress bar at the top of the screen showing the borrowed item, amount due, and remaining time. Turns red during the final 30 seconds and can be toggled with `/dolg_hud`.
- **Automatic Collection & Punishments:**
- When time runs out, undamaged items are automatically deducted from your inventory.
- If you are online without enough items, you are executed.
- On **Dedicated Servers**, if you are offline when your debt expires, the mod checks your offline player data (`.dat`), deducts the items if present, or issues a **24-hour ban**.
- **Configurable Economy (`config/dolg_settings.json`):**
- Set a custom **interest rate (`%`)** on loans (e.g., borrow 10 diamonds at 20% interest, repay 12).
- Configure loan **cooldowns**, maximum item counts, maximum durations, and message language (`en` or `ru`).
- **Built-in Exploit Protection:**
- Blocks unobtainable/operator blocks, spawn eggs, custom NBT/component patches (`[...]`), damaged tools/armor, and unstackable inventory traps.
---
## Commands
- `/dolg <item> <count> <duration>` — Borrow an item for real time (e.g., `/dolg minecraft:diamond 16 1h`) *(Everyone)*
- `/dolg_pay` — Repay your active debt early *(Everyone)*
- `/dolg_info` — Check your active debt or remaining loan cooldown *(Everyone)*
- `/dolg_hud` — Toggle the BossBar countdown timer (auto-shows in the final 60s) *(Everyone)*
- `/dolg_clear <player>` — Forgive a player's active debt and reset their cooldown *(OP / Cheats)*
- `/dolg_reload` — Reload `config/dolg_settings.json` without restarting *(OP / Cheats)*
---
## Requirements
- **Minecraft:** `26.3`
- **Mod Loader:** Fabric Loader `0.20.0+`
- **Dependencies:** Fabric API (Required)