Eclipse by FAiNEL

Client-side BepInEx plugin with quality-of-life UI fixes for the EclipsePlus / Bloodcraft stack in V Rising.

Features

• Real game icons in Stat Bonuses for all new weapon types (TwinBlades, Daggers, Claws, Unarmed, FishingPole) and blood types (Immortal, VBlood, GateBoss) — no more placeholder sword.
• Centered ×1.5 synergy markers: class-synergy stats in the Weapon Expertise / Blood Legacies lists get a yellow ×1.5 label right in the middle of the row (size and font match the row text). The 4th HUD stat applies the same ×1.5 class-synergy multiplier as the vanilla stat lines.
• Familiars tab fixes: the page scrolls cleanly (no longer paints over the menu tab headers), unused Battles/Talents mode buttons are hidden.
• Familiars gate fallback: servers that don't send the familiar-battle gate flag (older / forked Bloodcraft builds) but do have MaxFamiliarLevel configured no longer keep the tab hidden — familiar data shows up anyway.
• Vanilla menu fixes: 4/4 expertise slots, 4 legacy choices, 4th HUD stat, phantom-row filter.
• Selected-tab glow: the active tab in the second-level rows — Weapon Expertise / Blood Legacies and Professions / Class — gets a bright crimson contour (same idea as the main navigation highlight); toggle TabGlow.
• HUD icon self-healing: the Daily Quest kill icon is restored (EclipsePlus 1.4.0 regression), and the right-side profession icons re-resolve automatically if the game's one-shot sprite scan misses them while world assets are still loading.
• Foreign-server stat display: stat caps sent in a comma-decimal server locale (vanilla Bloodcraft bug, e.g. Russian servers) are repaired client-side — HUD stat lines and Stat Bonuses display correctly there too.
• Prestige Leaderboard fixes: the board-type dropdown lists all 28 PrestigeType entries in enum order, and the rank / name / value columns are pixel-aligned. On servers with the companion EclipseExtras 1.3.2+ every board shows its real top-10 (multi-part wire); with older servers the dropdown is still complete and the boards the server could not fit show as empty.
• Prestige quick-buttons: a small Prestige button at the right of the Stat Bonuses header sends .prestige me <Type> for the weapon you currently wield / the blood you have equipped (<Weapon>Expertise / <Blood>Legacy); the Prestige Leaderboard header gets Experience and ExoForm buttons (.prestige me experience / .prestige me exo). One click = one chat command, with the server applying its usual prestige rules (max expertise etc.). Toggle QuickPrestige.
• Everything is toggleable: the plugin auto-creates BepInEx/config/fix.eclipseplus.ui.cfg on first launch — turn individual features on/off without touching the DLL. Diagnostics are off by default.

Requirements

• BepInExPack V Rising 1.733.2 (BepInEx-BepInExPack_V_Rising-1.733.2, BepInEx 6 IL2CPP / be.733) — declared as a package dependency: a mod manager installs it automatically; manual installs should set up the pack first.
• EclipsePlus — included in this package (EclipsePlus.dll by Dinasor, bundled with permission-free redistribution caveat: original mod, this package ships it pre-patched to report protocol 1.3.9, which is what the Eclipse/Bloodcraft 1.13.22 server stack speaks).
• V Rising matching the EclipsePlus protocol.

Install

With a mod manager (r2modman / Thunderstore Mod Manager) — just enable the mod, or manually: drop both DLLs (Eclipse.dll and EclipsePlus.dll) into BepInEx/plugins.

Upgrading from EclipseFixes: this mod was renamed to Eclipse by FAiNEL (Thunderstore package Eclipse_by_FAiNEL, plugin DLL Eclipse.dll); the config file stays the same (BepInEx/config/fix.eclipseplus.ui.cfg). If you have an older manual install, remove the old EclipseFixes.dll first — two copies of the same plugin will conflict. Обновление с EclipseFixes: мод переименован в Eclipse by FAiNEL (пакет Eclipse_by_FAiNEL, DLL Eclipse.dll), файл конфига не меняется (BepInEx/config/fix.eclipseplus.ui.cfg). При ручной установке сначала удалите старый EclipseFixes.dll — две копии одного плагина конфликтуют.

Important: if you already have a manual EclipsePlus.dll in BepInEx/plugins, remove it when installing via a mod manager — two copies of the same plugin will conflict.

Server requirement: full functionality of this client-side mod is only guaranteed when the server part — the companion EclipseExtras server plugin (1.3.2+) — is installed on the server. The Prestige / Exoform / Familiars / Class tabs and the real top-10 Prestige Leaderboards fetch their data through it: without it those tabs stay empty by design. Everything else (icons, ×1.5 markers, HUD stats, vanilla menu fixes, quick-buttons) works standalone.

Server compatibility

This package speaks the Eclipse/Bloodcraft 1.13.x wire protocol (version 1.3.9 + the 1.13.x MAC key), so stats and menus work on any dedicated server running Bloodcraft 1.13.x with Eclipse enabled — nothing needs to be installed server-side for the base fixes. Known server-side quirks and what this package does about them:

• Comma-decimal server locales (vanilla Bloodcraft bug): Bloodcraft formats stat caps in the server OS locale; on comma-decimal locales (e.g. Russian) every Eclipse client used to fail the config parse and show empty stats. Eclipse by FAiNEL repairs the message client-side - stats now display correctly on such servers.
• Newer Bloodcraft (post-1.13.x): servers with a rotated MAC key / protocol 1.4 do not accept this client - the HUD stays at "Sync: Connecting". Not fixable client-side; update/downgrade the server's Bloodcraft.
• Bloodcraft forks / renumbered stat IDs: a few servers pack the chosen bonus stats with a different stat-ID enumeration than the Eclipse 1.3.x wire this client speaks. The progress message still parses (the Bonuses counter stays correct), but the IDs cannot be resolved to stat names client-side — the HUD stat lines and the green checkboxes stay empty on such servers. Nothing safe can be done client-side without a mapping for that server's build; ask your admin which Bloodcraft build/fork is running.
• 4th expertise/legacy slot: vanilla Bloodcraft sends at most 3 stats per progress message (hardcoded), so on unpatched servers the 4th HUD stat line stays empty by design. All 4 show on servers configured for it (config Expertise/LegacyStatChoices = 4 plus a server-side wire patch that ships 4 stats).
• Prestige / Exoform / Familiars / Class tabs need the companion EclipseExtras server plugin (ask your admin); those tabs stay empty on servers without it — everything else works.

Notes

• Client-side only. The synergy markers use data delivered by the server's Eclipse config message; on servers without the Eclipse setup the markers simply do not appear.
• The plugin never modifies Bloodcraft.dll or any other mod — everything is done via Harmony patches and reflection on the EclipsePlus API.
• The companion server-side plugin (EclipseExtras: extra progress subtypes, familiar-name sanitizers, shift-slot guard) is distributed separately — ask your server admin.

RU (кратко)

Важно (серверное требование): полная функциональность клиентской части — вкладки Prestige/Exoform/Familiars/Class и реальный топ-10 Prestige Leaderboard — гарантируется только при установленной серверной части: серверном плагине EclipseExtras 1.3.2+ на стороне сервера; без него эти вкладки пусты по дизайну, остальные фиксы работают автономно. Клиентский плагин: настоящие иконки в Stat Bonuses, жёлтые «×1.5» по центру строк синергии класса (и 4-й HUD-стат тоже учитывает ×1.5), починка скролла вкладки Familiars (без наложения на вкладки меню), 4/4 слота Expertise, 4-й HUD-стат, самолечение иконок правого HUD (иконка Daily Quest после регрессии EclipsePlus 1.4.0 + иконки профессий при поздней загрузке ассетов), отображение статов на чужих серверах с русской локалью (баг ванильного Bloodcraft чинится на клиенте), исправления Prestige Leaderboard (дропдаун всех 28 типов досок + выравнивание колонок; на серверах с EclipseExtras 1.3.2+ каждая доска показывает реальный топ-10). EclipsePlus.dll включён в пакет (патчен под протокол 1.3.9 — работает с серверами на Bloodcraft 1.13.22; серверы на Bloodcraft новее 1.13.x с другим ключом MAC не принимаются — «Sync: Connecting»). 4-я строка Expertise/Legacy на непатченых серверах пуста по дизайну (ванильный Bloodcraft шлёт максимум 3 стата); вкладка Familiars включается и на старых/чужих сборках без флагового пакета [6], если в конфиге задан MaxFamiliarLevel (фолбэк); вкладки Prestige/Exoform/Familiars/Class требуют серверный плагин EclipseExtras. На отдельных серверах (форки Bloodcraft с другой нумерацией ID статов) выбранные статы приходят в неизвестной клиенту нумерации: счётчик Bonuses верный, но имена не резолвятся — строки HUD и галочки там пусты (без маппинга для сборки сервера чинить на клиенте небезопасно; спросите админа, какая сборка Bloodcraft стоит). Подсветка контура выбранной вкладки (Weapon Expertise / Blood Legacies / Professions / Class — яркий красный контур, фича TabGlow). Быстрые кнопки престижа (фича QuickPrestige): кнопка Prestige справа в шапке Stat Bonuses шлёт .prestige me для текущего оружия/крови (оружие + Expertise, кровь + Legacy), кнопки Experience/ExoForm в шапке Prestige Leaderboard шлют .prestige me experience/.prestige me exo — правила престижа те же, что при ручном вводе команды (например, нужен максимальный уровень). BepInEx 6 IL2CPP. Все фичи переключаются в BepInEx/config/fix.eclipseplus.ui.cfg (создаётся автоматически). Метки «×1.5» появляются только при настроенной Eclipse-инфраструктуре на сервере. Если у вас уже стоит ручной EclipsePlus.dll — уберите его, чтобы не было двух копий.

Support & credits / Поддержка и кредиты

• Created on the V Rising server [PVE] BLOODLUST [RU/EU] | Brutal+ | BloodCraft. Создано на сервере V Rising [PVE] BLOODLUST [RU/EU] | Brutal+ | BloodCraft.
• Development support / Поддержка разработки: DonationAlerts.
• Built on top of the original EclipsePlus client UI mod by DiNaSoR (bundled here pre-patched for protocol 1.3.9 purely for convenience — all credit for EclipsePlus goes to its author) and the Bloodcraft server framework by zfolmt. Пакет основан на оригинальном клиентском UI-моде EclipsePlus авторства DiNaSoR (в пакет входит его pre-patched сборка под протокол 1.3.9 исключительно для удобства — вся заслуга принадлежит автору) и серверном фреймворке Bloodcraft авторства zfolmt.
• Bug reports and ideas are welcome in this mod's Thunderstore comments. Отчёты об ошибках и идеи приветствуются в комментариях мода на Thunderstore.