Summary
# DLG Shop
Traders, player accounts and cash for survival and PvPvE scenarios, configured by server owners in JSON.
Description
# DLG Shop
Traders, player accounts and cash for survival and PvPvE scenarios, configured by server owners in JSON.
Players buy and sell at shopkeepers and cashier desks. Money on the account survives death; cash in the
inventory does not, and can be looted. Every trade is checked on the server, and money and gear are saved
together through DLG Core.
## Features
- **Accounts** with a starting balance, a maximum balance and a history of the last 100 trades.
- **Cash items** ($100, $500, $1000): carried, lost on death, lootable. Deposit and withdraw at shops with
banking.
- **Shop presets:** general store, ATM, gun store, outfitter, vehicle dealer, helicopter dealer, black
market and medic. One trader can run several of them, one tab each in its window (e.g. gun store and
outfitter), and leave out categories it shouldn't sell.
- **Shared categories:** vanilla and mod items of one kind are in one category (all assault rifles, all
helmets, ...), whichever mods are loaded.
- **Arsenal-style shop window:** search, categories, 3D item previews, a stats panel (magazine, fire modes,
rate of fire, capacity, weight), buy, sell, sell all, bank.
- **Vehicles:** delivered to the shop's ground or helicopter spot, owned and locked for the buyer (DLG
Vehicle Lock), sold back by the owner at the shop, paid by the vehicle's health.
- **Black market:** an exclusive preset. What it sells is removed from every other shop.
- **Medic:** a shop that never trades vehicles.
- **Map markers** with the shop's name, switchable per shop.
- **Catalogs in folders:** one folder per category, any number of lists merged, entries switched off with
`"enabled": false`. New items from mod updates are appended without touching your prices.
- **Automatic catalogs** from faction entity catalogs, priced from supply cost.
- **Vanilla catalogs built in**, mod content through **catalog patches**: DLG Shop - WCS, DLG Shop - RHS
and DLG Shop - Nasty add their items to the same shops and categories when loaded, and hide them again
when removed.
- **Exploit protection:** the server never trusts the client with player ids or prices; sell prices are
capped so buying in one shop and selling in another makes no money; spawn loadout items are not bought
back; rate limit and distance checks on every request.
- **Game Master:** place shopkeepers, cashiers, black market traders, medics and vehicle spots; pick the
shops a trader runs and the categories it offers; switch its map marker; link spots to shops; give or
take money. Everything placed is kept across restarts.
- **Currency for other mods:** DLG mods pay players through DLG Core without depending on DLG Shop.
## Required on server and clients
The server and every player need the mod.
## Dependencies
- DLG Core
- DLG Vehicle Lock
Optional catalog patches (load the ones for the content your server runs):
- DLG Shop - RHS: RHS: Status Quo weapons, gear, vehicles and helicopters
- DLG Shop - WCS: WCS modpack weapons, gear, vehicles, helicopters, black market and medic items (needs DLG Shop - RHS)
- DLG Shop - Nasty: Nasty weapon mods and the Ripsaw, black market M700 and M242 Ripsaw
- DLG Shop - Misc: Barrett M107A1 and M82, Desert Eagle, ReforgedZ KartBuggy and Mosquito
- DLG Shop - Smurfs: Smurfs Base Building System plans and kits, black market breaching charges
## Configuration
Server owners edit the JSON files in `$profile:DLG/<namespace>/`:
- `Shop.json`: balances, distances, vehicle delivery and buy-back, loadout selling, presets, cash items,
blacklist
- `Shop/Catalogs/<catalog>.json`: which categories a shop sells and how automatic items are priced
- `Shop/Categories/<id>/*.json`: the items, prices and limits
The files are created from the scenario defaults on first start. Missing keys are added after updates;
your values are kept. Restart the server after editing.
## For mission makers
Use the game mode prefab `DLG_GameMode_Shop.et`, or add `DLG_CoreComponent` and
`DLG_ShopEconomyComponent` to your game mode. Place `DLG_Shopkeeper.et` and tick the shops it runs.
Vehicle shops need a `DLG_ShopVehicleSpot.et` or `DLG_ShopHelicopterSpot.et` within 150 m, or one with the
same Shop Id.
## Other DLG mods
- DLG Core: identity and persistence for all DLG mods
- DLG Vehicle Lock: owned vehicles, keys and locks
- DLG Game Master Additions: map entity hider, safe zones
- DLG Loot Spawner: map-wide loot and Game Master loot areas
- DLG Encounters: configurable encounters and tasks
License
CUSTOM LICENSE – RESTRICTED SERVER USE
Version 1.0 – [Date]
1. OWNERSHIP
This mod, including all code, assets, configurations and documentation
(the "Content"), is created and owned by BoomstickBarry/ the DLG Team (the "Author").
All rights not expressly granted in this license are reserved.
2. PERMITTED USE
Without further permission, you may:
a) download the Content through the Arma Reforger Workshop;
b) use it in single-player, offline or local Workbench sessions for
personal, non-commercial purposes;
c) host it on the following authorized servers only:
[DLG Survival PvPvE - Nizla Island].
3. SERVER RESTRICTION
You may not load, host, run or otherwise deploy the Content, in whole or
in part, on any multiplayer server other than those listed in Section 2(c)
without prior written permission from the Author. This applies to public,
private, password-protected, unlisted, test and event servers, and to
server-side-only use.
4. REQUESTING PERMISSION
Requests must be sent to [Discord/email]. Permission is valid only if
given in writing by the Author, applies only to the servers named in it,
and cannot be transferred or sublicensed.
5. NO REDISTRIBUTION
You may not reupload, mirror, repack, merge into another mod, or otherwise
redistribute the Content on any platform.
6. NO DERIVATIVES
You may not modify, adapt, decompile, extract assets or code from, or
create works based on the Content without written permission. Creating a
separate mod that lists the Content as a dependency is allowed only for
use on authorized servers.
7. NO COMMERCIAL USE
You may not sell the Content or use it in any context involving direct or
indirect financial gain, including servers with paid access, paid perks
or donation-based advantages.
7a. NO USE OUTSIDE BOHEMIA INTERACTIVE PRODUCTS
The Content may only be used within Arma Reforger and other Bohemia
Interactive products. It may not be transferred to, used in, or adapted
for any other game, engine or platform.
8. TECHNICAL MEASURES
The Content may include checks that limit its functionality to authorized
servers. Circumventing, disabling or removing these checks is prohibited.
9. TERMINATION AND REVOCATION
Any breach of this license automatically ends your rights under it. The
Author may revoke any granted permission at any time. After termination
or revocation, you must stop using the Content on any server immediately.
10. NO WARRANTY
The Content is provided "as is", without warranty of any kind. The Author
is not liable for any damage, data loss or server issues arising from its
use.
11. THIRD-PARTY CONTENT
Any third-party material included in the Content remains subject to its
own license, and nothing here overrides those terms.
12. CHANGES
The Author may update this license. The version shown on the Workshop
page is the one that applies.
13. SEVERABILITY
If any part of this license is found unenforceable, the rest remains in
effect.
