HoverLoot — public beta 1.6.0

Floating item drops, soft coloured glow, and an in-game settings panel for Valheim.

Unofficial, free community mod. This build has been manually checked by its author on an Apple Silicon Mac. Windows, Linux, multiplayer, clean mod-manager installation, and broad mod compatibility have not yet been independently tested. The settings panel currently has Russian labels.

Установка на Windows и Mac — пошагово

HoverLoot бесплатный. Нужны Steam-версия Valheim и загрузчик BepInEx 5. Автор проверил мод на Mac с Apple Silicon. Windows, Intel Mac, мультиплеер и чистая установка через менеджер пока требуют тестирования. Инструкция для Windows описывает стандартную установку, а не подтверждённый результат теста этой сборки.

Windows — через менеджер модов

1. Закрой Valheim, оставь Steam запущенным.
2. Установи Thunderstore Mod Manager с официального сайта.
3. Выбери Valheim и создай отдельный профиль, например HoverLoot Test.
4. В поиске модов найди HoverLoot от foizebee и установи версию 1.6.0 вместе с зависимостью BepInExPack_Valheim от denikson. Также можно нажать Install with App на странице HoverLoot и подтвердить открытие установленного менеджера.
5. Запусти игру кнопкой запуска с модами в менеджере. Обычный запуск через Steam может использовать другой набор модов.
6. Зайди в мир, выброси предмет из инвентаря и дождись его приземления. Открой настройки клавишей F6 или Alt+H.

Windows — вручную

1. В Steam: Библиотека → Valheim → шестерёнка → Управление → Просмотреть локальные файлы. Это папка с valheim.exe; путь может отличаться на разных компьютерах.
2. Скачай BepInExPack_Valheim кнопкой Download. Распакуй архив отдельно, затем перенеси содержимое папки BepInExPack_Valheim в папку игры. Следуй актуальной инструкции загрузчика на его странице. Если BepInEx 5 уже настроен и работает, второй экземпляр не нужен.
3. Скачай HoverLoot кнопкой Download на странице мода. Из архива перенеси папку HoverLoot из BepInEx/plugins/ в папку игры BepInEx/plugins/.
4. Итоговый путь должен быть Valheim/BepInEx/plugins/HoverLoot/HoverLoot.dll. Не должно получиться BepInEx/BepInEx/ или двух копий DLL.
5. Запусти игру со Steam и проверь настройки F6 / Alt+H.

Mac — ручная установка для нативной игры

На Mac используй загрузчик для macOS, а не Windows-файлы. Ниже — способ с официальным upstream BepInEx, который использовался при авторском тестировании.

1. Закрой Valheim. В Steam открой Valheim → шестерёнка → Управление → Просмотреть локальные файлы. Найди папку с valheim.app.
2. На официальной странице BepInEx 5.4.23.6 раскрой Assets и скачай архив macOS universal. Не выбирай Windows/Linux или BepInEx 6.
3. Распакуй загрузчик в папку с valheim.app. Рядом должны лежать run_bepinex.sh и папка BepInEx. Если этот загрузчик уже работает, повторная установка не нужна.
4. Скачай HoverLoot кнопкой Download. Перенеси папку HoverLoot из BepInEx/plugins/ архива в BepInEx/plugins/ установленного загрузчика. Итог: BepInEx/plugins/HoverLoot/HoverLoot.dll.
5. Оставь Steam запущенным. Открой Терминал, набери cd с пробелом, перетащи в окно папку игры из Finder и нажми Enter. Так используется твой настоящий путь, даже если библиотека Steam на другом диске.
6. В этой папке выполни:

chmod u+x ./run_bepinex.sh
SteamAppId=892970 SteamGameId=892970 ./run_bepinex.sh ./valheim.app/Contents/MacOS/Valheim

1. Дождись запуска, зайди в мир. Настройки: Option+H или fn+F6. При следующих запусках используй вторую команду из папки игры; обычный запуск Steam сам по себе не включает этот способ загрузки.

Стандартная папка Steam на Mac часто находится здесь: ~/Library/Application Support/Steam/steamapps/common/Valheim. Если игра установлена иначе, используй путь из Steam. В Finder открыть путь можно через Cmd+Shift+G. Если macOS блокирует загрузчик, проверь источник и обратись к документации BepInEx; инструкция не требует отключать защиту системы.

Настройки и проверка работы

• Закрой консоль, инвентарь и меню игры перед открытием панели.
• F6 / Alt+H — панель; на Mac Option+H / fn+F6.
• F7 / Alt+J, на Mac Option+J — временно скрыть или вернуть эффекты.
• Меняй высоту, вращение, подсветку и фильтры, затем нажимай «Применить». Мир при открытой панели не ставится на паузу.
• Каталог предметов служит для фильтрации эффектов, а не для выдачи предметов.
• Настройки сохраняются в BepInEx/config/local.hoverloot.cfg внутри выбранной установки или профиля.

Если мод не работает

• Проверь, что запускаешь именно игру с BepInEx и нужный профиль менеджера.
• Проверь путь DLL и отсутствие её дубликатов.
• Если эффекты скрыты, нажми F7 / Option+J; проверь глобальные переключатели, категорию предмета и список исключений в панели.
• Открой BepInEx/LogOutput.log и найди HoverLoot 1.6.0. Если файла нет, сначала проверь установку и запуск BepInEx. При сообщении об ошибке сохрани её текст вместе с версией игры и системой.
• Для обновления закрой игру и замени только DLL мода, предварительно сохранив конфиг. Для удаления убери папку BepInEx/plugins/HoverLoot или отключи мод в менеджере.

Features

• Hovering and rotating dropped-item models.
• Soft halo that uses alpha-aware masks for cutout textures.
• In-game controls for height, rotation, glow radius and strength.
• Glow always, nearby, or only when aiming at an item.
• Native particle palette, a single colour, or category colours.
• Six item categories, per-category effect toggles, and individual prefab exclusions.
• Item search and a clearly labelled icon preview.
• Built-in presets and temporary effect hiding.
• Interaction boxes that follow the displayed model.
• Vanilla particles controlled separately.

The glow colours use stable per-prefab samples from the game's original particle palette. This is not a vanilla rarity classification or EpicLoot integration.

Requirements and compatibility

• Valheim. The author-tested game uses Unity 6000.0.75f1.
• BepInEx 5.4.23.6. The Thunderstore dependency is denikson-BepInExPack_Valheim-5.4.2360.
• A game build containing the current Valheim/Unity APIs. Compatibility with older Valheim releases is not established.

The author's Mac test used the official upstream macOS universal BepInEx 5.4.23.6 loader, not a clean installation of the community pack. A successful upstream-loader test does not verify every manager/pack installation flow. See the community pack's current platform instructions before choosing an installation method.

Install

Close Valheim before installing or updating. Keep only one copy of HoverLoot.dll enabled.

Mod manager

For a supported, correctly configured BepInEx mod-manager setup, install the package and its dependency, then launch the modded profile. The package places the plugin in BepInEx/plugins/HoverLoot/. Windows/Linux and automated manager flows still need beta testing.

Manual installation

1. Install the appropriate BepInEx loader for your platform from its official source.
2. Extract this package's BepInEx/plugins/HoverLoot/ folder into the corresponding BepInEx/plugins/ location in your game setup.
3. Start Valheim through that loader and enter a world.
4. Close the console, inventory, store, and game menu before opening the settings panel.

For the author's upstream macOS-loader setup: open the Valheim installation folder through Steam's Browse local files action. With Steam running, launch run_bepinex.sh with ./valheim.app/Contents/MacOS/Valheim as its game argument. Use your own installation path; this package does not include a personal launcher or the loader itself.

Loader references:

• Valheim community BepInEx pack and platform instructions
• Official upstream macOS universal release 5.4.23.6

Controls

The panel blocks gameplay input and camera movement while open. The world is not paused.

• Внешний вид: appearance and effect toggles.
• Фильтры: category settings, distance, and glow-item limit.
• Предметы: search and exclusions.
• План мода: planned work, not extra released functionality.
• Применить: apply and save changes.
• Отменить: discard unsaved edits and close.
• Сбросить изменения: reload the currently saved values.

Presets change the draft first; use Применить to change the world. The right-hand preview is an icon illustration, not a live 3D render.

Configuration

The first run creates BepInEx/config/local.hoverloot.cfg. The existing plugin GUID is retained for compatibility with local test versions.

Defaults include a 0.675 m lift, 45 degrees/second rotation, a 2.2 px halo radius, and a glow limit of 48 nearby items. Colours accept #RRGGBB. Global switches and category switches both apply; excluded items return to vanilla presentation/behaviour.

Known limitations

• Multiplayer and mod combinations have not been validated. The mod locally freezes settled item rigidbodies and replaces interaction colliders while effects are active; do not assume its behaviour is purely visual or network-safe.
• The halo uses additional mesh draws and stencil masking. Many nearby drops can cost rendering time; reduce glow distance and item limit if needed.
• Unusual transparent shaders, animated items, texture arrays and custom UV systems can need special support.
• Interaction uses mesh bounding boxes; empty spaces inside complex shapes can still be targetable.
• No promise is made about achievements, compatibility with cheats, or compatibility with future game updates.
• The catalogue is for filtering, not spawning items. This is a local mod-settings panel, not server administration.

Update, remove, and report issues

Before updating, keep a copy of your configuration. Replace the DLL while the game is closed. To remove the mod, close the game and remove its plugin folder; configuration may be retained for later use.

For a report, include mod/game versions, operating system and architecture, reproduction steps, the item name, a screenshot if useful, and relevant error lines. Review logs before sharing them publicly. Until a dedicated issue tracker is linked, use the package discussion/feedback feature where available.

Support

HoverLoot and its updates are free. Optional support and public development updates: Boosty / Foize Bees.

Code was developed with AI assistance. The project avatar is AI-generated; development-post covers are AI-edited screenshot artwork labelled as early prototypes. Select the AI Generated package category where available.

Кратко по-русски

Бесплатный неофициальный мод: парящий дроп, мягкая подсветка и настройки в игре. Автор проверил текущую сборку на Mac с Apple Silicon; остальные платформы, мультиплеер и чистая установка через менеджер пока не подтверждены.

Панель: F6 / fn+F6 / Option+H. Скрыть эффекты: F7 / Option+J. Изменения применяются кнопкой «Применить». Для установки и обновления закрывай игру; DLL должна быть только в одном экземпляре.

Changelog

1.6.0 — first public-beta candidate

• Added the in-game settings panel, presets, and apply/cancel controls.
• Added independent hover, rotation, glow, and original-particle controls.
• Added six category filters, per-category colours, and individual item exclusions.
• Added glow visibility modes, distance settings, and nearest-item limits.
• Added temporary effect hiding.
• Retained floating drops, alpha-aware soft glow, and model-aligned interaction.
• Author reported a successful local Mac check. Other platforms and multiplayer remain unverified.

Earlier 1.x numbers were local development iterations, not established public releases.