TraderQuest.md - BeardyLP/Valheim GitHub Wiki

📦 TraderQuest

Autor: RustyMods
Kategorie: Handel / Questsystem

📝 Beschreibung

Fügt einen einfachen Quest-Mechanismus beim Händler hinzu. Spieler erhalten Aufgaben (z. B. „Bringe X Item“) und erhalten Gold oder Items als Belohnung. Ideal für RP oder Progression.

🎮 Tastenkombinationen

Funktion Beschreibung
✖ Interaktion erfolgt über den Händler

🛠️ Neue Werkzeuge

  • Questsystem beim Händler
  • Belohnungstabelle konfigurierbar
  • Progression über Item-Abgabe

🚀 Nutzung

  1. Mod installieren (Server & Client)
  2. Händler aufsuchen → Quest-Menü erscheint
  3. Aufgaben erledigen → Belohnung kassieren

🌐 Link

TraderQuest auf Thunderstore

📊 Kompatibilität

Client erforderlich Server erforderlich
✅ Ja ✅ Ja

Konfigurations-Übersicht für Bounties, Schatzsuchen, Shops, Händler und Glücksspiel (YAML-basiert)

🎯 Bounty-System

Bounties definieren Aufgaben, bei denen Spieler Kreaturen jagen müssen.

Allgemeine Felder:

  • UniqueID: Eindeutiger Bezeichner
  • Name: Anzeigename
  • Weight: Wahrscheinlichkeit, angezeigt zu werden
  • CurrencyItem: Währung für Transaktionen
  • IconPrefab: Symbol
  • Price: Kosten zur Annahme
  • Biome: Biom der Aufgabe
  • RequiredKey: Schlüsselbedingung
  • Cooldown: Wartezeit zur Wiederholung

Kreaturen (Creatures):

  • UniqueID: Eindeutig
  • PrefabName: Name im Spiel
  • OverrideName: Anzeigename
  • Level: Schwierigkeitsgrad
  • IsBoss: Ist Boss? (true/false)

Belohnungen (Rewards):

  • PrefabName: Itemname
  • Amount: Menge
  • Quality: Qualitätsstufe

Erfahrung (Experience):

  • EpicMMOExp: Punkte für EpicMMO
  • AlmanacExp: Punkte für Almanac

🗺️ Schatzsuchen (Treasure Hunts)

Versteckte Belohnungen in bestimmten Biomen.

Allgemeine Felder:

  • UniqueID, Name, Weight, RequiredKey, Biome, IconPrefab, CurrencyPrefab, Price, Cooldown

Belohnungen:

  • Gleiche Struktur wie bei Bounties

🛒 Shop-System

Verkauf von Items mit Preis, Qualität und Bedingungen.

Felder:

  • PrefabName, Stack, Quality, CurrencyPrefab, Price, OnSalePrice, RequiredKey, Weight, CanBeOnSale

🧙 Händler-Shop (Trader)

Definiert, was Händler wie Haldor verkaufen.
Dateiname muss dem Händler-Prefab entsprechen, z. B. Haldor.yml.

Felder:

  • PrefabName, Stack, Price, RequiredKey

🎰 Glücksspiel (Gamble)

Slot-Machine-artiges System.

Felder:

  • PrefabName, Amount, Quality, RequiredKey, CurrencyPrefab, Price, SuccessChance

📁 YAML-Dateien erstellen

  1. Beispiel kopieren
  2. Felder individuell anpassen
  3. Mit .yml speichern
  4. In den richtigen Spielordner legen

🧠 Tipps

  • UniqueID / PrefabName muss eindeutig sein
  • Faire Balance zwischen Preis und Belohnung wählen
  • Ingame testen!
  • Für Gamble: SuccessChance = Gewinnwahrscheinlichkeit (z. B. 75.0 = 75 %)

🛠️ Versionierung

  • 1.0.0 – Initiale Version
  • 1.0.1 – Globale vs. Spieler-Schlüssel
  • 1.0.2 – Bounty/Treasure Sichtbarkeit + Cooldown-Zeitstempel
  • 1.0.3–1.0.7 – Fixes, Override-Folder, Ladefehler-Handling