Mine Credit

# 💰 MineCredit

**Keep track of loans, repayments and installment deals directly inside Minecraft.**

MineCredit is a client-side Fabric mod for players who lend in-game money or sell items through installment payments and want to keep those agreements organized.

Instead of relying on notes, spreadsheets or old chat messages, MineCredit gives you an in-game system for managing loans, installment purchases, payments, due dates, player records and payment evidence.

No server-side installation is required.

---

## ✨ Features

MineCredit includes:

- 💰 Money loans
- 🛒 Installment purchases for items
- 📅 Due dates
- 💸 Partial payments
- 📊 Outstanding balance tracking
- 📈 Multiple interest calculation methods
- 🗓️ Weekly and monthly installment plans
- 👤 Player records
- ⚠️ Overdue and problematic loan tracking
- ✅ Debt forgiveness
- 📎 Evidence attachments
- 📸 Minecraft screenshots as evidence
- 💾 Backups
- 📄 CSV export
- 🕒 Payment and loan history
- 🎮 In-game management interface

---

## 💰 Money Loans

Create and manage loans for other players directly in-game.

A loan can include:

- Player name
- Loan amount
- Interest
- Due date
- Installment schedule
- Installment amount
- Notes and agreements

Existing loans can also be edited later.

---

## 📈 Flexible Interest Options

MineCredit supports several ways of calculating interest.

### Percentage

Enter a percentage that is added to the original loan.

### Fixed Interest

Enter a fixed amount that is added to the loan.

### Total Repayment Amount

Enter the complete amount that should ultimately be repaid.

This allows MineCredit to handle both simple loans and individual player agreements.

---

## 🗓️ Installment Plans

Loans can use:

- No installment plan
- Weekly installments
- Monthly installments

MineCredit can track:

- First installment date
- Installment amount
- Number of installments
- Paid amounts
- Remaining balance
- Overdue installments

A dedicated installment schedule helps you keep track of upcoming payments.

---

## 🛒 Installment Purchases

MineCredit can also manage item sales where the buyer pays over time.

You can store:

- Buyer
- Item name
- Quantity
- Cash price
- Total installment price
- Down payment
- First payment date
- Installment amount
- Notes
- Item handover status

This keeps loans and item sales organized in one place.

---

## 💸 Partial Payments

Payments can be entered individually.

Each payment can include:

- Amount
- Payment date
- Optional note

MineCredit automatically updates the remaining balance.

---

## 👤 Player Records

MineCredit provides player-based records so you can quickly review previous and current agreements connected to a specific player.

---

## ⚠️ Status Tracking

Agreements can be tracked using different states such as:

- Open
- Partially paid
- Overdue
- Installment overdue
- Problematic
- Paid
- Paid late
- Forgiven

Problematic agreements can also be marked manually.

---

## 📎 Evidence Management

Files and screenshots can be attached to a loan as evidence.

MineCredit can:

- Add files manually
- Import Minecraft screenshots
- Store evidence with the corresponding loan
- Display saved evidence
- Open the evidence folder

This can be useful for keeping screenshots of agreements, payments or chat conversations together with the matching loan.

---

## 📊 Dashboard

The MineCredit dashboard provides a quick overview of:

- Total outstanding amount
- Active loans
- Installment purchases
- Overdue agreements
- Upcoming due dates

---

## 💾 Backup & Export

MineCredit includes tools for managing your local data.

You can:

- Create backups
- Export loan data as CSV
- Open the MineCredit data folder

---

## ⌨️ Commands

- /minecredit
- /minecredit due
- /minecredit backup
- /minecredit export
- /minecredit folder
- /minecredit help

---

## 💻 Client-Side Only

MineCredit runs completely on your Minecraft client.

✅ No server-side installation required  
✅ No server permissions required  
✅ Data is stored locally  
✅ Works independently from the server  

MineCredit does not automatically transfer or modify actual in-game money.

It is a management and documentation tool for player agreements.

---

## 📦 Requirements

- Minecraft 1.21.11
- Fabric
- Fabric Loader 0.19.3+
- Fabric API 0.141.3+
- Java 21+

---

## 🔧 Optional

- Mod Menu

MineCredit supports Mod Menu when it is installed.

---

## 📜 License

All Rights Reserved

---

Developed by **ClipCraftStudios**

---

# 🇩🇪 Deutsch

# 💰 MineCredit

**Kredite, Ratenzahlungen und Spielerschulden direkt in Minecraft verwalten.**

MineCredit ist eine clientseitige Fabric-Mod für Spieler, die Ingame-Geld verleihen oder Items auf Raten verkaufen und dabei den Überblick behalten möchten.

Statt Notizzetteln, Tabellen oder alten Chatverläufen bekommst du ein vollständiges Verwaltungssystem direkt im Spiel.

Keine Serverinstallation erforderlich.

---

## ✨ Funktionen

MineCredit bietet:

- 💰 Geldkredite
- 🛒 Ratenkäufe für Items
- 📅 Fälligkeiten
- 💸 Teilzahlungen
- 📊 Offene Restbeträge
- 📈 Verschiedene Zinsarten
- 🗓️ Wöchentliche und monatliche Ratenpläne
- 👤 Spielerakten
- ⚠️ Überfällige und problematische Forderungen
- ✅ Restschuld erlassen
- 📎 Belege
- 📸 Minecraft-Screenshots als Beleg
- 💾 Backups
- 📄 CSV-Export
- 🕒 Zahlungs- und Kredithistorie
- 🎮 Ingame-Verwaltung

---

## 💰 Geldkredite

Du kannst Kredite für andere Spieler direkt im Spiel anlegen.

Gespeichert werden können:

- Spielername
- Ausgeliehener Betrag
- Zinsen
- Fälligkeit
- Ratenplan
- Ratenhöhe
- Notizen
- Abmachungen

Bestehende Kredite können später bearbeitet werden.

---

## 📈 Verschiedene Zinsarten

MineCredit unterstützt mehrere Möglichkeiten.

### Prozent

Ein prozentualer Aufschlag auf den ausgeliehenen Betrag.

### Festbetrag

Ein fester Zinsbetrag wird hinzugefügt.

### Gesamtbetrag

Du legst direkt fest, wie viel insgesamt zurückgezahlt werden soll.

---

## 🗓️ Ratenpläne

Zur Auswahl stehen:

- Keine Ratenzahlung
- Wöchentlich
- Monatlich

MineCredit kann dabei verwalten:

- Erste Rate
- Ratenhöhe
- Anzahl der Raten
- Bereits bezahlte Beträge
- Restschuld
- Überfällige Raten

---

## 🛒 Ratenkäufe

Neben normalen Krediten kannst du auch Item-Verkäufe auf Raten verwalten.

Gespeichert werden können:

- Käufer
- Item
- Anzahl
- Barpreis
- Gesamtpreis
- Anzahlung
- Erste Rate
- Ratenhöhe
- Notiz
- Übergabestatus

---

## 💸 Teilzahlungen

Teilzahlungen können einzeln eingetragen werden.

Jede Zahlung kann enthalten:

- Betrag
- Zahlungsdatum
- Optionale Notiz

Die Restschuld wird automatisch aktualisiert.

---

## 👤 Spielerakten

MineCredit besitzt eine Spielerübersicht.

Dadurch kannst du schneller sehen, welche Kredite oder Ratenkäufe mit einem bestimmten Spieler verbunden sind.

---

## ⚠️ Statusverwaltung

Forderungen können verschiedene Zustände besitzen:

- Offen
- Teilbezahlt
- Überfällig
- Rate überfällig
- Problematisch
- Bezahlt
- Verspätet bezahlt
- Erlassen

Eine Forderung kann zusätzlich manuell als problematisch markiert werden.

---

## 📎 Belege

Zu Krediten können Dateien oder Screenshots gespeichert werden.

MineCredit kann:

- Dateien manuell hinzufügen
- Minecraft-Screenshots übernehmen
- Belege einem Kredit zuordnen
- Gespeicherte Belege anzeigen
- Den Belegordner öffnen

Damit können beispielsweise Screenshots von Abmachungen oder Zahlungen direkt mit dem entsprechenden Kredit gespeichert werden.

---

## 📊 Dashboard

Das Dashboard zeigt unter anderem:

- Gesamte offene Summe
- Aktive Kredite
- Ratenkäufe
- Überfällige Forderungen
- Anstehende Termine

---

## 💾 Backup & Export

MineCredit bietet:

- Backup-Funktion
- CSV-Export
- Direkten Zugriff auf den Datenordner

---

## ⌨️ Befehle

- /minecredit
- /minecredit due
- /minecredit backup
- /minecredit export
- /minecredit folder
- /minecredit help

---

## 💻 Nur clientseitig

MineCredit läuft vollständig auf deinem Minecraft-Client.

✅ Keine Serverinstallation erforderlich  
✅ Keine Serverrechte erforderlich  
✅ Lokale Datenspeicherung  
✅ Funktioniert unabhängig vom Server  

MineCredit überweist oder verändert kein tatsächliches Ingame-Geld.

Die Mod dient ausschließlich zur Verwaltung und Dokumentation von Abmachungen.

---

## 📦 Voraussetzungen

- Minecraft 1.21.11
- Fabric
- Fabric Loader 0.19.3+
- Fabric API 0.141.3+
- Java 21+

---

## 🔧 Optional

- Mod Menu

MineCredit unterstützt Mod Menu, wenn es installiert ist.

---

## 📜 Lizenz

All Rights Reserved

---

Entwickelt von **ClipCraftStudios**