V Rising
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
Downloads
61
Size
267KB

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.

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.

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.

Настройки: VRising\BepInEx\config\fainel.shopui.client.cfg — [Keybinds] TogglePanel / AdminAuth / AdminRemove и [UIOptions] ColorScheme.

Поддержка и кредиты: проект — [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.

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.