PingWheel

A team ping system for Valheim, in the style of team games: aim, press a key, and everyone sees what you mean, where it is and how far away it is. Hold the key to open a radial menu and say what you mean: attack, come here, attention or danger.

Everyone who should see pings needs this mod, the same version (0.2.x). Players without it simply won't see anything, and nothing breaks for them. A server does not need it.

Features

• One key, two gestures. Tap to ping whatever is under your crosshair. Hold (0.2 s) for a four-sector wheel, move the mouse to pick a category, release to send. Release in the middle for a plain auto ping, Esc cancels. You can keep walking while the wheel is open; only the camera holds still.
• Knows what you pinged. Creature, resource node, building piece, pickable item, or plain ground, each with its own color. Names come from the game and are translated on each player's own client.
• Enemies only, if you like. By default only hostile creatures count as creature pings (tamed animals, wildlife, players and traders ping as plain ground); each other kind can be switched off too.
• Follows creatures. A pinged creature keeps its ping above its head as it moves, with a portrait (its trophy icon) beside the label.
• Readable at any range. The label (who, what, live distance) is drawn on the HUD, so it stays sharp through fog and at distance, and it isn't drawn over the map, inventory or menus.
• Off-screen arrows on the screen edge for pings out of view or behind you.
• Map pins for every ping, removed when it expires.
• Sounds. A short cue per category, following the game's SFX volume.
• Anti-spam. One live ping per player, 1.5 s cooldown (yours and incoming), with a message if you press too early.
• English and Russian category names, chosen by the game's language.
• Key clash warning. If your ping key is also used by the game itself, the mod says so (once, in game and in the log) instead of silently double-firing.

Controls

The default key is Z (tap to ping, hold for the wheel), which vanilla doesn't use. Change PingKey in BepInEx/config/com.pingwheel.valheim.cfg (or live in the in-game settings menu if you use Configuration Manager, F1). Avoid G, T (emote wheel), R (draw/sheathe weapon) and the middle mouse button (special attack): the game already uses them. If you'd rather use the mouse, Mouse3 (side button 1) is free too. Letter keys are read as Latin key codes, so with a non-Latin layout (e.g. Russian) the key may not react: switch layout or rebind. The mod warns you in game if your key clashes with one the game uses. Gamepad is not supported yet.

Configuration

Everything is in BepInEx/config/com.pingwheel.valheim.cfg and can be edited live with Configuration Manager.

Section	Setting	Default	What it does
General	PingKey	Z	The ping / wheel key
General	MaxDistance	50	How far the aim ray reaches (m)
General	MarkerLifetime	10	How long a ping stays up (s)
General	EnemiesOnly	true	Only hostile creatures count as creature pings
General	DetectResources / DetectPieces / DetectPickables	true	Per-kind switches; a disabled kind pings as plain ground
General	LabelFontSize	20	HUD label size in pixels
General	MarkerIconScale	1	Size of the in-world marker icon
General	ShowAvatars	true	Creature portrait next to the label
General	OffscreenArrows	true	Arrows for off-screen pings
General	MapPins	true	Pin each ping on the map
General	PingCooldown	1.5	Minimum seconds between pings (yours and incoming)
Wheel	WheelEnabled	true	If off, the key just sends an auto ping
Wheel	WheelHoldSeconds	0.2	Hold time before the wheel opens
Wheel	WheelSensitivity	4	Wheel cursor speed
Sound	PingSounds	true	Play a cue when a ping arrives
Sound	PingSoundVolume	0.35	Volume of that cue

Compatibility

• Built for Valheim 1.0.15 with BepInExPack_Valheim 5.4.2350.
• Only two small game patches (registering its network message, and a look-input check while the wheel is open); everything else reads game state and draws on its own, so it's light on conflicts. Tested alongside Cartur's Map Pins, DodgeShortcut, Configuration Manager and others.
• Works on servers and in single player.

Notes

• Ping icons, creature portraits and the label font are taken from the running game at runtime; nothing from the game is bundled or redistributed. Sounds are synthesized in code.
• Inspired by the ping systems of team games, and by earlier Valheim ping mods such as QuickPing. No code from other mods was used.
• Source and issues: none published yet.

Released under the MIT license.

---

PingWheel (на русском)

Командные пинги для Valheim, как в командных играх: прицелился, нажал, и все видят, что ты имеешь в виду, где это и как далеко. Удержание клавиши открывает радиальное меню: атакую, иди сюда, внимание, опасность.

Мод нужен всем, кто должен видеть пинги, одной и той же версии (0.2.x). У тех, у кого его нет, ничего не сломается, они просто не увидят пингов. Серверу мод не нужен.

Что умеет

• Короткое нажатие пингует то, на что ты смотришь; удержание (0,2 с) открывает колесо: двигаешь мышью к сектору, отпускаешь клавишу, и пинг уходит. Отпустишь в центре: уйдёт обычный пинг. Esc отменяет. Ходить при открытом колесе можно, замирает только камера.
• Определяет цель: существо, ресурс, постройка, предмет или земля, у каждого свой цвет. Названия переводятся у каждого игрока на его язык.
• По умолчанию пингуются только враги (ручные животные, дичь, игроки и торговцы считаются просто землёй); остальные виды тоже можно отключить.
• Пинг по существу следует за ним и висит над головой; рядом с подписью аватарка (иконка его трофея).
• Подпись (кто, что, живая дистанция) рисуется поверх картинки, поэтому чёткая в тумане и вдали, и не мешает на карте, в инвентаре и меню.
• Стрелки у края экрана для пингов вне обзора или за спиной, пины на карте, короткий звук для каждой категории.
• Антиспам: один активный пинг на игрока, кулдаун 1,5 с.
• Названия категорий на русском или английском, по языку игры.
• Если выбранная клавиша уже занята самой игрой, мод один раз скажет об этом (в игре и в логе), а не будет молча срабатывать дважды.

Управление. По умолчанию клавиша Z (нажатие - пинг, удержание - колесо), в ванили она свободна. Сменить можно в BepInEx/config/com.pingwheel.valheim.cfg (или через F1, если стоит Configuration Manager). Не ставь G, T (колесо эмоций), R (убрать/достать оружие) и среднюю кнопку мыши (особая атака): они заняты игрой. Если удобнее мышь, свободна боковая кнопка Mouse3. Буквенные клавиши читаются как латинские, так что при нелатинской раскладке (например, русской) клавиша может не реагировать: переключи раскладку или назначь другую. Если клавиша конфликтует с игрой, мод предупредит об этом в игре. Геймпад пока не поддерживается.

Настройки лежат в BepInEx/config/com.pingwheel.valheim.cfg и меняются на лету через Configuration Manager (F1):

Параметр	По умолчанию	Что делает
PingKey	Z	клавиша пинга и колеса
MaxDistance	50	дальность луча прицела, м
MarkerLifetime	10	сколько пинг висит, с
EnemiesOnly	true	только враги считаются пингом по существу
DetectResources, DetectPieces, DetectPickables	true	вкл/выкл ресурсы, постройки, предметы (выключенный вид пингуется как земля)
LabelFontSize	20	размер подписи, пикс.
MarkerIconScale	1	размер значка пинга в мире
ShowAvatars	true	аватарка существа рядом с подписью
OffscreenArrows	true	стрелки для пингов вне обзора
MapPins	true	пин на карте
PingCooldown	1.5	пауза между пингами, с (ваши и входящие)
WheelEnabled	true	если выключить, клавиша сразу шлёт обычный пинг
WheelHoldSeconds	0.2	сколько держать клавишу до появления колеса
WheelSensitivity	4	скорость курсора колеса
PingSounds, PingSoundVolume	true, 0.35	звук пинга и его громкость

Мод рассчитан на Valheim 1.0.15 и BepInExPack_Valheim 5.4.2350, проверен на сервере с двумя игроками. Лицензия MIT.