DolgMod

Adds a real-time item loan and debt system with a live BossBar countdown timer, configurable interest rates, and punishments. Supports Singleplayer and Dedicated Servers.

# 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)

DolgMod Team

profile avatar
  • 1
    Projects
  • 32
    Downloads

Creator mods minecraft java.