Valheim
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
Downloads
68
Size
160KB
ADDatHost Valheim hosting
30% off

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!
Thunderstore development is made possible with ads. Please consider making an exception to your adblock.