README.md aktualisiert

This commit is contained in:
2026-04-28 20:13:05 +00:00
parent 9f9d064139
commit f7b274a794

View File

@@ -145,7 +145,7 @@ fly-abo:
|--------|-------------|--------------|
| `/flyabo` | Zeigt Abo-Status, Ablaufdatum und heutiges Tageslimit | `ingameshop.flyabo` |
| `/flyabocancel [confirm]` | Kündigt das Abo zum Ablaufdatum (bleibt bis dahin aktiv) | `ingameshop.flyabocancel` |
| `/flyabogive <Spieler> <Tage> [Label]` | Vergibt ein Fly-Abo manuell (Admin) | `ingameshop.flyabogive` (OP) |
| `/flyabogive <Spieler> <Monatspreis> [Label]` | Vergibt ein Fly-Abo manuell (Admin) | `ingameshop.flyabogive` (OP) |
## Ränge
@@ -176,15 +176,17 @@ fly-abo:
# ✈️ Fly-Abo-System
Das Fly-Abo ermöglicht es Spielern, ein zeitbasiertes Abonnement im Shop zu kaufen, das ihnen täglich eine konfigurierbare Menge an Fly-Zeit gewährt.
Das Fly-Abo ermöglicht es Spielern, ein monatlich abgebuchtes Abonnement im Shop zu kaufen, das ihnen täglich eine konfigurierbare Menge an Fly-Zeit gewährt.
## Funktionsweise
- Spieler kaufen das Abo im Shop (WordPress-Frontend)
- Das Abo wird automatisch beim Login aktiviert
- Spieler kaufen das Abo einmalig im Shop der **Artikelpreis** ist gleichzeitig der monatliche Beitrag
- Das Abo ist sofort aktiv und gilt bis zum letzten Tag des laufenden Monats
- Täglich stehen bis zu `max-daily-hours` Stunden Fly zur Verfügung (Standard: 6h)
- Der Tagesverbrauch wird um Mitternacht zurückgesetzt
- Mehrfachkauf verlängert das bestehende Abo kumulativ (z.B. 2x 30 Tage = 60 Tage)
- Der Tagesverbrauch wird täglich zurückgesetzt
- Am **1. jedes Monats** wird der Monatsbeitrag automatisch per Vault abgebucht und das Abo verlängert
- Kann der Spieler nicht zahlen, wird das Abo **automatisch zum Monatsende gekündigt**
- Kündigung jederzeit ingame möglich das Abo läuft bis **Ende des laufenden Monats** weiter
- Verwaltung und Kündigung erfolgen ausschließlich ingame
## BossBar
@@ -201,10 +203,20 @@ Warnungen bei: 1h, 30min, 10min, 5min, 1min, 30s, 10s verbleibend.
1. **Ingame Shop → Items → Neu**
2. Typ: **„✈ Fly-Abo (tägl. Limit)"** auswählen
3. Laufzeit in Tagen eintragen (z.B. `30`)
4. Preis setzen, Name vergeben → Speichern
3. **Preis setzen** dieser Betrag wird monatlich per Vault abgebucht
4. Name vergeben → Speichern
Die Item-ID wird automatisch als `fly_abo_30` gespeichert.
Die Item-ID wird automatisch als `fly_abo` gespeichert.
> **Hinweis:** Es gibt nur einen Fly-Abo-Artikel. Der Preis im Shop = monatlicher Beitrag.
## Billing-Übersicht
| Zeitpunkt | Was passiert |
|-----------|-------------|
| Kauf im Shop | Vault-Abzug, Abo sofort aktiv bis Monatsende |
| 1. des Monats | Automatische Vault-Abbuchung, Abo verlängert sich |
| Zahlung fehlgeschlagen | Abo läuft bis Monatsende, danach automatisch beendet |
| `/flyabocancel confirm` | Kündigung vorgemerkt, Abo läuft bis Monatsende weiter |
## Datenbanktabellen
@@ -595,8 +607,11 @@ Antwort:
|------|-------------|
| player_name | Minecraft Name |
| label | Anzeigename des Pakets |
| monthly_price | Monatlicher Beitrag (Vault) |
| cancelled | 0 / 1 Kündigung vorgemerkt? |
| expires_at | Ablaufdatum |
| cancellation_reason | `user` oder `payment_failed` |
| next_billing_date | Datum der nächsten Abbuchung (immer 1. des Monats) |
| period_end | Letzter Tag der aktuellen Abo-Periode (Monatsende) |
| granted_at | Aktivierungszeitpunkt |
---