promotional bannermobile promotional banner

Spyglass

Adds a craftable spyglass/telescope that lets you zoom in and scout the world from afar.


Normal View

Spyglass View

How to craft

Craft the Spyglass at Workbench > Tools.

Ingredients:

  • 3 Copper Ingots
  • 1 Blue Crystal Shard
  • 1 Any Tree Log
  • 2 Plant Fiber

You can also obtain a Spyglass as a rare drop from Skeleton Pirates. The default chances are:

  • Skeleton Pirate Captain: 8%
  • Skeleton Pirate Gunner: 4%
  • Skeleton Pirate Striker: 2%

How to use

While holding the Spyglass:

  • Right-click to toggle zoom on or off.
  • Left-click while zoomed to cycle through the magnification levels.

The default magnification levels are 2x, 3x, and 6x.

Native FOV zoom

Spyglass 0.5.0 uses the native FOV controls introduced in Hytale Server 0.6.3. Unlike previous versions, it no longer simulates magnification by placing a camera in front of the player.

This removes the clipping, wall X-ray, and erratic obstacle-collision behavior associated with the old camera workaround.

Server configuration

Server owners can customize the zoom and Skeleton Pirate drop chances through the mod's generated external config.json. Available options include:

  • Magnification levels
  • Reference, minimum, and maximum FOV
  • Zoom transition duration
  • Held-item visibility
  • Reticle display
  • Drop chance for each Skeleton Pirate variant

The default configuration is:

{
  "Zoom": {
    "ReferenceFov": 70.0,
    "MagnificationLevels": [2.0, 3.0, 6.0],
    "MinimumFov": 10.0,
    "MaximumFov": 70.0,
    "TransitionDurationMillis": 240,
    "HideHeldItem": true,
    "DisplayReticle": true,
    "ScaleControlsWithZoom": true,
    "MinimumControlMultiplier": 0.1
  },
  "Drops": {
    "SkeletonPirates": {
      "CaptainChancePercent": 8.0,
      "GunnerChancePercent": 4.0,
      "StrikerChancePercent": 2.0
    }
  }
}

Set a drop chance to 0 to disable it. Configuration changes take effect after a server restart or full plugin reload. Invalid values are rejected with a clear message in the server log.

If you encounter any bugs, feel free to report them so I can keep improving the mod!

The Spyglass Team

profile avatar
Owner
  • 2
    Followers
  • 1
    Projects
  • 19.0K
    Downloads