promotional bannermobile promotional banner
premium banner

Personalized Crosshair / Reticule

Change the in-game crosshair with selectable reticles for all players.

Description

Personalized Crosshair / Reticule is a server-side mod that lets server operators customize the in-game crosshair experience in Hytale.

Using the /reticle command, operators can open an in-game GUI that allows selecting from multiple built-in reticle styles or use their own custom images. The selected reticles are applied globally to all players on the server.

🔹 How it works

Due to current Hytale limitations, client-side modification is not supported. Because of this:

  • The crosshair applies to all players on the server
  • The command is OP-only
  • Individual per-player crosshairs are not possible at this time

The mod dynamically generates and manages its own asset pack to override the default Hytale reticles.

🔹 Reticle Modes

You can configure two separate reticles:

  • Melee – Used for all weapons (swords, daggers, bows, crossbows, etc.)
  • Default – Used for tools and all non-weapon items

You can:

  • Use different reticles for each mode
  • Or set both to the same reticle
  • Quickly reset everything back to the original Hytale reticles at any time

🔹 Custom Reticles

You can now use literally any image as your reticle! Want a giant Linux penguin as your crosshair? Go for it!

 

 

 

Simply place your image files (PNG) in:

 
mods/Hackzit.HackzitDynamicReticle/Common/UI/Custom/Reticles

The folder is created automatically on first launch. The UI displays the full path to make it easy to find. After adding your images, click the Reload button in the GUI to see them instantly—no restart needed!

🔹 Commands

  • /reticle – Opens the reticle selection GUI (OP only)

⚠️ Important Installation Note

After installing the mod for the first time, a server restart is required. This is necessary so Hytale can properly load the custom asset directory created by the mod. After the initial restart, reticle changes will hot-reload automatically.

🔹 Current Features

  • Multiple built-in reticle styles
  • Custom reticle image support – use any image you want!
  • In-game GUI with pagination for browsing reticles
  • Full file path display in the UI
  • Reload button for instant custom reticle updates
  • Separate Melee and Default reticles
  • Reticle name labels for easy identification
  • One-click reset to vanilla Hytale reticles
  • Hot-reload after setup (no restart needed after first run)

đź”® Planned Features

  • More built-in reticle styles
  • Expanded configuration options