LHDF Shop

# LHDF Shop

Traders, player accounts and cash for Arma Reforger. Part of the Lost Hope Dynamic Framework (LHDF), built for the Lost Hope Survival server.

Every player has an account with a saved balance. Traders sell and buy back items, vehicles and helicopters in a shop window, and the server checks every trade. Each item has a category, a tier and a price; a trader sells the items whose category it offers and whose tier it sells. Server owners change prices, items and shop types in one JSON file.

## Features

- Player accounts: starting balance, saved balance and the last 100 trades.
- Cash items of $100, $500 and $1000. Cash is lost on death and can be looted; the account balance is safe.
- Banking: deposit carried cash, withdraw cash from $100 to $50,000.
- Shop window with Buy, Sell, Bank and "My vehicles" views: categories, search, 3D previews, item stats, quantity. Mouse and controller.
- 529 vanilla items in 33 categories (weapons and accessories, gear, vehicles).
- Three tiers: basic (general store), standard (specialist shops), restricted (black market).
- 8 shop types: General store, Gun store, Outfitter, Vehicle dealer, Helicopter dealer, Medic, Black market, Bank. Each has a price markup.
- Ready traders for the Game Master: Shopkeeper, Cashier, Black market trader, Medic. Shopkeepers wear a random outfit, take no damage and stand still.
- Vehicle and helicopter delivery to a spot next to the trader. A blocked spot refuses the purchase without charging.
- Vehicle buy-back, priced by health.
- Map marker with the shop's name.
- Game Master attributes: shop type, categories, tiers, banking and map marker on traders; adjust money on players; shape and served trader on vehicle spots. Changes are saved.
- Sell rules: containers pay for their content, magazines for the rounds left, spawn loadout items sell for 0.
- Patch mods add items of other mods (RHS, WCS, Nasty, Misc, Smurfs Base Building).
- Other LHDF mods pay players through the Shop (for example Encounters rewards).

## Required on server and clients

Yes. The shop window runs on the client, traders and balances are replicated, and every client builds the item data from the same item lists and settings as the server.

## Dependencies

- Arma Reforger
- LHDF Core

Optional: LHDF Vehicle Lock. With it, bought vehicles belong to the buyer and can be sold back. Without it, vehicles are delivered unowned.

## Configuration

Settings live in `$profile:LHDF/<namespace>/Shop.json`. On every start the server writes every key with its default to `_defaults/Shop.json`, plus `_defaults/Shop.md` (shop types and categories with item counts) and `_defaults/Shop.Items.csv` (every item with GUID, category, tier and price).

Most important keys:

- `startingBalance` (10000): balance on first join.
- `maxBalance` (1000000000): credits stop at this balance.
- `interactionDistance` (5): distance to the trader for trading, in metres.
- `dropPurchasesWhenFull` (false): drop what does not fit instead of not selling it.
- `vehicleSellRatio` (0.5): buy-back share of a vehicle's price, scaled by health.
- `vehicleSellRange` (50): distance of a vehicle to the trader or its spot to be sold.
- `sellClaimedVehicles` (false): buy back claimed vehicles too.
- `blockLoadoutSelling` (true): spawn loadout items sell for 0.
- `shops`: change a shop type (name, categories, tiers, banking, markup, enabled) or add one.
- `categories`: change a category's defaults (price, sellRatio, maxQuantity, vehicle) or add one.
- `items`: change an item by prefab GUID (price, tier, category, sellPrice, maxQuantity), disable it, or add an item with category and price.

Example: `{ "shops": { "general": { "markup": 1.2 } }, "items": { "3E413771E1834D2F": { "price": 1800 } } }`

`Shop/Grants.json` in the same folder credits money to a player once (by identity id). The server never writes this file.

## Known limitations

- Selling vehicles back needs a vehicle ownership provider (LHDF Vehicle Lock). Without it, bought vehicles are unowned and cannot be sold back.
- Vehicles need a free vehicle or helicopter spot linked to the trader or within 150 m of it.
- A Game Master category attribute shows at most 24 categories. A group with more categories is split into several attributes.

Beta (0.9.0): feedback welcome on the Lost Hope Survival Discord: https://discord.gg/uDzYTTdsM6