🐾 AetherShiba – FFXIV Discord Bot

Ein modularer Discord-Bot für Final Fantasy XIV: Housing-Scanner, Marktbrett-Alarme, Event-Planung, Hunts, Community-Features und mehr.

---

⚡ Schnellzugriff:

• 🧭 Kurze Beschreibung – Worum es geht & Architektur auf einen Blick.
• 🚀 Schnellstart – Repo klonen & Bot starten (Beispiel Node/Python).
• 🔌 APIs – Welche Schnittstellen verwendet werden.
• 🧩 Aufgaben des Bots – Implementiert & W.I.P-Funktionsliste.
• 🛠️ Erklärung: Was? Wie? Wo? – Aufbau, Betrieb & Deployment.
• 🔐 Datenschutz & Sicherheit – Schonende Datennutzung & ToS.
• 📜 Lizenz – Alle Rechte vorbehalten.
• ❓ FAQ – Häufige Fragen kompakt.
• 📬 Kontakt & Support – Issues, Diskussionen, Hilfe.

---

🧭 Kurze Beschreibung

AetherShiba bringt FFXIV-Daten elegant in deinen Discord-Server: freie Häuser, Marktpreise, Hunts, Resets, Events und Community-Interaktionen. Die Architektur ist modular aufgebaut – jedes Feature als eigenes Modul mit klaren Zuständigkeiten.

---

🚀 Schnellstart

1. Voraussetzungen: Discord-Server, Bot-Token, Node.js oder Python, ggf. API-Keys (siehe APIs).
2. Installieren:

# Klone das Repo
git clone <DEIN-REPO-URL>
cd <repo>

# Abhängigkeiten (Beispiel Node)
npm install

3. Starten:

# Node (Beispiel)
npm run start

🔌 Welche APIs werden genutzt?

• 🤖 Discord API – Gateway, REST, Interactions/Slash Commands, OAuth2 für Account-Linking.
• 📊 Universalis – Marktbrett-Preise & Historie.
• 🧱 XIVAPI – Spiel-Daten (Items, Jobs, Icons; ggf. Lodestone-Proxy).
• 🪪 Lodestone – Charakter-/Free-Company-Daten (über offizielle Seiten/Community-Lösungen).
• 📡 Hunt-Daten – Community-Quellen, soweit verfügbar/zugelassen.
• ⏰ Kalender/Benachrichtigung – z. B. Scheduler, Cron, Webhooks.

---

🧩 Aufgaben des Bots (Feature-Liste)

• 🏠 Listing von freien Häusern auf allen Datenzentren (Implementiert)
• 📆 Daily- & Weekly-Reset Benachrichtigungen, Event-Planung (W.I.P)
• 🔔 Marktbrett-Preisalarm (Auto-Alerts bei Zielpreis/Preisschwankung) (W.I.P)
• 💹 Marktbrett-Deals (30 günstige Kauf/teurer Verkauf-Kandidaten zwischen Welten) (W.I.P)
• 🐉 Hunt-Notifikationen (S-/A-Rank Spawns, Integration zu Hunt-Linkshell-Daten, falls möglich) (W.I.P)
• 🎰 Gold Saucer Events (MGP-Events, Fashion-Report-Reminder mit Guide-Links) (W.I.P)
• 🔗 Accounts-Linking mit Discord (Rollen via Reactions, Mehrfach-Char-Linking via Lodestone/Codes) (W.I.P)
• 👗 Fashion Report Guessing (Community-Voting/Predictions) (W.I.P)
• 🗓️ Events-Planung (Raids, Schatzkarten; Guide-Links, Bilder) (W.I.P)
• 🃏 Triple Triad Minigame im Discord-Channel (W.I.P)
• 🪞 Fashion Report Simulator (Outfits posten, Community stimmt ab, Punktevergabe) (W.I.P)
• 🧠 Marktbrett-Quiz (Item + Region → Preis raten) (W.I.P)
• 📰 Official-Info/News/Störungen als Embed-Posts (W.I.P)

---

🛠️ Erklärung: Was? Wie? Wo?

❓ Was

Ein Bot, der FFXIV-Informationen in Discord nutzbar macht: Marktpreise, Housing, Hunts, Events, Social-Tools.

⚙️ Wie

• Module/Kommandos je Feature (Trennung Datenquellen ↔ Logik).
• Benachrichtigungen via Discord-Embeds und optional Webhooks.
• Scheduler für Resets/Events (Cron/Jobs).
• Caching, Rate-Limits & Backoff zum Schutz der Quellen.

📍 Wo

• Lokal/Server/VPS möglich.
• Docker empfohlen: ein Service für den Bot, optional Cache/DB (z. B. Redis/PostgreSQL).
• Speichere nur, was die Features wirklich benötigen.

---

🔐 Datenschutz & Sicherheit

• Minimalprinzip: nur notwendige Daten (z. B. User-IDs für Alarme/Linking).
• Keine sensiblen Chat-Inhalte ohne Zustimmung speichern.
• API-Schlüssel gehören in eine .env (nie ins Repo).
• Beachte ToS/Nutzungsbedingungen (Universalis, XIVAPI, Discord, …).
• Opt-in/Opt-out für Benachrichtigungen anbieten.

---

📜 Lizenz

Alle Rechte vorbehalten. Der gesamte Quellcode, die Dokumentation und alle zugehörigen Assets von AetherShiba unterliegen dem ausschließlichen Recht von yourShika. Jede Nutzung, Vervielfältigung, Veränderung, Verbreitung oder Veröffentlichung – ganz oder teilweise – ist ohne vorherige, ausdrückliche, schriftliche Zustimmung untersagt.

Ausnahmen (z. B. für private Tests oder Beiträge) können individuell und widerruflich gestattet werden. Mit dem Einreichen eines Pull Requests räumst du uns das zeitlich und räumlich unbeschränkte, nicht-exklusive Recht ein, den Beitrag in diesem Projekt zu nutzen, zu ändern und zu verbreiten.

❓ FAQ

🌐 Welche Datenzentren werden unterstützt?

Alle öffentlichen Datenzentren, sofern die genutzten APIs diese abdecken. Standard-DC kann projektspezifisch gesetzt werden.

🏰 Kann ich mehrere Discord-Server/Guilds nutzen?

Ja – der Bot kann für mehrere Guilds bereitgestellt werden.

🎭 Wie richte ich Rollen-Automatik ein?

Account-Linking aktivieren, Reactions konfigurieren und Mapping (z. B. Tank/Healer/DPS) definieren.

---

📬 Kontakt & Support

• Issues: Fehler/Feature-Wünsche im GitHub-Issue-Tracker melden (mit Logs/Schritten).
• Fragen: GitHub-Discussions oder deinen Discord-Support-Channel verwenden.
• Screenshots/Beispiele: Bilder/Links in Issues/PRs anfügen (ohne sensible Inhalte).