FlexibleTraders

Description

Customize the inventories of Haldor, Hildir and the Bog Witch with YAML. Set purchase bundles, selling prices, currencies and progression conditions while keeping the normal trader window.

During online play, the inventory is synced from the server and locked; only the server may update the lists.

Overview

| Feature | Description |

| --- | --- |

| Trader inventory | Add items or override native stock with custom prices and quantities. |

| Buying and selling | Choose separate purchase and payout currencies, including sell-only items. |

| Progression conditions | Show or hide purchase offers using the world's existing global keys. |

| Optional Sell Window | Display a separate sell window in the vanilla UI style. |

| Optional tooltips | Display purchase costs and sale prices through local UI settings. |

| Multiplayer | The server controls the inventory; matching versions are required. |

Configuration and values

Inventory YAML

Edit BepInEx/config/FlexibleTraders/inventory.yaml. Valid changes reload automatically. Offline play uses your local file; multiplayer uses the server's inventory without overwriting client files.

Haldor:

• Item: Wood

Description:

Amount: 20

Currency: Coins

Price: 20

CanSell: false

SellCurrency:

UnitSellPrice: 1

RequiredGlobalKeys:

RequiredGlobalKeysMode: All

ForbiddenGlobalKeys:

Hildir:

BogWitch:

Price buys the whole Amount. UnitSellPrice pays for one sold item. Selling requires CanSell: true and a positive UnitSellPrice.

Empty values, "", null, ~, and omitted fields use these defaults:

| Empty field | Default |

| --- | --- |

| Item | Ignore the entry |

| Description | Original item tooltip |

| Amount, Price, UnitSellPrice | 0 |

| Currency | Coins |

| SellCurrency | Same as purchase currency |

| CanSell | false |

| RequiredGlobalKeys, ForbiddenGlobalKeys | No keys |

| RequiredGlobalKeysMode | All |

Amount: 0 creates a sell-only entry. Positive amounts must fit the item's current maximum stack size. CanSell: false prevents selling that item to the configured trader. Unlisted native stock keeps its normal behavior.

RequiredGlobalKeys and ForbiddenGlobalKeys accept comma-separated names, for example defeated_gdking,defeated_serpent. Spaces are optional; legacy [key1, key2] lists still work. RequiredGlobalKeysMode accepts All or Any. Any present ForbiddenGlobalKeys key hides the purchase offer. Conditions do not restrict selling. See the YAML comments for examples and a spoiler-conscious key reference.

Sell Window

Local [UI] option; default: true. Adds a window beside STORE using the native UI style. Select a stack, then press Sell to sell the whole stack. Vanilla valuables appear first, followed by sellable YAML items. The scrollbar appears only when needed. The original Sell button is hidden; STORE keeps its native coins-on-hand display.

Hide on empty defaults to true. It hides the window when there are no sellable items and reopens it when they become available. Sell Window Title defaults to INVENTORY; Sell Window Button defaults to Sell. These settings are local.

Show tooltip sell price

Local [UI] option; default: true. Shows the first eligible YAML price and payout currency, for example 20 Coins per unit (Total: 200). Vanilla's Valuable line is untouched.

Show tooltip cost

Local [UI] option; default: true. Adds Cost: 20 Coins to trader item tooltips. All UI options are local and are not synced with the server.

Tooltip strings

Local [UI] settings Cost string and Sale price string control the complete added rows, including labels. Defaults use orange sale values and yellow purchase costs. Edit labels for your language; currency names follow the game's localization. Empty strings hide their row. Changes reload automatically.

Existing YAML and config values are preserved on upgrade. Use the included examples to apply the new template and string defaults to an existing installation.

| Tag | Cost string | Sale price string |

| --- | --- | --- |

| #amount# | Whole