You are viewing a potentially older version of this package. View all versions.
UncleBugDev-PingMaker-1.2.4 icon

PingMaker

Multiplayer 3D world ping system for Valheim with personal player color palette, creature silhouette highlighting, and distance indicators.

Date uploaded 7 hours ago
Version 1.2.4
Download link UncleBugDev-PingMaker-1.2.4.zip
Downloads 18
Dependency string UncleBugDev-PingMaker-1.2.4

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2202 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2202

README

PingMaker

GitHub Release License: MIT Thunderstore

A modern, highly customizable 3D world ping, tactical targeting, and multiplayer synchronization mod for Valheim. Communicate points of interest, hostiles, and fellow vikings instantly in the 3D world and on the map without losing immersion.

GitHub Repository: https://github.com/UncleBugDev/PingMaker


✨ Features

  • Personal Viking Color Palette & Color Picker Studio:
    • Choose from 8 vibrant quick-select preset colors (Yellow, Orange, Red, Pink, Purple, Blue, Cyan, Lime) OR create any custom color with the built-in Interactive Color Picker & HEX Studio (supporting all 16.7 million 24-bit/32-bit RGB colors).
    • Type or paste any #HEX color code with one-click clipboard copy/paste, or adjust live Hue (0°–360°), Saturation, and Brightness sliders.
    • Duplicate Color Prevention: Automatically checks connected teammates to prevent overlapping colors — if a teammate has already picked a color, the mod notifies you and reserves that color for them, ensuring every clan member is uniquely identifiable on the battlefield and map.
    • Every ping, marker, distance counter, creature lock-on, map tracker, and nameplate you create will be in YOUR distinctive color!
  • Tactical Lock-On Reticle (↘ ⭕):
    • Aiming at hostile creatures or beasts dynamically displays an animated tactical lock-on ring with a diagonal pointing arrow (↘ ⭕ by default, or top arrow) and the creature's name with star rating (★).
    • Friendly players are strictly filtered out so targeting never locks onto allies or distracts during co-op combat.
    • 3 selectable operational modes: Both on hover and on ping (Default), Only on ping, or Only on hover.
  • Laser Designator 3D Markers:
    • World and creature pings render as a sleek laser designator — a focused bright laser point in the center with a softly breathing ambient laser haze bloom.
    • Obstructive skull icons have been completely removed; creatures remain 100% visible with a clean transparent lock-on circle.
  • Soft Creature Contour Outline:
    • Marking a monster applies a subtle, non-blinding contour emission (0.28x) so monster fur, scales, and details remain crisp and clear in the dark.
    • Automatically un-highlights and removes the 3D marker the instant the monster dies.
  • Colored Player Overhead Nameplates:
    • 3D floating player names in the world and center crosshair hover names are colored according to each player's chosen personal color instead of the standard yellow.
  • Real-Time Player Directional Map Trackers:
    • Player pins on the minimap and large world map rotate in real-time according to their view/movement direction and glow in each player's personal color.
  • True-Color Minimap Radar Pings:
    • Custom pure white procedural radar ping sprite eliminates the game's default cyan texture color-blending bug — pink stays vibrant pink, yellow stays bright yellow, and orange stays orange.
  • Procedural Sound Engine & Audio Presets:
    • Built-in real-time procedural audio synthesis generates crystal-clear audio clips directly in memory without requiring external .wav files (zero asset loading overhead, keeping DLL size tiny).
    • 5 switchable sound styles:
      • 🔘 Мягкий щелчок (Soft Click) (Default): 45ms gentle tactical pulse (420 Hz -> 260 Hz), never causes ear fatigue during active combat.
      • 🔔 Кристальный звон (Classic Chime): 120ms bright dual-sine chime (988 Hz + 1318 Hz).
      • 📯 Рог викингов (Nordic Horn): 220ms resonant war horn with deep Nordic harmonics (165 Hz + 330/495 Hz).
      • 🪵 Деревянный стук (Wood Knock): 60ms acoustic percussion of an axe/shield strike.
      • 🔇 Без звука (Mute): Silent pings.
    • Instant Audio Preview: Click the ▶ button in the GUI to audition any preset immediately.
    • Independent Volume Sliders: Separate controls for your own pings (0–100%) and other players' pings (0–100%).
    • Mute Other Players' Audio: One-click toggle to completely mute audio from other players' pings while keeping their 3D markers and map pins visible.
    • Anti-Spam Throttling: Built-in 90ms audio cooldown prevents rapid ear-splitting ping cascades.
  • Viking-Themed In-Game GUI & Native ESC Menu Button:
    • Openable at any time by pressing ' (Quote / Russian э) OR by clicking the new native "ᚱ PingMaker" button in the in-game ESC (Pause) menu!
    • Authentic Nordic oak plaque styling with Valheim gold borders, runic banners, and native game font.
    • Interactive one-click key rebinding supporting keyboard and mouse buttons (e.g. Mouse 4, Mouse 3, etc.).
    • Instant personal color picker with live preview.
    • Automatic mouse cursor release (no need to open Esc menu first).
  • Pixel-Perfect Screen Scaling & Crosshair Aiming:
    • Full support for all resolutions (1080p, 1440p, 4K, 720p), ultrawide monitors (21:9, 32:9), 16:10 aspect ratios, and custom Valheim GUI scales.
    • Pings and lock-on reticles calculate with mathematical precision through the exact center of the player's crosshair, preventing off-screen drift and incorrect target snapping.
  • Accidental Switch Prevention:
    • AlternativePingKey default set to None to prevent conflicts with vanilla emote keys (T / G).
    • Radial menu on hold is disabled by default (can be toggled on in settings), eliminating accidental color switches during battle.
  • Zero-Lag Multiplayer:
    • Synchronized across clients via Valheim's ZRoutedRpc with zero latency for the pinger.

🎮 Controls

Action Default Input Description
Quick Ping Mouse 4 (or rebindable in GUI) Places a 3D laser ping at crosshair or locks onto a targeted creature
Open Settings GUI ' (Quote / Russian э) or ESC Menu Opens the authentic Viking GUI to pick colors, rebind keys, and adjust styles (also via "ᚱ PingMaker" button in ESC menu)
Close Settings GUI Esc or ' Closes and immediately persists all changes

Keys can be re-bound dynamically in-game via the Settings GUI or in BepInEx/config/com.author.pingmaker.cfg.


🎨 Personal Color Palette

Choose from 8 high-visibility vibrant colors:

  • 🟡 Жёлтый (Yellow)
  • 🟠 Оранжевый (Orange)
  • 🔴 Красный (Red)
  • 🌸 Розовый (Neon Pink)
  • 🟣 Фиолетовый (Royal Purple)
  • 🔵 Синий (Electric Blue)
  • 🔷 Голубой (Cyan)
  • 🟢 Лайм (Neon Lime)

⚙️ Configuration

Settings are saved in BepInEx/config/com.author.pingmaker.cfg and can be adjusted in-game via the GUI (') or Configuration Manager (F1):

  • PingKey: Primary key for placing pings (default: Mouse4).
  • AlternativePingKey: Optional secondary ping key (default: None).
  • SettingsKey: Hotkey to toggle the in-game settings panel (default: Quote).
  • EnableRadialColorMenu: Whether holding the ping key opens the radial color menu (default: false).
  • ActiveColorIndex: Your currently selected personal color index (0–7).
  • TargetReticleMode: Reticle operational mode (0 = Both hover and ping, 1 = On-ping only, 2 = Hover only).
  • ReticleArrowStyle: Arrow style for target lock-on (0 = Diagonal ↘ ⭕, 1 = Top ↓ ⭕).
  • PingDuration: Lifetime of 3D markers in seconds (default: 20s).
  • CreatureHighlightDuration: Duration of monster contour highlight (default: 18s).
  • MaxPingDistance: Maximum raycast distance in meters (default: 1000m).
  • ShowDistance: Display distance counter [Xm] beneath markers (default: true).
  • ShowOffscreenArrow: Show directional edge arrows when marker is off-screen (default: true).
  • SyncToMinimap: Mirror pings onto minimap and world map (default: true).
  • ColorizeMapPlayers: Colorize player direction arrows on maps (default: true).
  • PingSoundPreset: Ping sound effect preset index (0 = Soft Click, 1 = Classic Chime, 2 = Nordic Horn, 3 = Wood Knock, 4 = Mute).
  • MyPingVolume: Volume for your own pings (default: 0.8 / 80%).
  • OthersPingVolume: Volume for other players' pings in multiplayer (default: 0.5 / 50%).
  • MuteOtherPlayersPings: Completely silence audio notifications from other players (default: false).
  • AudioVolume: Master volume multiplier for all mod sound effects (default: 1.0 / 100%).

📦 Installation

Thunderstore / r2modman (Recommended)

  1. Install r2modman or Thunderstore Mod Manager.
  2. Search for PingMaker and click install.
  3. Launch game via Mod Manager.

Manual

  1. Ensure BepInExPack Valheim is installed.
  2. Download the latest PingMaker_v1.2.0.zip from GitHub Releases.
  3. Extract PingMaker.dll into Valheim/BepInEx/plugins/UncleBugDev-PingMaker/.
  4. Launch Valheim.

🤝 Contributing & Support

  • Found a bug or have a suggestion? Open an issue on GitHub Issues.
  • Pull requests are welcome!

CHANGELOG

Changelog

All notable changes to PingMaker will be documented in this file.

[1.2.4] - 2026-11-15

  • Interactive Color Picker & HEX Code Tool:
    • Added a full custom color creation studio in the Viking GUI settings. Players are no longer limited to 8 preset colors — choose from all 16.7 million 24-bit/32-bit RGB colors.
    • HEX Code Input: Direct text input field for typing or pasting HEX codes (e.g. #FF0055, #00FFCC, #FFAA00) with instant validation, live preview, and one-click "Вставить" / "Копировать" clipboard buttons.
    • HSV Spectrum Sliders: Interactive Hue (0°–360°), Saturation (0%–100%), and Brightness/Value (20%–100%) sliders with real-time preview.
    • Dynamic "Свой цвет" Slot: Added a dedicated 9th custom color button in the palette grid displaying the active HEX code.
  • Duplicate Color Prevention System:
    • The mod now prevents multiple players on the same server from using the same or visually indistinguishable colors (Euclidean RGB distance check).
    • When another player has already claimed a color preset, the button displays a red [Занят: Ник] badge.
    • Attempting to pick an occupied color displays an on-screen warning: "К сожалению, данный цвет уже выбран игроком [Ник]! Пожалуйста, выберите другой цвет", keeping tactical player identification clear and unambiguous.
  • Scrollable Window Layout:
    • Added a smooth scrollview to the Settings GUI, ensuring all settings, color tools, audio sliders, and visual options fit comfortably on any resolution (1080p, 1440p, 4K, 720p).
    • Pinned the "СОХРАНИТЬ И ЗАКРЫТЬ" button permanently to the bottom of the window.
  • Custom Color Network Synchronization:
    • Added RPC_SYNC_HEX and ZDO string replication ("PingMaker_ColorHex") to broadcast exact custom HEX colors across clients and dedicated servers.

[1.2.3] - 2026-11-15

  • Multiplayer Player Color Sync & Cache Poisoning Overhaul:
    • Replaced non-deterministic string.GetHashCode() fallback (which had randomized hash seeds per process in .NET Core, causing different players to see different random colors for the same teammate) with a deterministic cross-platform FNV-1a hash algorithm.
    • Fixed fallback cache poisoning: unverified default colors are no longer permanently written to PlayerColorsMap, allowing remote players' actual colors to seamlessly apply as soon as their ZDO or RPC packet arrives.
    • Added automatic ZDO inspection via ZNet.GetPlayerList() and ZDOMan to retrieve players' colors across the entire map, even when players are outside local GameObject loading distance.
    • Added automatic broadcast on local player spawn and respawn via Player.OnSpawned, and whenever a new peer connects via ZNet.RPC_PeerInfo.
    • Added background periodic heartbeat (every 6 seconds) to ensure ZDO data integrity and request missing colors from connected peers.
    • Added automatic color synchronization upon changing ActiveColorIndex via BepInEx config manager (SettingChanged).
  • Radial Menu Accidental Switch Fix:
    • Added minimum cursor displacement guard (32px from opening position) to prevent accidental color switching on slight mouse shifts or crosshair offsets.
    • Linked radial menu confirmation directly to NetworkSync.BroadcastLocalPlayerColor() and ModConfig.Save().
  • New Official Meme Icon:
    • Updated mod icon with high-visibility 256x256 meme artwork: Viking Soyjaks pointing at a laser designator red dot ping on a Valheim rock with red Paint circles and arrows.

[1.2.2] - 2026-11-15

  • Procedural Sound Engine & Audio Presets:
    • Added a lightweight procedural audio engine with real-time in-memory AudioClip synthesis (zero external audio assets required, preventing missing file errors and keeping mod footprint minimal).
    • 5 sound presets selectable directly in the Viking GUI:
      • 0: Soft Click (Default) — Ultra-gentle 45ms tactical click (420 Hz -> 260 Hz sine decay). Ideal for frequent pings without fatigue.
      • 1: Classic Chime — Clean crystalline dual-tone chime (988 Hz + 1318 Hz).
      • 2: Nordic Horn — Atmospheric 220ms Viking horn with resonant harmonics (165 Hz fundamental, 330/495 Hz overtone body).
      • 3: Wood Knock — Crisp 60ms acoustic percussion (wooden axe/shield thump).
      • 4: Mute (None) — Completely silent pings.
    • Added instant audio preview button (▶) in the Settings GUI to audition presets before battle.
    • Integrated 90ms anti-spam throttling for sound playback.
  • Independent Audio Volumes & Mute for Other Players:
    • Added separate volume sliders for My Pings (0% - 100%, default 80%) and Friends' Pings (0% - 100%, default 50%), scaled by master mod volume.
    • Added a one-click toggle: "Полностью отключить звуки пингов от других игроков" (Mute sounds from other players). Visual 3D markers and map pins remain visible while disabling remote sound signals.
  • Enhanced Settings GUI Layout:
    • Expanded Settings GUI height with adaptive screen bounds (Mathf.Min(820f, Screen.height - 40f)) to accommodate the new Sound & Volume control panel seamlessly.

[1.2.1] - 2026-11-15

  • Fixed Crosshair Aiming & Resolution Scaling:
    • Implemented exact screen-space crosshair raycasting (cam.ScreenPointToRay(crosshairPos)), ensuring pings land precisely where the player's crosshair points regardless of display resolution, aspect ratio (16:9, 16:10, 21:9 Ultrawide, 32:9 Super-Ultrawide), or Valheim GUI scaling settings.
    • Replaced raw screen pixel positioning with RectTransformUtility.ScreenPointToLocalPointInRectangle on the UI canvas, eliminating reticle and 3D marker drift/offset on 1440p, 4K, 720p, and custom DPI screens.
    • Fixed creature lock-on jumping/snapping to distant off-screen or off-crosshair creatures: direct raycast has top priority, and proximity search is strictly bounded to a 38-pixel screen radius with full line-of-sight verification (preventing targeting through rocks, trees, or walls).
  • Added Native ESC (Pause) Menu Button:
    • Added a styled "ᚱ PingMaker" button directly inside the Valheim pause/ESC menu next to the "Settings" button. Players can now open PingMaker configuration seamlessly both via the ESC menu and by pressing ' / э.
    • Automatically matches native Valheim button textures, hover animations, click sounds, and vertical layout grouping.

[1.2.0] - 2026-11-14

  • Added tactical lock-on reticle for creatures (circle + diagonal pointing arrow ↘ ⭕) with 3 selectable operational modes.
  • Added laser designator 3D markers with soft pulsing laser haze bloom.
  • Removed opaque skull icon from creature pings, keeping creatures fully visible.
  • Added colored player overhead 3D nameplates and center crosshair hover names.
  • Added true-color procedural radar ping sprite for minimap (eliminating blue tint color distortion).
  • Excluded friendly players from creature lock-on targeting.
  • Disabled radial color menu on hold by default and unbound secondary G key to prevent accidental color changes.
  • Fixed Character.GetHeadPoint() crash on creatures without head bones (e.g. Greydwarf Shaman).

[1.1.0] - 2026-11-12

  • Added Viking-themed in-game GUI with Valheim gold styling and rune ornaments.
  • Added custom colored player direction arrows on map and minimap (real-time heading tracking).
  • Added multiplayer personal color sync across network via RPC.
  • Fixed cursor unlock on menu open (no longer requires pressing ESC).
  • Auto-cleaning of expired minimap pins.

[1.0.0] - Initial Release

  • Initial implementation of the contextual 3D ping system.
  • Added creature highlighting with threat color indicators.
  • Added 3D world space distance and directional HUD markers.
  • Added minimap and large map pin integration.
  • Integrated ZRoutedRpc multiplayer networking for instant synchronization between players.
  • Added radial ping wheel for categorized pings.
  • Added BepInEx configuration and ConfigurationManager support.