WeaponsOnBLOODLUST
Client-side renamer for the BLOODLUST server: red custom RU/EN weapon names in tooltip, inventory, crafting, shop and Eclipse UI, plus a custom description line.
| Last updated | 2 days ago |
| Total downloads | 26 |
| Total rating | 0 |
| Categories | Client |
| Dependency string | BLOODLUST-WeaponsOnBLOODLUST-1.1.0 |
| Dependants | 0 other packages depend on this package |
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
Weapons on BLOODLUST
Клиентский мод для сервера BLOODLUST: заменяет ванильные названия оружия на ваши собственные — в тултипе, инвентаре, сундуках, крафте, магазине и в панелях Eclipse.
Имена задаются в одном JSON-файле и перечитываются на ходу: перезапускать игру после правки таблицы не нужно.
Ставить нужно только клиентскую часть. Мод целиком работает на клиенте: сервер ничего не устанавливает, не настраивает и не перезапускает. Серверная часть мода (уведомления в чате) — отдельный, необязательный мод; без неё названия в интерфейсе всё равно меняются.
Почему это клиентский мод. В V Rising имя предмета — это клиентская локализация: у предмета есть ключ, а строка берётся из языковых файлов клиента. Сервер присылает только
PrefabGUIDи не может передать произвольное имя, поэтому замена названия возможна только на клиенте — так же, как это делают ShopUI, Eclipse и другие UI-моды.
Установка
- Установите BepInExPack for V Rising.
- Установите этот мод через мод-менеджер (Thunderstore Mod Manager / r2modman / Gale).
- Запустите игру — таблица создастся сама:
BepInEx/config/WeaponsOnBLOODLUST/weapon-names.bloodlust.json.
При ручной установке распакуйте архив так, чтобы WeaponsOnBLOODLUST.dll лежал в
BepInEx/plugins/WeaponsOnBLOODLUST/.
Ничего дополнительно настраивать не нужно: 15 имён уже вшиты в мод по умолчанию — поставил и видишь кастомные названия.
Eclipse не обязателен: без него мод меняет названия в ванильном интерфейсе. Если Eclipse
установлен (любая сборка, включая Eclipse by FAiNEL), мод дополнительно дописывает те же
имена в его сервис локализации — панели Eclipse показывают те же названия.
Настройка
BepInEx/config/bloodlust.weaponnames.cfg:
| Секция | Ключ | По умолчанию | Что делает |
|---|---|---|---|
| 01 General | Enabled |
true |
включить подмену имён |
| 01 General | Language |
auto |
auto (язык игры), ru или en |
| 01 General | ColorizeNames |
true |
красить названия из таблицы |
| 01 General | NameColor |
#FF0000 |
цвет названий (#RRGGBB) |
| 02 Diagnostics | Debug |
false |
подробный лог |
| 03 Integration | EclipseIntegration |
true |
дописывать имена в сервис локализации Eclipse, если он загружен |
| 04 Description | DescriptionEnabled |
true |
подменять описание оружия из таблицы |
| 04 Description | Description |
строка про Discord | текст описания (RU и остальные языки) |
| 04 Description | DescriptionEn |
пусто | текст описания для EN-клиента (пусто — берётся Description) |
Цвет и описание
Названия из таблицы красятся rich-text тегом <color=#FF0000>…</color> — это понимает
UI игры (TextMeshPro). Поменять цвет можно на ходу: NameColor = #FF3B3B и т.п.
Полностью отключить покраску — ColorizeNames = false.
04 Description заменяет описание предмета (блок «атрибуты» в тултипе) на свой текст.
По умолчанию там:
Все подробности об оружии в нашем дискорде - https://discord.com/invite/HGRBMwSyse
Переносы строк в конфиге пишутся как \n. Ключ описания мод берёт из клиентских данных
предмета (ManagedItemData.Description), поэтому вручную ничего указывать не нужно.
Если игра обновится и структура данных изменится, описания останутся ванильными, а
названия продолжат работать — в логе будет строка description lookup disabled: ….
Таблица имён
BepInEx/config/WeaponsOnBLOODLUST/weapon-names.bloodlust.json:
{
"version": 1,
"weapons": [
{
"guid": -1961050884,
"key": "f21f54d0-d0f8-4d8f-99ef-1ea2c83282dc",
"ru": "Кинжалы Альтаира",
"en": "Altair's Daggers",
"enabled": true
}
]
}
guid—PrefabGUIDпредмета.key— ключ локализации имени. Можно не указывать: мод найдёт его поguidво встроенной карте (собрана из данных игры этой версии).ru,en— имена. Русский/украинский/белорусский клиент получаетru, остальные —en. Если одно поле пустое, берётся второе.enabled— выключить запись, не удаляя её.
Файл перечитывается примерно раз в 4 секунды, перезапуск игры не нужен.
Если вашего предмета нет во встроенной карте ключей, впишите key вручную. Ключ можно
найти в VRising_Data/StreamingAssets/Localization/Russian.json (поле guid у нужного
текста).
Что меняется, а что нет
Меняются отображаемое имя (с настраиваемым цветом) и, если включено, описание предмета. Не меняются: иконка, статы, уровень, редкость, крафт-рецепт, поведение предмета и другие моды.
Совместим с Eclipse, EclipsePlus, Bloodcraft, ShopUI, Kindred и любыми другими модами: подменяется текст по конкретным ключам локализации, всё остальное не трогается. Сам Eclipse не пересобирается и не патчится — используется только его публичное поведение и, при желании, его словари локализации через мягкую интеграцию.
Если что-то пошло не так, мод пишет причину в BepInEx/LogOutput.log и никогда не
ломает игру: после 5 ошибок подмена отключается до перезапуска, остаются ванильные имена.
Работает на любом сервере: подмена происходит локально на клиенте и не зависит от того, какие моды стоят на сервере.
Проверка
- Запустите игру, откройте
BepInEx/LogOutput.log. - Должно быть:
[WeaponsOnBLOODLUST] patch ok: Localization.Get(LocalizationKey,bool)
[WeaponsOnBLOODLUST] patch ok: Localization.Get(AssetGuid,bool)
[WeaponsOnBLOODLUST] table applied: 15 name(s), skipped=0
[WeaponsOnBLOODLUST] descriptions: 15/15 item(s) resolved
[WeaponsOnBLOODLUST] applied 15/15 name(s) to client localization (language=Russian -> ru, missing keys=0, descriptions=15)
Если установлен Eclipse, рядом появится:
[WeaponsOnBLOODLUST] Eclipse integration: 15 name(s) written into Eclipse.LocalizationService
- Наведите курсор на оружие — в тултипе будет ваше имя.
Если в логе applied 0/15 или missing keys=15 — не совпала версия игры; пришлите
версию игры и строку лога.
English
Client-side renamer for the BLOODLUST server: replaces the vanilla names of chosen weapons with your own in the tooltip, inventory, containers, crafting, shop and Eclipse panels. Names live in one JSON file and reload while the game is running.
Install the client part only. The server installs nothing; the optional server-side mod only posts chat notifications, and the names in the UI change without it.
Why client-side: in V Rising an item's name is client localization looked up by the
item's name key, and the server only sends the PrefabGUID, so only the client can change
the displayed name. That is exactly how ShopUI, Eclipse and other UI mods do it.
Install BepInExPack, install this package, then edit
BepInEx/config/WeaponsOnBLOODLUST/weapon-names.bloodlust.json
(guid, optional key, ru, en, enabled). Language comes from the game (auto), or
force it with Language = ru|en. Names are shown in red by default — change NameColor or
set ColorizeNames = false. Section 04 Description replaces the item description
(attributes block in the tooltip) with your own line. Icons, stats, recipes and other mods
are untouched. Eclipse is optional: without it the mod still renames items in the vanilla
UI; with it, the same names are also written into Eclipse's localization service.
The mod never breaks the game: it logs the reason and disables itself for the session after 5 errors.
Обратная связь
Присылайте версию игры, BepInEx/LogOutput.log и содержимое вашей таблицы — по ним видно,
какой ключ не нашёлся.