ShopUI Client
CLIENT-ONLY build of ShopUI for V Rising: merchant (NPC trader) panel, trader names above NPCs, 7 colour schemes. Requires the ShopUI server module on the server - the client alone does nothing. Made for the BLOODLUST server.
| Date uploaded | a day ago |
| Version | 0.1.7 |
| Download link | FAiNEL-ShopUI_Client-0.1.7.zip |
| Downloads | 5 |
| Dependency string | FAiNEL-ShopUI_Client-0.1.7 |
This mod requires the following mods to function
BepInEx-BepInExPack_V_Rising
BepInEx pack for V Rising. Preconfigured and includes Unity Base DLLs.
Preferred version: 1.733.2README
ShopUI — Client
Client part of the ShopUI merchant (NPC trader) panel for V Rising — merchant management window for administrators, trader names floating above the NPCs in the world (visible to every player), item search when filling the assortment, seven colour schemes, own widget layer (no UI framework dependency).
Developed for and maintained within the V Rising project [RU][PVE] BLOODLUST | BloodCraft | Brutal+.
⚠️ Read this first: this is a CLIENT-ONLY package
This Thunderstore package contains only the client part of ShopUI:
| File | Where it goes |
|---|---|
BepInEx/plugins/ShopUI/ShopUI.Client.dll |
game client |
BepInEx/plugins/ShopUI/ShopUI.Shared.dll |
game client |
The server part of the mod (ShopUI.Server.dll) is deliberately NOT part of this
package. ShopUI is a client–server mod: the client window is only a picture, all
data (merchant list, assortment, positions, spawn/despawn) lives on the server.
Server requirement (mandatory)
ShopUI was made specifically for the BLOODLUST server, and for it to work the server part of this mod must be installed on that server.
The server module (
ShopUI.Server.dll+ShopUI.Shared.dll) is not published on Thunderstore — it is installed and updated by the server administration.Without the server module the client mod does nothing: the panel stays empty, no merchant names appear, no requests reach the server. Do not install this package on servers that do not run the ShopUI server module.
The client is only useful on the server it was written for (BLOODLUST); it is not a generic merchant framework and it is not compatible with other server-side mods.
Features
- Merchant panel (administrators) — create a merchant, give it a name, choose the NPC prefab, place it in the world where you stand, fill its assortment (what it sells and what it charges) and remove it.
- Trader names in the world — the merchant name floats above the NPC's head and is visible to all players of the server, not only to the administrator.
- Assortment table — rows of
sells / amount / charges / amount / stock, an item picker with a search field (type e.g.souland pick the item from the list). - Restock schedule — how often the merchant refills its stock (0 = never).
- Roaming merchants — a checkbox makes the merchant walk around on its own.
- Colour schemes — violet, ice, acid, ember, graphite, dark red, vanilla; the scheme switch is in the panel header, the choice is saved in the config.
- Input safety — while a form or the item picker is open, gameplay input is suppressed, so the map, the spellbook or other game windows never steal the click.
- Interface language — English and Russian.
Controls
| Key | Action |
|---|---|
X |
open / close the ShopUI panel |
Num5 |
request administrator rights (the server checks its admin list) |
Num9 |
drop administrator rights |
The same actions are available as server console commands: .shopui (open the panel)
and .reload (re-read the merchant file and apply it to the world).
Installation
- Install BepInEx for V Rising.
- Install ShopUI_Client with a mod manager or drop the zip contents into your
game folder. Both DLLs must end up here:
VRising\BepInEx\plugins\ShopUI\(ShopUI.Client.dllandShopUI.Shared.dll). - Make sure the server runs the ShopUI server module (see the requirement above).
- Start the game. The panel opens with
X.
If the game is started through a mod manager profile (Gale and similar)
Some launchers (for example Gale) run the game from their own profile
directory and keep their own BepInEx there. In that case the game folder stays
clean and the mod has to be installed into the launcher's profile, not into
VRising\BepInEx\plugins — a copy in the game folder is simply not loaded.
- The folder to install into is the one shown by the launcher for the current
profile (
...\profiles\<profile>\BepInEx\plugins\ShopUI\). - The Thunderstore package is an ordinary zip: it can also be unpacked by hand into that folder if the launcher cannot import it.
- If the mod is installed but the panel does not open and the chat shows
[[SHOPUI]]{...}, that is exactly the symptom of the client part not being loaded — check the launcher's profile, not the game folder.
The client part and the server part must be the same version
The two halves are installed through different channels: players update the client part with their mod manager, the administrator copies the server part by hand. The versions can therefore drift apart, and the mod then behaves as if it were broken.
- Every request from the client carries its version; the server logs
client version X (server Y)and writes a warning when they differ. - The panel shows the same warning to the administrator.
- The server administrator can list the versions of all connected players with
the
.shopadmin versionscommand (stale versions are marked with!!).
Russian step-by-step instructions are shipped with the package as INSTALL.txt,
the administrator manual as ADMIN.txt.
Configuration
VRising\BepInEx\config\fainel.shopui.client.cfg
[Keybinds] TogglePanel— key that opens the panel (x,f5,numpad5,digit5…).[Keybinds] AdminAuth— key that requests administrator rights (numpad5).[Keybinds] AdminRemove— key that drops administrator rights (numpad9).[UIOptions] ColorScheme—violet,ice,acid,ember,graphite,darkredorvanilla.[Diagnostics] Verbose—falseby default.trueturns on the verbose diagnostics inLogOutput.log(input counters, key traces, chat samples). Keep it off: with it on the client log grows by hundreds of kilobytes per minute.[UIOptions] IgnoreVanillaMenuState—falseby default. Set it totrueif another mod keeps a fullscreen menu open (EclipsePlus and similar UI frameworks) and the panel hotkey stops working.
If your keyboard has no numeric keypad, write digit5 / digit9 into the config.
Support & credits
- ShopUI was created for and is maintained on [RU][PVE] BLOODLUST | BloodCraft | Brutal+ — RU and EU players are welcome. Bug reports and questions: contact the author on Discord (the server community can point you to the right channel).
- Third-party code was used as a reference while writing this mod, and the
authors are credited here and in
third_party_notices.md:- Eclipse by mfoltz (zfolmt) — the client↔server chat-bridge approach (sending and catching service messages through the game's chat network events, the Harmony patch on the chat update that swallows the handled message) follows Eclipse's design. Eclipse is licensed under CC BY-NC 4.0.
- Bloodcraft by mfoltz (zfolmt) — the server-side counterpart of the same chat-bridge pattern (handling chat messages on the server) was used as a reference. Bloodcraft is licensed under CC BY-NC 4.0.
- ZUI by Zanakinz (LGPLv3) — the first versions of the ShopUI interface were built on the ZUI framework. ZUI was completely removed on 15.11.2026: this release contains no ZUI code and no ZUI dependency, the interface is built on the mod's own widget layer. It is listed here for full transparency about the history of the project.
- Full notices, the list of what was taken from where and the licence texts are in
third_party_notices.mdof this package.
License
ShopUI's own code is proprietary, Copyright (c) 2026 FAiNEL — free personal use only,
see LICENSE.md. The parts that follow the design of Eclipse and Bloodcraft remain
licensed under CC BY-NC 4.0 and are
not covered by the proprietary terms — see third_party_notices.md.
ShopUI — клиент
Клиентская часть мода ShopUI (панель управления торговцами NPC) для V Rising — окно администратора, названия торговцев над их головами в мире (видны всем игрокам), поиск предметов при заполнении ассортимента, семь цветовых схем, собственный слой виджетов (без зависимости от UI-фреймворков).
Создано и поддерживается в рамках проекта [RU][PVE] BLOODLUST | BloodCraft | Brutal+.
⚠️ Важно: это пакет ТОЛЬКО клиентской части
В этот пакет входит только клиентская часть ShopUI:
| Файл | Куда ставить |
|---|---|
BepInEx/plugins/ShopUI/ShopUI.Client.dll |
клиент игры |
BepInEx/plugins/ShopUI/ShopUI.Shared.dll |
клиент игры |
Серверная часть мода (ShopUI.Server.dll) намеренно НЕ входит в пакет.
ShopUI — мод с клиент-серверной архитектурой: окно на клиенте — это только картинка,
все данные (список торговцев, ассортимент, координаты, спавн/деспавн) живут на сервере.
Требование к серверу (обязательное)
Мод сделан специально под сервер BLOODLUST, и для его корректной работы на этом сервере установлена серверная часть мода.
Серверный модуль (
ShopUI.Server.dll+ShopUI.Shared.dll) не публикуется на Thunderstore — его устанавливает и обновляет администрация сервера.Без серверного модуля клиентская часть не работает: окно пустое, названия торговцев не появляются, запросы до сервера не доходят. Не ставьте этот пакет на серверы, где нет серверного модуля ShopUI.
Клиент полезен только на сервере, для которого он написан (BLOODLUST); это не универсальный фреймворк торговцев и он не совместим с другими серверными модами.
Возможности: окно управления торговцами (создать, назвать, выбрать префаб, поставить на место, заполнить товары, убрать); название торговца над его головой, которое видят все игроки сервера; таблица ассортимента «продаёт / кол-во / получает / кол-во / запас»; поиск предмета по названию; расписание пополнения запасов; перемещающиеся торговцы; семь схем интерфейса; полное подавление игрового ввода, пока открыта форма; интерфейс ru/en.
Управление: X — открыть/закрыть окно, Num5 — запросить права администратора
(сервер проверяет свой список админов), Num9 — снять права. Те же действия есть
консольными командами сервера: .shopui и .reload.
Установка: поставьте BepInEx, затем распакуйте пакет так, чтобы оба DLL
(ShopUI.Client.dll и ShopUI.Shared.dll) оказались в
VRising\BepInEx\plugins\ShopUI\, и убедитесь, что на сервере установлен серверный
модуль ShopUI. Подробная инструкция — в файле INSTALL.txt этого пакета,
руководство администратора — в ADMIN.txt.
Если игра запускается через профиль мод-менеджера (Gale и подобные): лаунчер
держит свой BepInEx в профиле, и мод надо ставить в профиль лаунчера, а не в
папку игры — копия в папке игры просто не загрузится. Пакет Thunderstore — это
обычный zip, его можно распаковать руками в
...\profiles\<профиль>\BepInEx\plugins\ShopUI\. Если в чате видно
[[SHOPUI]]{...}, а панель не открывается — значит клиентская часть просто не
загрузилась: проверьте профиль лаунчера, а не папку игры.
Клиентская и серверная части должны быть одной версии: клиент игроки
обновляют через мод-менеджер, сервер админ ставит руками. Клиент передаёт свою
версию в каждом запросе, сервер пишет предупреждение в лог при расхождении и
показывает его в панели; админ может посмотреть версии всех подключённых
игроков командой .shopadmin versions (устаревшие помечены !!).
Настройки: VRising\BepInEx\config\fainel.shopui.client.cfg —
[Keybinds] TogglePanel / AdminAuth / AdminRemove и [UIOptions] ColorScheme.
Дополнительно [Diagnostics] Verbose (false по умолчанию) — подробные логи
в LogOutput.log; по умолчанию выключено, чтобы лог не рос на сотни килобайт
в минуту. И [UIOptions] IgnoreVanillaMenuState (false) — включить, если
другой мод (EclipsePlus и подобные) держит полноэкранное меню открытым и бинд
перестал работать.
Поддержка и кредиты: проект — [RU][PVE] BLOODLUST | BloodCraft | Brutal+;
баг-репорты — Discord сообщества сервера. При написании мода использовались
сторонние проекты как референс, авторы указаны здесь и в third_party_notices.md:
Eclipse и
Bloodcraft авторства mfoltz (zfolmt)
(CC BY-NC 4.0) — схема обмена сообщениями клиент↔сервер через чат; ZUI
авторства Zanakinz (LGPLv3) — на нём был построен интерфейс первых версий,
15.11.2026 ZUI полностью удалён, в этой сборке его кода и зависимости нет.
Лицензия: собственный код ShopUI — проприетарный, Copyright (c) 2026 FAiNEL
(бесплатное личное использование, см. LICENSE.md). Части, следующие дизайну
Eclipse и Bloodcraft, остаются под лицензией
CC BY-NC 4.0 — см. third_party_notices.md.
CHANGELOG
Changelog — ShopUI (client)
All notable changes to the client part of ShopUI. The server module
(ShopUI.Server) has its own history and is not part of this package.
0.1.8 — 2026-11-17
Interface rework: proportions, column alignment and readable text.
- The merchant card is aligned: the labels (
Name:,Prefab:,Restock, min:) sit in one column and the fields in another, instead of drifting apart. Every label and every field now has a fixed width, so the card looks the same no matter how long the names are. - The assortment table has one grid for the whole table: the header
(
Sells,Amount,Charges,Amount,Stock) sits exactly above its own columns, and the columns of the header and of the rows are computed from the same numbers. Numbers are centred in their columns. - The side lists are one piece again: the title and the list live in a single frame that is attached to the edge of the window, the scroll bar is inside the frame (it used to hang outside), and the list is centred vertically against the window and follows it when the window is dragged.
- Readable text in every colour scheme: the main text is neutral in all
schemes, and the accent colour is used only for the main action (
Apply). In the lists the selected row is no longer white text on a white background. - The old skin pop-up window was removed (it opened a second panel on top of the main window); the scheme buttons are now in the window header.
0.1.7 — 2026-11-16
Interface polish.
- The merchant list and the skin list are popups again: they appear on
clicking the corresponding button and hide on clicking it again (or on
Esc). They are no longer permanently visible on both sides of the window. - The lists are now part of the window instead of separate windows: they are placed inside the main window, docked flush to its left and right edges, and move with it when the window is dragged. They cannot be dragged apart from the window any more.
- Cosmetic fixes: shorter list titles, a close button in the list header, and the lists use the same window background as the rest of the interface.
0.1.6 — 2026-11-16
- The client now checks at start-up that the loaded
ShopUI.Shared.dllis the same version asShopUI.Client.dlland writes a clear error into the log if they differ. Updating only one of the two files used to break the mod with an obscureMissingMethodExceptionand[vcf] An internal error has occurred.on the.shopuicommand. - The server part (separate package) no longer leaves the spawned traders
hostile: they get the "ignored" faction and deal no damage, so a trader never
attacks a player and never fights back when attacked. The behaviour is
configurable on the server (
[Merchants] FactionMode).
0.1.5 — 2026-11-16
Interface adapted for Full HD (1920x1080).
- The merchant list and the skin list are now permanent side panels — merchants on the left, interface schemes on the right, docked flush against the main window and moving with it. They used to be pop-up windows over the panel, and together with the window they did not fit on a 1080p screen.
- The window itself was narrowed (1040x760) so that the whole layout (window + both side panels) fits on a 1920x1080 screen with margins.
- The merchant button in the toolbar and the skin button in the header now only show the current selection; the lists live in the side panels.
0.1.4 — 2026-11-16
Version handshake between the client and the server halves.
- The client sends its version with every request and the server replies with its own. If they differ, the server writes a warning to its log and the panel shows it to the administrator — the client and the server parts are installed through different channels (players use a mod manager, the administrator copies the server part by hand), so the versions can silently drift apart.
- The server now knows the version of every connected client; the new
.shopadmin versionscommand lists them (stale versions are marked with!!). - The client part and the server part must be the same version.
0.1.3 — 2026-11-16
Compatibility fixes reported from a customer's server.
- Fixed: the panel hotkey did nothing when another mod keeps a fullscreen menu
open (EclipsePlus 1.4.0 and similar UI frameworks keep the game's
"current menu" set, so the hotkey was skipped 27 times per session).
The check now looks at the game's menu type instead of the menu object, and
the new config switch
[UIOptions] IgnoreVanillaMenuState(defaultfalse) opens the panel with the hotkey regardless of other mods' UI. - The server module (separate package) no longer adds components to the spawned trader: adding a component to a networked entity changes its archetype and breaks the game's network snapshots, which disconnected players from the server. The merchant now keeps the vanilla component set.
0.1.2 — 2026-11-16
Fixes and improvements requested after testing on a customer's server.
- No more log spam. The verbose diagnostics (input counters every second,
key traces, chat samples) are now behind a config switch
[Diagnostics] Verbose(default off). Previously the client log grew by hundreds of kilobytes per minute. - Admin rights are requested before the panel opens. Pressing
Xno longer produces a "Недостаточно прав" refusal for players who do have rights but the mod had not asked for them yet — it now asks first and opens the panel as soon as the server confirms. - Clearer merchant state. The editor card now shows explicitly whether the
trader is in the world (
● В мире…) or taken off it (○ Снят с мира: сам не вернётся после перезапуска сервера…). - The panel hotkey no longer fires while a vanilla menu is open (map,
settings, spellbook), so
Xcannot leak into the game. - Server side (separate module, not in this package): the log now says
assortment is empty, nothing to applyinstead of the confusingapplied 0 of 0 offer(s).
0.1.1 — 2026-11-16
Fixes after the first release.
- Fixed: the mod broke when the game switched servers (or returned from the
menu) without a restart. The mod stayed bound to the old client world, so it
stopped finding the local character and stopped intercepting its own service
messages — they appeared in the chat as raw
[[SHOPUI]]{…}JSON. The mod now re-binds to the new world on its own and resets the world-dependent state (queues, snapshots, nameplates). - The chat interceptor now destroys the message entity through the world the chat system itself belongs to, so a stale world can no longer make the interception fail.
INSTALL.txt/ADMIN.txtare now UTF-8 with BOM (they open correctly in Notepad).
0.1.0 — 2026-11-16
First public release of the client part of ShopUI.
- Merchant (NPC trader) management window for server administrators: create, rename, choose the prefab, place in the world, fill the assortment, remove.
- Merchant names float above the NPCs and are visible to all players of the server, not only to the administrator.
- Item picker with a search field when filling the assortment.
- Restock schedule and "roaming merchants" option.
- Seven colour schemes (violet, ice, acid, ember, graphite, dark red, vanilla), switchable from the panel header and remembered in the config.
- Input suppression while a form or the item picker is open.
- English and Russian interface.
- Own widget layer — no dependency on ZUI or any other UI framework.
Important notes for this release
- This package is client-only. The server module of the mod is not part of it and is not published on Thunderstore; it is installed by the server administration. Without the server module the client does nothing.
- The mod was written specifically for the BLOODLUST server (https://wargm.ru/server/81982) and is meant to be used there.
- Third-party projects used as a reference (Eclipse, Bloodcraft, ZUI) are
credited in
README.mdandthird_party_notices.md.