PingItems

A mod for PEAK that allows you to ping items.

Content Display: Shows item name, distance, and uses proper localization

Real-time Distance Updates: Distance updates smoothly as you move around

Features

• Visual Item Indicators: Colored reticles appear above items and luggage when pinged nearby
• Enhanced Luggage Detection: Luggage objects have larger detection radius for easier pinging
• Player Color Integration: Indicators use the pinging player's color
• Localized Item Names: Shows proper item names in your current language
• Distance Information: Displays distance to items
• Configurable Settings: Customize detection radius, visual effects, and more

Installation

1. Ensure you have BepInEx installed for PEAK
2. Download the latest release of PingItems
3. Extract PingItems.dll to your BepInEx/plugins folder
4. Launch PEAK

Configuration

The mod creates a configuration file at BepInEx/config/com.memiczny.peak.pingitems.cfg with the following options:

Display Settings

• Duration: How long indicators remain visible (default: 10.0 seconds)
• FadeOutDuration: Duration of fade-out animation (default: 2.0 seconds)
• ReticleScale: Size multiplier for reticles (default: 5.0x)
• LabelFontSize: Font size for item labels (default: 32)
• ShowDistance: Whether to show distance information (default: true)
• ShowItemNames: Whether to show localized item names (default: true)

Detection Settings

• DetectionRadius: Maximum distance to detect items from ping (default: 1.2 units)
• LuggageDetectionRadius: Maximum distance to detect luggage from ping (default: 2.0 units, larger than items)
• DistanceUpdateThreshold: Distance change threshold for updates (default: 0.1 meters, lower = more sensitive)

Visual Effects

• EnableOutlines: Enable outline effects on text and reticles (default: true)
• OutlineWidth: Width of text outline effect (default: 0.065)

How It Works

1. Ping Detection: When you or another player creates a ping, the mod automatically detects nearby items
2. Visual Indicators: Indicators appear above detected items for the configured duration
3. Player Colors: Indicators show the actual pinging player's color (works correctly in multiplayer!)
4. Content Display: Shows item name, distance, and uses proper localization
5. Ping Cleanup: Pings automatically disappear instantly when items are picked up, consumed, or destroyed

Multiplayer Support

This mod is fully multiplayer compatible.

Supported Objects

• Items: All in-world items including weapons, food, consumables, etc.
• Luggage: Luggage containers when they are closed (also works with mirage luggage)

Version History

v1.2.0 (Latest)

• ✨ NEW: Added support for luggage containers (Luggage and MirageLuggage)
• ✨ NEW: Enhanced luggage detection with separate detection radius
• 🔧 IMPROVED: Duplicate ping prevention - refreshes existing highlights instead of creating new ones
• 📖 CONFIG: Added LuggageDetectionRadius configuration option
• 🧹 CLEANED: Cleaned some code

v1.1.2

• 🐛 FIXED: Resolved item pickup ping cleanup issue
• 🐛 FIXED: Real-time distance updates now work correctly
• 🔧 IMPROVED: Changed from timer-based to threshold-based distance updates

v1.0.0

• 🎉 INITIAL RELEASE: Basic item ping highlighting functionality
• ✨ Circle indicator system with player colors
• ✨ Localized item names and distance display
• ✨ Multiplayer support with proper color synchronization
• ✨ Configurable detection radius and visual settings