From f7b274a79436569922bfeb4f757c3a8abacfbbaa Mon Sep 17 00:00:00 2001 From: M_Viper Date: Tue, 28 Apr 2026 20:13:05 +0000 Subject: [PATCH] README.md aktualisiert --- README.md | 35 +++++++++++++++++++++++++---------- 1 file changed, 25 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index b339d5f..13df4f5 100644 --- a/README.md +++ b/README.md @@ -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 [Label]` | Vergibt ein Fly-Abo manuell (Admin) | `ingameshop.flyabogive` (OP) | +| `/flyabogive [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 | ---