Custom Crosshair banner
Custom Crosshair icon

Custom Crosshair

create a mod allowing custom crosshairs. allow creation of different symbols as well as different colors

00
hytaleServer2026.1mod

What it does

  • Adds a server-side Custom Crosshair plugin with defaults (red dot, green plus, blue X) and a /crosshair command to manage them.
  • Sends reticle definitions directly to connected players and triggers a reticle event so the chosen style appears immediately.
  • Supports on-the-fly creation of new crosshair styles with custom symbol names and color tags.

Usage

  • /crosshair list — show available crosshair ids.
  • /crosshair apply <name> — push a registered crosshair to yourself.
  • /crosshair create <name> [symbol] [color] — make or overwrite a crosshair (defaults to dot + #FFFFFF) and auto-apply it.
  • Reticle assets are referenced as UI/Reticles/<symbol>_<COLOR>.png; provide matching assets in your pack for the best visuals.

Implementation notes

  • Uses protocol-level ItemReticleConfig packets with high index values (starting at 10000) to avoid colliding with existing definitions.
  • Base, server, and client reticle events reuse the same symbol/color reference and use a long duration to keep the crosshair active.
  • The jar artifact is named customcrosshair-1.0.0.jar.

Limitations / future ideas

  • The mod does not generate textures; ensure matching UI/Reticles assets exist for the symbols/colors you create.
  • Indices are managed in-memory; restarting the server resets custom-created crosshairs to the built-in defaults. Persisting definitions to disk would make them survive restarts.