HBCTaler Bonussystem

HBCTaler Mod Beschreibung
=========================

Was ist HBCTaler?
-----------------
HBCTaler ist ein Bonus-System fuer den Eco-Server. Der Mod belohnt Spieler automatisch mit Talern, wenn sie dafuer berechtigt sind.

Berechtigt sind Spieler, die entweder den Status "Langezeit" mit der ID 2006 haben oder manuell von einem Admin freigeschaltet wurden.

Wie funktioniert die Auszahlung?
--------------------------------
Der Mod prueft automatisch in einem festen Intervall, ob berechtigte Spieler eine Auszahlung erhalten duerfen.

Aktuelle Einstellung:
- Pruefung: alle 30 Minuten
- Auszahlung: alle 5 Realtage
- Waehrung: Taler

Die Zeit wird als echte Zeit gezaehlt. Server-Neustarts oder Server-Auszeiten setzen den Timer nicht zurueck.

Beispiel:
Ein Spieler erhaelt am Montag um 18:00 Uhr eine Auszahlung.
Die naechste Auszahlung ist fruehestens am Samstag um 18:00 Uhr moeglich.

Wann bekommt man keine Auszahlung?
----------------------------------
Keine Auszahlung gibt es, wenn:
- der Spieler nicht den Status "Langezeit" hat
- der Spieler nicht manuell freigeschaltet ist
- die letzte Auszahlung noch keine 5 Realtage her ist
- die Waehrung oder Config fehlerhaft eingestellt ist

Discord-Benachrichtigung
------------------------
Bei erfolgreicher Auszahlung kann automatisch eine Nachricht in Discord erscheinen.

Beispiel:
Langzeit-Bonus ausgezahlt: Spielername hat X Taler erhalten. Status: Langezeit (2006).

Spieler-Befehle
---------------
/dxltaler checkme
Prueft, ob du aktuell fuer den HBCTaler-Bonus berechtigt bist.

/dxltaler runnow
Startet sofort eine Pruefung. Wenn du berechtigt bist und dein Bonus faellig ist, bekommst du die Auszahlung. Das Zeitlimit wird dadurch nicht umgangen.

/dxltaler next
Zeigt dir, wann deine naechste HBCTaler-Auszahlung faellig ist.

Admin-Befehle
-------------
/dxltaler info
Zeigt die aktuellen Einstellungen des Mods.

/dxltaler setamount 500
Setzt den Auszahlungsbetrag, z. B. auf 500 Taler.

/dxltaler addme
Schaltet dich selbst manuell frei.

/dxltaler removeme
Entfernt deine eigene manuelle Freischaltung.

/dxltaler adduser Spielername
Schaltet einen Spieler manuell frei.

/dxltaler removeuser Spielername
Entfernt einen Spieler aus der manuellen Freischaltung.

/dxltaler listusers
Zeigt alle manuell freigeschalteten Spieler.

/dxltaler testdiscord
Sendet eine Testnachricht an Discord.

/dxltaler configpath
Zeigt, welche Config-Datei der Mod verwendet.

Config-Pfad
-----------
Die Config liegt unter:
Configs/Mods/HBCTaler/HBCTaler.eco

Wichtige Einstellungen:
{
"CurrencyName": "Taler",
"PaymentAmount": 1,
"RequiredStatusId": 2006,
"RequiredStatusName": "Langezeit",
"IntervalRealDays": 5,
"CheckEveryMinutes": 30,
"NotifyDiscord": true
}

Manuelle Freischaltung
----------------------
Manuell freigeschaltete Spieler werden in der Config gespeichert:

{
"ManualEligibleUsers": {
"SteamId:...": "Spielername"
}
}

Diese Spieler erhalten den Bonus auch dann, wenn der Eco-Status nicht automatisch erkannt wird.

Ziel des Mods
-------------
HBCTaler soll aktive Langzeitspieler automatisch belohnen, Auszahlungen nachvollziehbar machen und Admins Arbeit abnehmen. Durch Discord-Logs bleibt transparent, wann ein Bonus ausgezahlt wurde.

Erstellt von
------------
Code erstellt von daryldixon4074
by HillBilly-Crew
Discord: https://mee6.xyz/de/i/lYl6pLgxWa
Support nur über Discord Ticket System!!!