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

Changelog

[1.6.2]

Bugfixes

• Fixed Bugged Icon Scaling: Actually fixed the issue with ping icons scaling :)

[1.6.1]

Bugfixes

• Tried Fixing Icon Scaling: Tried to resolve issue where ping icons would gradually become larger with each ping

[1.6.0]

New Features

• Spore Shroom Pinging: You can now ping Spore Shroom in the tropics
• Capybara Pinging: You can now ping Capybaras in the desert
• Easter Egg Ping: There's something special that you can ping now :)

Optimization

• Major changes to optimization. There should be no stutter during pinging now.

Bugfixes

• Mirage Luggages now show proper Luggage name (Big Luggage, Explorer's Luggage)

Changelog

[1.5.0]

New Features

• Granular Font Sizes: Individual font size controls for player names, item names, and distance text
• Ping Structure: Cleaner ping structure
• Jellyfish Pinging: You can now ping Jellyfish on the beach

Layout Changes

• New Visual Structure: Distance → Icon → Item Name → Player Name

Optimization

• Improved optimization by using caches and object pooling

[1.4.0]

New Features

• Off Screen Ping: Shows ping icon and distance next to edge of the window when pings are off-screen
• Ping Icon: Ping icon can now be changed in config

Improvements

• New mod image :)
• Improved performance and memory usage optimization
• Code cleanup and refactoring for better stability

[1.3.2]

Bug Fixes

• Fixed bug where items couldn't be pinged when their y position was bigger than 100 (I'm dumb)

Changes

• Updated README.md

[1.3.0]

New Features

• Grouped Pings: Multiple items of the same type now show as single ping (e.g., "4x Coconut" instead of 4 separate pings)
• Smart Item Detection: Added raycast detection for items directly under cursor when pinging
• Player Names: Ping labels now show which player created the ping (configurable)

Configuration

• EnableItemGrouping: Toggle grouped ping functionality (default: true)
• GroupingRadius: Distance for connecting items into groups (default: 1.5)
• ShowPlayerName: Display player names in ping labels (default: true)

[1.2.0]

New Features

• Added support for luggage containers (Luggage and MirageLuggage)
• Enhanced luggage detection with separate detection radius
• Duplicate ping prevention - refreshes existing highlights instead of creating new ones

Configuration

• Added LuggageDetectionRadius configuration option

[1.1.2]

Bug Fixes

• Fixed item pickup ping cleanup issue
• Fixed real-time distance updates
• Changed from timer-based to threshold-based distance updates

[1.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