PingItems

A mod for PEAK that adds visual indicators when pinging near items in the game world.

Features

• Visual Item Indicators: Colored reticles appear above items when pinged nearby
• 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
• Smooth Fade Effects: 5-second visibility with 1-second fade-out
• 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: 5.0 seconds)
• FadeOutDuration: Duration of fade-out animation (default: 1.0 seconds)
• ReticleScale: Size multiplier for reticles (default: 6.0x)
• LabelFontSize: Font size for item labels (default: 32)

Detection Settings

• Radius: Maximum distance to detect items from ping (default: 8.0 units)
• ShowDistance: Whether to show distance information (default: true)
• ShowItemNames: Whether to show localized item names (default: true)

Visual Effects

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

How It Works

1. When you or another player creates a ping, the mod automatically detects nearby items
2. Visual indicators appear above detected items for the configured duration
3. Indicators show the item name, distance, and use the actual pinging player's color (works correctly in multiplayer!)
4. If the same item is pinged again during the display period, the timer resets
5. Indicators smoothly fade out after the display duration

Compatibility

• PEAK Version: Compatible with current PEAK versions
• Multiplayer: Fully supported - all players with the mod will see indicators in the correct pinging player's color
• Performance: Optimized with object pooling and efficient detection algorithms

Troubleshooting

Indicators Not Appearing

• Check that the detection radius is appropriate for your use case
• Ensure items are within the detection range when pinging
• Verify the mod is properly loaded in the BepInEx console

Visual Issues

• Try adjusting the ReticleScale and LabelFontSize settings
• Disable outlines if you experience rendering issues
• Check the BepInEx console for any error messages

Performance Issues

• Reduce the detection radius if you experience lag
• Disable distance calculation or item names if needed

Development

This mod is built using:

• BepInEx 5.x
• Harmony for runtime patching
• Unity UI system for visual elements

Building from Source

1. Clone the repository
2. Ensure you have the PEAK game references
3. Build using .NET Standard 2.1
4. The output DLL goes in BepInEx/plugins

Support

For issues, suggestions, or contributions:

• Check the configuration options first
• Review the BepInEx console for error messages
• Ensure you're using compatible versions

License

This mod is released under the MIT License. See LICENSE file for details.

Changelog

Version 1.0.0

• Initial release
• Basic ping detection and highlighting
• Player color integration
• Configurable settings
• Fade-out effects
• Localized item names

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