FAiNEL-ShopUI_Client icon

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.

Last updated a day ago
Total downloads 53
Total rating 0 
Categories Client Mods
Dependency string FAiNEL-ShopUI_Client-0.1.8
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack_V_Rising-1.733.2 icon
BepInEx-BepInExPack_V_Rising

BepInEx pack for V Rising. Preconfigured and includes Unity Base DLLs.

Preferred version: 1.733.2

README

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. soul and 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

  1. Install BepInEx for V Rising.
  2. 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.dll and ShopUI.Shared.dll).
  3. Make sure the server runs the ShopUI server module (see the requirement above).
  4. 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 versions command (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, darkred or vanilla.
  • [Diagnostics] Verbose — false by default. true turns on the verbose diagnostics in LogOutput.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 — false by default. Set it to true if 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.md of 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.