ShopBridgePlugin — Installationsanleitung
==========================================

Dieses AsaApi-Plugin liefert Discord-Shop-Käufe (Items + Dinos als Vanilla-
Kryopod) direkt ins Inventar des Spielers auf deinem Ark: Survival Ascended
Server. Es gehört zum Vikingard-Währungssystem-Bot.

Voraussetzung: AsaApi muss auf deinem Server bereits installiert und aktiv
sein (https://github.com/ArkServerApi/AsaApiLoader).

Installation:
1. Server stoppen.
2. Den Ordner "ShopBridgePlugin" (aus diesem ZIP) nach
   ShooterGame\Binaries\Win64\ArkApi\Plugins\ kopieren.
3. Server starten. In der Konsole sollte "ShopBridgePlugin" beim Laden der
   Plugins erscheinen.
4. Im Discord-Bot mit /vs-rcon hinzufuegen deinen Server eintragen und im
   Shop bei einem Eintrag den Blueprint-Pfad hinterlegen
   (/vs-shop eintrag hinzufuegen / blueprint) - dann liefert der Bot
   automatisch, sobald der Server-Discord ⭐ Premium hat.

Wichtig: Dieses Plugin greift auf interne, nicht-öffentliche Engine-Funktionen
zu, die sich mit jedem größeren Ark-Update ändern können. Bei Problemen nach
einem Server-Update meld dich einfach auf unserem Discord.

Änderungen in Version 1.4:
- Fix: Dino-Kauf konnte Spieler beim Ausballen kicken oder den Dino bei
  einer Server-Reise komplett verlieren (shopbridge.give_dino). Ursache war,
  dass der frisch gespawnte Dino im selben Moment eingefangen wurde, in dem
  er gespawnt ist - Ark hatte dadurch keine Zeit, seine Stats/Ability-System
  fertig zu initialisieren, was einen unvollständigen Kryopod-Inhalt erzeugte.
  Betroffen war jeder Dino-Kauf, bei dem der Spieler den Dino nicht VOR dem
  ersten Ausballen manuell einmal aus- und wieder eingeballt hat. Ab 1.4
  wartet das Plugin 1 Sekunde, bevor es den Dino einfängt - in dieser Zeit
  läuft der Server ganz normal weiter und der Dino wird vollständig
  initialisiert. Wer bereits eine ältere Version installiert hat und Dinos
  verkauft, sollte unbedingt auf 1.4 aktualisieren (Datei einfach
  überschreiben, Server neu starten bzw. bei aktivem Hot-Reload reicht das
  Ersetzen der .dll).
- Neu: Pärchen-Verkauf für Dinos. Im Shop kann ein Dino-Eintrag jetzt als
  "Pärchen" markiert werden (/vs-shop eintrag hinzufuegen/bearbeiten
  paerchen:Ja) - bei Sofort-Lieferung liefert der Shop dann garantiert ein
  Männchen UND ein Weibchen statt eines zufälligen Geschlechts. Praktisch
  zum Verkauf von Zucht-Paaren. Ohne Sofort-Lieferung (Free-Tier oder kein
  Blueprint hinterlegt) zeigt der manuelle Liefer-Kanal fürs Team einfach
  einen Hinweis an, zwei Dinos mit unterschiedlichem Geschlecht zu
  übergeben.
- Hinweis für Server-Betreiber mit eigenen Anpassungen: Falls dein Server
  nach diesem Update beim allerersten Dino-Kauf abstürzen sollte, prüfe die
  Datei ShopBridgePlugin_debug.log im Server-Verzeichnis und melde dich mit
  dem Log-Auszug bei uns im Discord - dann schauen wir uns das gemeinsam an.

Änderungen in Version 1.3:
- Fix für falsche Qualitätsstufe beim Sofort-Kauf (shopbridge.give_item):
  Ab 1.2 wurde kein Zufallsbereich mehr für die Qualität an Ark übergeben,
  trotzdem konnte die im Inventar angezeigte Stufe (z.B. "Meisterhaft")
  gelegentlich abweichen (z.B. "Geselle" oder "Überragend") - Ursache ist
  eine von Ark selbst intern durchgeführte Zufallskomponente bei der
  Stufen-Ermittlung, die sich nicht über die Eingabeparameter abschalten
  lässt. Ab 1.3 wird die angezeigte Qualitätsstufe direkt nach der Erzeugung
  hart auf den im Shop hinterlegten Wert gesetzt, unabhängig von Arks
  interner Würfelei. Wer Items mit fester Qualität verkauft, sollte auf 1.3
  aktualisieren (Datei einfach überschreiben, Server neu starten bzw. bei
  aktivem Hot-Reload reicht das Ersetzen der .dll).

Änderungen in Version 1.2:
- Fix für ungenaue Item-Qualität beim Sofort-Kauf (shopbridge.give_item):
  Ark hat die tatsächliche Qualität bisher zufällig zwischen 0 und dem im
  Shop hinterlegten Wert gewürfelt, weshalb z.B. ein konfiguriertes "3" im
  Inventar gelegentlich als niedrigere Stufe ankam. Ab 1.2 wird kein
  Zufallsbereich mehr verwendet - die Qualität entspricht direkt dem im
  Shop-Eintrag hinterlegten Wert. Wer bereits 1.0/1.1 installiert hat und
  Items mit fester Qualität verkauft, sollte auf 1.2 aktualisieren (Datei
  einfach überschreiben, Server neu starten).

Änderungen in Version 1.1:
- Fix für einen Server-Absturz beim Kauf von Dinos (shopbridge.give_dino),
  der nach einem Ark-Update auftreten konnte. Wer bereits 1.0 installiert
  hat und Dinos verkauft, sollte auf 1.1 aktualisieren (Datei einfach
  überschreiben, Server neu starten).
