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.

• 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

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.

Changelog

1.5.0

• Jobs (formerly Bounties) have their own main tab, JOBS, instead of being hidden inside the order board. The tab shows how many reports wait for your confirmation, e.g. JOBS (1).
• Buy orders have their own main tab, BUY ORDERS.
• The BUY tab is now called MARKETPLACE.
• Discord: the Northarun Discord link with its icon is in the top-left corner of the window, as in Guilds.
• "Bounty" is renamed to "job" in all texts (English and Polish). Config keys keep their names, so existing configs keep working.
• The window is wider (1180 px) to fit seven tabs; the list and details panels are wider too.

1.4.0

• Price history: every trade between players (market purchases and deliveries to buy orders) is recorded per item. The details panel shows the market price — volume-weighted average, range and number of trades from the last 20 trades — when buying, listing and posting a buy order. The SELL list and the buy order item picker show the market average next to each item.
• Market hints: a small ! badge next to the price field. Hover it for a tooltip, click it to jump there:
  • when listing an item that someone has a buy order for ("someone is buying this at 45"),
  • when posting a buy order for an item that is already on the market ("cheaper on the market"). The badge is highlighted when the other side is at least as good as your price.
• Categories: filter listings and the buy order item picker by Weapons, Armor, Tools, Materials, Food, Potions or Other, based on the game's own item types. In the picker, a category alone is enough to browse (no need to type a name).
• Save data from 1.3.0 is migrated automatically (price history starts empty).

1.3.0

• Public bank API (Marketplace.MarketplaceApi) for other mods. Used by Guilds: the founding fee can be paid from the bank, and members can move coins between their bank balance and the guild treasury.
• Bank history shows payments to and payouts from guilds.

1.2.0

• New ORDERS tab — the order board:
  • Buy orders: post "buying X× item at Y coins"; the coins are locked on the server right away. Anyone with the item can deliver (also partially) and is paid instantly; items go to the buyer's mailbox.
  • Bounties: post a task with a reward locked on the server. A contractor takes the job, reports it as done, and the poster confirms (pays) or rejects. Admins can pay out or cancel any bounty to settle disputes.
• New config section [3 - Order Board]: MaxBuyOrdersPerPlayer, MaxBountiesPerPlayer, BountyClaimTimeoutHours.
• FeePercent now applies to all payouts: sales, buy order deliveries and bounty rewards.
• Bank history shows buy order and bounty transactions.
• The window is wider (1100 px) to fit six tabs.
• Save data from 1.1.0 is migrated automatically.

1.1.0

• English is now the default language. Polish is available via Language = Polish in the config (it can be switched while in game).
• New BANK tab: deposit and withdraw coins, transaction history (last 50 entries). The balance is stored on the server — it cannot be lost on death.
• Sale income goes straight to the bank balance. Purchases are paid from the balance first; if it is too low, the rest is taken from the inventory.
• Withdrawals check inventory space before coins are sent.
• Server transaction log for admins: BepInEx/config/Marketplace/<world>.log.
• Fixed: list rows were shifted left, outside the window, cutting off item names and icons.
• Fixed: white square behind the item icon in the details panel.
• Config keys renamed to English ([1 - Client], [2 - Server]) — set your server values again after updating.
• Save data from 1.0.0 is migrated automatically; coins waiting in the mailbox move to the bank balance.

1.0.0

• First release: BUY, SELL, MY LISTINGS and MAILBOX tabs, partial stack purchases, search and sorting, server settings (fee, listing limit, expiry, max price, blocked items).