Marketplace_Asgavin.md - BeardyLP/Valheim GitHub Wiki


📦 Marketplace_Asgavin

Autor: Asgavin
Kategorie: Wirtschaft / Marktplatz / Multiplayer-Handel

📝 Beschreibung

Marketplace_Asgavin bringt ein vollständiges, interaktives Marktplatzsystem nach Valheim. Spieler können dort Items kaufen, verkaufen und in Gold umtauschen. Händlerstände sind platzierbar und über ein visuelles UI bedienbar. Perfekt für RPG-Server, Wirtschaftssysteme oder Community-Zentren.

🎮 Tastenkombinationen

Taste / Aktion Funktion
E Mit Händlerstand interagieren
Maus / UI Angebot wählen, Verkauf bestätigen

⚙️ Konfiguration (BepInEx/config/Marketplace.cfg)

Einstellung Beschreibung
EnableBuyAndSell Aktiviert Verkauf und Einkauf
EnableGoldSystem Aktiviert serverweite Goldwährung
GlobalSellPriceMultiplier Beeinflusst Verkaufserlöse (Standard: 1.0 = 100%)
SellableItemsList Definiert explizit, welche Items verkauft werden dürfen
UseContainerStock Händler zieht Items aus verknüpfter Truhe als Lagerbestand
UseTaxPercentage Steuer pro Transaktion (z. B. 0.1 = 10%)

🔐 Rechte

  • Member: Alle dürfen kaufen/verkaufen
  • 🛠️ Admin: Kann Preise, Steuern, Lagerbestand & Regeln zentral verwalten
  • 🧱 Händler-Objekte müssen von Admins platziert werden

➕ Vorteile

  • Funktionierender Ingame-Marktplatz
  • Flexibel anpassbares Ökonomiesystem
  • Unterstützung für Roleplay & Eventmärkte

➖ Nachteile

  • Kein Schutz vor Item-Duplikation ohne ServerSync + AntiCheat
  • Lagertruhenmanipulation erfordert Aufmerksamkeit
  • Hohe Serverlast bei vielen Shops (ab 30+)

💡 Beispiele

1. Händlerstand platzieren (Admin):

  • Admin wählt Händlerobjekt im Bauen-Menü (via PlanBuild oder PieceManager)
  • Truhe in der Nähe → wird automatisch verlinkt als Lager

2. Item verkaufen:

  • Spieler interagiert mit Händler
  • UI öffnet sich → Item auswählen → „Verkaufen“
  • Spieler erhält Gold laut Preisliste × Multiplikator

3. Gold-Währung aktivieren:

EnableGoldSystem = true

→ Gold wird zur zentralen Währung (unterstützt CoinItem aus EpicLoot)

🧮 Beispielstruktur in Config

{ "SellableItems": [ { "item": "Iron", "price": 20 }, { "item": "Wood", "price": 1 }, { "item": "Ruby", "price": 50 } ] }

🌐 Link Marketplace_Asgavin auf Thunderstore

📊 Kompatibilität

Client erforderlich ✅ Ja Server erforderlich ✅ Ja