BLOODLUST-WeaponsOnBLOODLUST icon

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-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

Weapons on BLOODLUST

Клиентский мод для сервера BLOODLUST: заменяет ванильные названия оружия на ваши собственные — в тултипе, инвентаре, сундуках, крафте, магазине и в панелях Eclipse.

Имена задаются в одном JSON-файле и перечитываются на ходу: перезапускать игру после правки таблицы не нужно.

Ставить нужно только клиентскую часть. Мод целиком работает на клиенте: сервер ничего не устанавливает, не настраивает и не перезапускает. Серверная часть мода (уведомления в чате) — отдельный, необязательный мод; без неё названия в интерфейсе всё равно меняются.

Почему это клиентский мод. В V Rising имя предмета — это клиентская локализация: у предмета есть ключ, а строка берётся из языковых файлов клиента. Сервер присылает только PrefabGUID и не может передать произвольное имя, поэтому замена названия возможна только на клиенте — так же, как это делают ShopUI, Eclipse и другие UI-моды.


Установка

  1. Установите BepInExPack for V Rising.
  2. Установите этот мод через мод-менеджер (Thunderstore Mod Manager / r2modman / Gale).
  3. Запустите игру — таблица создастся сама: 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 ошибок подмена отключается до перезапуска, остаются ванильные имена.

Работает на любом сервере: подмена происходит локально на клиенте и не зависит от того, какие моды стоят на сервере.


Проверка

  1. Запустите игру, откройте BepInEx/LogOutput.log.
  2. Должно быть:
[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
  1. Наведите курсор на оружие — в тултипе будет ваше имя.

Если в логе 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 и содержимое вашей таблицы — по ним видно, какой ключ не нашёлся.