
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
/crosshaircommand 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 todot+#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
ItemReticleConfigpackets 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/Reticlesassets 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.