Marketplace — targowisko dla serwera Valheim

Tablica ogłoszeń handlowych dla wszystkich graczy na serwerze. Każdy może wystawić dowolny przedmiot z ekwipunku w swojej cenie, a pozostali mogą go kupić — także wtedy, gdy sprzedający jest offline. Walutą są zwykłe monety z Valheima.

Jak używać

Naciśnij F7 (klawisz zmienisz w konfiguracji), żeby otworzyć okno targowiska. Esc albo ponowne F7 zamyka okno.

Zakładka	Co robi
KUPUJ	Wszystkie oferty na serwerze. Wyszukiwarka (nazwa przedmiotu lub sprzedawcy) i sortowanie. Wybierz ofertę, ustaw ilość (- / + / Max) i kliknij Kup.
SPRZEDAJ	Przedmioty z Twojego ekwipunku. Wybierz przedmiot, ustaw ilość i cenę za sztukę, kliknij Wystaw na sprzedaż. Przedmiot znika z ekwipunku i czeka na kupca.
MOJE OFERTY	Twoje aktywne oferty. Możesz każdą wycofać — przedmiot wraca do Ciebie.
SKRZYNKA	Monety ze sprzedaży oraz przedmioty z wycofanych i wygasłych ofert. Odbierz wszystko przenosi je do ekwipunku.

• Kupione przedmioty trafiają od razu do ekwipunku.
• Monety ze sprzedaży czekają w skrzynce, dopóki ich nie odbierzesz. Jeśli jesteś online, dostaniesz powiadomienie o sprzedaży.
• Gdy w ekwipunku brakuje miejsca, nadmiar ląduje na ziemi obok Ciebie.
• Z większego stosu można kupić tylko część (np. 20 ze 100 sztuk drewna).
• Mod zachowuje jakość, wariant, wytrzymałość, twórcę i dane innych modów zapisane w przedmiocie (m_customData).
• Założonych przedmiotów i monet nie da się wystawić.

Instalacja

Mod musi być zainstalowany na serwerze i u każdego gracza. Jotunn odrzuci połączenie gracza, który go nie ma.

Wymagania: BepInExPack_Valheim, Jotunn (2.29.0 lub nowszy).

1. Skopiuj folder Adrian-Marketplace do BepInEx/plugins/. W r2modman: profil → Browse profile folder → BepInEx/plugins.
2. Na serwerze dedykowanym skopiuj ten sam folder do BepInEx/plugins/ serwera.
3. Uruchom serwer raz — powstanie plik konfiguracji BepInEx/config/adrian.valheim.marketplace.cfg.

Konfiguracja

Plik: BepInEx/config/adrian.valheim.marketplace.cfg

Sekcja	Ustawienie	Domyślnie	Opis
1 - Klient	Klawisz	F7	Klawisz otwierający okno.
2 - Serwer	ProwizjaProcent	0	Procent potrącany sprzedającemu od każdej sprzedaży (0–50). Prowizja wycofuje monety z gospodarki.
2 - Serwer	MaksOfertNaGracza	25	Limit jednoczesnych ofert jednego gracza.
2 - Serwer	WygasaniePoGodzinach	168	Po tylu godzinach czasu rzeczywistego oferta wraca do skrzynki sprzedającego. 0 = nigdy.
2 - Serwer	MaksCenaZaSztuke	100000	Najwyższa dozwolona cena za sztukę.
2 - Serwer	ZablokowanePrzedmioty	(puste)	Prefaby, których nie wolno wystawiać, oddzielone przecinkami, np. DragonEgg,Wishbone.

Ustawienia z sekcji Serwer obowiązują z pliku na serwerze — klient dostaje je razem z listą ofert.

Gdzie są dane

Serwer zapisuje oferty i skrzynki do BepInEx/config/Marketplace/<nazwa świata>.dat po każdej zmianie, a poprzednią wersję trzyma obok jako .dat.bak. Każdy świat ma osobne targowisko. Kopia tego pliku to kopia zapasowa całego handlu.

Jak to działa (dla admina)

• Serwer jest jedynym źródłem prawdy: przechowuje oferty i skrzynki, sprawdza ceny, ilości i limity.
• Gracza rozpoznaje po identyfikatorze postaci z jej obiektu w świecie, a nie po tym, co zgłasza klient.
• Każda odrzucona operacja zwraca przedmiot lub monety — nic nie ginie po drodze.
• Jak w całym Valheimie, ekwipunek należy do klienta. Zmodyfikowany klient mógłby oszukać przy płatności, dlatego warto mieć włączony anty-cheat (np. AzuAntiCheat).

Budowanie ze źródeł

Wystarczy Windows z .NET Framework 4 (kompilator csc.exe jest w systemie):

powershell -ExecutionPolicy Bypass -File build.ps1

Skrypt szuka Valheima w domyślnej lokalizacji Steama, a Jotunn i BepInEx w profilu r2modman „MMO Valheim”. Inne ścieżki podasz parametrami -Valheim i -Profile.