PingIt

Spatial ping system for Hytale. Communicate with your team without typing or talking. Point, click, and let the ping do the talking.

What It Does

Equip the Ping Device, press a key, and place a colored marker in the world. Teammates see a beam of light rising from the ping location, hear spatial audio cues, and get HUD readouts showing distance and direction. Works on blocks, terrain, and entities.

Ping Types

Controls

Quick-Ping

Press your ping key (default: Middle Click) to instantly place your default ping type.

Ping Wheel

Press your wheel key (default: E) to open a radial menu. Select a ping type, release, and the ping is placed at your crosshair.

Quick-Bindings

Bind specific ping types directly to keys. Example: Mouse1 always pings Danger, Q always pings Attack. Configure via the GUI (/pingit binds) or commands (/pingit set danger=mouse1).

Independent Pings

Fire a Beacon or Marker ping without holding the Ping Device. Toggle with /pingit b (Beacon) or /pingit m (Marker). Off by default — opt in when you want quick pings without switching items. Disabling clears your active ping. Change the key with /pingit b key <key> (default: Middle Click).

Offhand Support

Q, E, and Middle Click work with the Ping Device in your offhand slot. Other keys require the Ping Device in your main hand.

Visual Effects

• Colored beam rises from every ping location (except Marker). Visible from 1000+ blocks away. Beam thickness scales with distance so it stays visible at range.
• Billboard labels float above beam pings for Danger, Attack, and Move Here — a PNG sprite showing the ping type. Labels fade in on spawn and fade out on expire. Can be toggled on/off per-player.
• Marker pulse for Marker-type pings (green glow, no beam).
• Termination burst when a ping expires or is cleared.
• Proximity clear ring when someone walks to a ping.
• Compass markers appear on the world map for all active pings.

Sound Design

Every action has spatial 3D audio:

• Portal Burst on ping creation
• Beam hum while a beam ping is active
• Marker ambience while a Marker ping is active
• Termination burst when a ping expires
• Cancel chime on manual cancel
• Proximity whoosh when walking into a ping

All sounds respect per-player volume settings and mute lists. Server admins can tune individual sound volumes by editing the SoundEvent JSON files in Mods/PingIt/Server/Audio/SoundEvents/SFX/PingIt/.

HUD

Range Display

Shows the distance, direction, and type of your tracked ping. Updates in real-time as you move. Auto-hides after 5 seconds of inactivity to stay out of the way.

Nearby Pings (Optional)

Enable toast notifications for pings placed near you by other players. Shows pinger name, ping type, distance, and direction.

Focus Tracking

Track your own ping or switch to a teammate's:

• /pingit focus me - Track your ping
• /pingit focus <player> - Track a teammate's ping
• /pingit focus last - Toggle between current and previous target

Per-Player Settings

Every setting is per-player and persists across sessions:

• Volume - Scale all PingIt sounds from 0 (silent) to 3 (loud)
• Mute players - Silence specific players' ping audio, or mute yourself
• Hide players - Completely hide pings (visual + audio) from specific players or all
• Key bindings - Fully customizable ping and wheel keys
• Quick-bindings - Map specific ping types to specific keys
• Slot mode - SINGLE (one ping at a time) or MULTI (one beacon + one marker + one special active simultaneously)
• Labels - Show or hide the billboard labels above beam pings
• Proximity clear mode - Only you clear your pings, or anyone can
• Default ping mode - Quick-ping places Beacon or Marker
• Sticky mode - One-shot selections or repeat last selection
• Wheel position - Drag the ping wheel anywhere on screen
• Notifications - Toggle ping alerts on/off

Commands

Basics

Sound & Muting

Visibility

Key Bindings

Modes

Nearby Pings

Independent Pings

Server Configuration

Edit config.json in the plugin data folder:

Sound Volume Tuning

Each sound has its own JSON file in Mods/PingIt/Server/Audio/SoundEvents/SFX/PingIt/. Edit the Volume field to adjust. Higher = louder, negative = quieter.

Compatibility

• Works standalone or with MultipleHUD (auto-detected)
• Uses Hytale's built-in particle, audio, and UI systems
• All settings persist per-player across server restarts

API — Plugin Integration

Other plugins can register visibility filters to control who sees/hears pings. Useful for party or guild systems that want pings restricted to group members.

Your build.gradle.kts:

dependencies {
    compileOnly(files("libs/PingIt-2.0.2.jar"))
}

Your manifest.json:

"OptionalDependencies": { "BeyondSmash:PingIt": "*" }

Usage:

import com.pingit.api.PingItAPI;
import com.pingit.api.PingFilter;

// Register a filter — pings visible only to party members
PingItAPI.registerFilter((pingerUuid, viewerUuid, pingTypeName) -> {
    return myPartySystem.areInSameParty(pingerUuid, viewerUuid);
});

// Unregister when no longer needed
PingItAPI.unregisterFilter(myFilter);

Multiple filters can be registered. A ping is visible only if all filters return true (AND logic), so a party plugin and a guild plugin can both restrict visibility independently.

Current Mods Utilizing PingIt API

• Group Manager - a standalone group/party management plugin

(integrates PingIt's ping system that allow it to show only within the party or otherwise)

Installation

1. Place PingIt-2.0.2.jar in Mods/ (root of Mods folder, not a subfolder)
2. Restart the server
3. Use /pingit give to get the Ping Device