Nomad Compass

Compass v1.1.0 is built for Hytale 0.7.5 and adds the Wayfinder Compass. If you have any issues, please leave a comment!

Nomad Compass adds two items. The first is a wooden pocket compass with a hinged lid and a needle that moves. Switch to it and the lid snaps open. Hold it and the needle settles on north. Turn, and it stays on north.

Then, point it at something. /compass track [name] and the needle swings to wherever that player is and follows them as they move.

/compass point 340 64 -120 and it holds on that spot until you clear it.

The target goes with the item, so your players can pass directions to each other in a physical item: set a compass on your base and hand it to a newcomer.

• Craft it at a workbench from two copper bars and a stick.
• Install it by dropping NomadCompass-1.1.0.jar into Server/mods/ in place of any older Nomad Compass jar. Nothing on the client.
• Hook into it from your own mod: set and clear targets through a small public API, or give a player a compass that already points at the objective, so a quest can start with "follow the needle" instead of a coordinate in chat.

The second item: the Wayfinder Compass

Recipes in Hytale send you back and forth across all four zones, and if you travel on foot rather than by teleporter, picking a direction and walking can take forever. The Wayfinder fixes that without turning into a map hack.

Right-click to attune it. Each click moves it to the next zone (Emerald Wilds, Howling Sands, Whisperfrost Frontiers, Devastated Lands) and the zone's name comes up in the same banner the game uses when you discover a zone. The needle spins while it searches, then swings toward the nearest land of that zone.

It tells you which way and nothing else. No coordinates, no distance and no menu. When you cross into the zone, the needle settles back on north. If the zone is too far away to sense, the needle just wanders, so pick a direction and try again later.

• Craft it at a workbench from a Compass, five Essence of Life and an Iron Ingot.
• It only leads to land. Coasts count; open sea does not.
• It works in any world that uses the standard world generator. In instances and custom worlds the needle wanders.

This one came straight from a comment on this page asking for a zone-finding compass that feels like part of the game rather than a GUI that hands you everything. Thank you!

Inspiration Credit

When I was searching for Hytale compass mods, Biome's Compass by EtherealLabs popped up, and I really liked their compass design with the lid flipping open. There were certain aspects I changed a lot, because I had some priorities like making the animation feel satisfying when the player switches to the compass, but I did absolutely take some inspiration from their design. Please check out their mods!

Commands

Command	What it does
/compass track <player>	point your compass at a player
/compass point <x> <y> <z> [world]	point it at a fixed spot
/compass clear	back to north
/compass status	what it is tracking right now

For mod authors

Declare Compass in your manifest.json so the server loads it before you (use OptionalDependencies instead if your mod should still run without it, and null-check the plugin):

"Dependencies": { "co.nomadlabs:NomadCompass": "*" }

Then get the plugin and ask it for a compass:

NomadCompassAPI compass = PluginManager.get().getPlugin(NomadCompassPlugin.class);

// A compass already pointing at a spot, dropped into a player's hotbar.
compass.giveCompass(playerUuid, TrackingTarget.at(new WorldPoint("Orbis", 340, 64, -120)));

// Or build the stack yourself and hand it out however you like.
ItemStack reward = compass.newCompass(TrackingTarget.player(targetUuid, targetName));

withTarget(stack, target) re-points an existing compass (null clears it) and targetOf(stack) reads one, so a quest mod can check whether the player still carries the compass you gave them. Classes are co.nomadlabs.compass.plugin.NomadCompassAPI and co.nomadlabs.compass.domain.TrackingTarget; compile against the jar.