Skip to content
JackFred2 edited this page Dec 15, 2023 · 12 revisions

A GIF showing the player pinging blocks and entities, with a flashing hazard ping on a creeper.

Players can ping blocks and entities within range, which will show to nearby players. This is done by pressing the 'Swap Item With Offhand' hotkey, default F.

Client Install

Version: 1.2.0+

Players can install Eye Spy locally to gain a dedicated keybind instead, default Z. This disables the swap hand override keybind for them.

Single Press

A single press of this button will display a static highlight on the block or entity being looked at. This highlight will change colour depending on the target; for blocks, it will be a lightened version of the block's map colour, while for entities it will depend on the category of the mob. For example, vehicles will be light blue, while hostile mobs red.

Double Press

Double pressing the button within a short time period will show a flashing red highlight on the given block or entity.

Config

$.ping.enabled

Whether ping functionality is enabled.

  • Options: true, false
  • Default: true
  • Commands:
    • /eyespy config ping enabled - Check if pinging is enabled.
    • /eyespy config ping enabled <true|false> - Change whether pinging is enabled.

$.ping.pingRequirement

Version: 1.3.4+

What requirement there are to pinging.

  • Options:
    • zoomed_with_spyglass - The player needs to be zoomed in with a Spyglass to ping.
    • holding_spyglass - The player needs to be holding a Spyglass to ping.
    • none - If the player has the client mod installed, then they can ping with any or no item by pressing the keybind. If they don't have it installed, then they need to be holding a Spyglass.
  • Default: zoomed_with_spyglass
  • Commands:
    • /eyespy config ping pingRequirement - Check the current ping requirements.
    • /eyespy config ping pingRequirement <zoomed_with_spyglass|holding_spyglass|none> - Change the current ping requirements.

$.ping.notifyRangeBlocks

The maximum distance within which nearby players will also be shown the ping.

  • Options: [8, 256]
  • Default: 64
  • Commands:
    • /eyespy config ping notifyRangeBlocks - Check the current player notify range.
    • /eyespy config ping notifyRangeBlocks <new range> - Change the player notify range.

$.ping.lifetimeTicks

How long ping highlights will last, in terms of game ticks.

  • Options: [60, 400] [3 seconds, 20 seconds]
  • Default: 160 (8 seconds)
  • Commands:
    • /eyespy config ping lifetimeTicks - Check the current ping lifetime.
    • /eyespy config ping lifetimeTicks <new range> - Change the ping lifetime.

$.ping.maxPings

Version: 1.2.0+

The maximum amount of pings a given player can have out at a given time.

  • Options: [1, 32]
  • Default: 5
  • Commands:
    • /eyespy config ping maxPings - Check the current maximum ping count.
    • /eyespy config ping maxPings <new max> - Change the current maximum ping count.

Ping Text

Text describing what was pinged, and their distance

Version: 1.3.0+

Pings can have text displayed above the target, showing the same information as the Rangefinder feature.

$.ping.showDescriptionText

Whether to show the description of the target (entity or block name) as a line of text on pings.

  • Options: true, false
  • Default: false
  • Commands:
    • /eyespy config ping showDescriptionText - Check if description text is added to pings.
    • /eyespy config ping showDescriptionText <true|false> - Change whether description text is added to pings.

$.ping.showDistanceText

Whether to the distance from the player's eyes to the target is shown on pings.

  • Options: true, false
  • Default: true
  • Commands:
    • /eyespy config ping showDistanceText - Check if the distance to the player is added to pings.
    • /eyespy config ping showDistanceText <true|false> - Change whether the distance to the player is added to pings.

$.ping.showPingerName

Version: 1.3.4+

Whether to show the name of the player who pinged the target.

  • Options: true, false
  • Default: true
  • Commands:
    • /eyespy config ping showPingerName - Check if the pinger's name is shown on ping text.
    • /eyespy config ping showPingerName <true|false> - Change whether the pinger's name is shown on ping text.

$.ping.minimumScale

The minimum size of the ping text as a factor of the base size when the viewing player looks away from the ping. See also: $.text.textScale.

  • Options: [0, 1]
  • Default: 0.4
  • Commands:
    • /eyespy config ping minimumScale - Check the current ping text minimum scale factor.
    • /eyespy config ping minimumScale <new factor> - Change the current ping text minimum scale factor.

Removed

$.ping.requiresZoomIn

1.3.4: Replaced with $.ping.pingRequirement

Whether a player needs to be zoomed in to ping with a spyglass, or whether just holding one will allow functionality.

  • Options: true, false
  • Default: true
  • Commands:
    • /eyespy config ping requiresZoomIn - Check if being zoomed in is required.
    • /eyespy config ping requiresZoomIn <true|false> - Change whether being zoomed in is required.