Description
Hal's Mapper
Requires CommandDeck 1.3.0 or later.
Map information for server operators, builders and quest writers. Find any ore, block, fluid, mob, spawner or prefab around you; find a way on foot through the caves; mark places on the world map; see what players have changed since the world was made; and send players on treasure hunts that end in a real chest.
Most of it is an operator's and Creative player's tool. Survival players meet it through what it makes: a treasure hunt, a set of directions, a marker on their map.
Features
-
Finders.
/hm find ore copperlists the nearest copper, by distance and direction, from your own level outward. Also any block (stone), fluids, live mobs, spawners and prefabs (ruins, mineshafts, camps). Addmarkto put the results on your map. -
The cave network. In the background, Hal's Mapper surveys the land around players: every chamber, tunnel, dead end and cave mouth, and how they join. Nothing to set up, and a world's survey is kept between restarts.
-
Routes through caves.
/hm route to <x y z or marker>finds a way on foot from where you stand to the place you name, through the caves the survey has mapped, and tells you how far it is and how much climbing it takes./hm route showmarks the way on your map. -
Describe here.
/hm describetells you about the space you're standing in: a large, low chamber, a narrow tunnel, and what's in it. -
A Treasure Hunt quest (with the Quest Generator). Hal's Mapper picks a cave site 48 to 96 blocks away and a route into it, and the chest of treasure waits at the end. It's offered in every player's Quest Log, and an operator can start it for anyone with
/hm hunt:- Easy: checkpoints to follow, each marked on the map;
- Medium: just the chest's coordinates. Finding the way is up to you.
With Generous Operator too, the treasure is inside the chest. In a new world, or where there's no cave near, the chest is hidden out in the open instead.
-
Map markers.
/hm mark add <label>marks where you stand, for you, your operators or everyone. Markers from other mods (quests) show up on the same map. -
What's changed.
/hm changesreports what players have built or dug near you since the world was generated, worked out by regenerating the chunk in memory and comparing. Natural change (plants, leaves, fluids, snow) is left out. -
Light on the server. All of its work runs in small slices through CommandDeck's work scheduler and worker threads, so a survey or a long search never stalls the game.
Install
- Install CommandDeck 1.3.0 or later.
- Put the Hal's Mapper jar in your server's
modsfolder (singleplayer:%APPDATA%\Hytale\UserData\Mods\). - Start the server and type
/hm. The survey starts on its own around players.
Optional: the Quest Generator (for the Treasure Hunt quest) and Generous Operator (treasure inside the quest's chest).
Commands and permissions
| Command | What it does |
|---|---|
/hm |
Lists the commands you can use |
/hm find <ore, stone, fluid, mob, spawner, prefab> <what or any> |
The nearest matches. Options: radius, up, down, exposed or all, mark |
/hm route to <x y z or marker> |
A way on foot through the caves, from where you stand; /hm route show marks it on your map |
/hm describe |
Describes the space you're standing in |
/hm mark add <label>, list, remove, share |
Your map markers |
/hm changes [radius] |
What players have changed nearby since the world was made |
/hm hunt [player] [easy or medium] |
Starts the Treasure Hunt quest for you or a player (needs the Quest Generator) |
/hm map route |
Draws map sheets of your last route |
/hm scan status |
How far the survey has got |
/hm network export <radius> |
The cave network as a graph file |
Permissions: operators (halsmapper.op) have everything. Creative players get the finders, describe, changes and their own markers, and each of those can be switched off. Survival players get nothing directly: hunts, directions and markers reach them through quests or an operator.
Settings
In mods/Hledjolf_HalsMapper/config.json: which tools Creative players get, whether they see buried ores, how far the survey reaches and how much memory it may use, marker limits per player and per mod, and the default directions style.
Compatibility
- Hytale server 0.7.7, dedicated servers and singleplayer.
- Directions and descriptions are in English. The words are data files, so other languages can be added.
- Ores and blocks from other mods are found too. Mods can name their own blocks' kinds (ore, stone, built) with a small data file.
For mod authors
Other mods can ask Hal's Mapper for places through its API, halsmapper.places:
- cave sites by kind, depth and distance;
- prefabs and the nearest anything;
- routes with checkpoints;
- descriptions of a site or a route in words;
- map markers under the asking mod's own name.
Every call is asynchronous and never blocks the game. Without Hal's Mapper installed, the API simply isn't there. The Quest Generator's treasure quests use it.
Coming next
- Treasure maps as pictures.
/hm map routedraws your last route as top-down map sheets (PNG files): plain, worn, or with false trails to mislead, for printing or a server website. -
Hard treasure hunts (words only, with landmarks you have to recognise), landmarks named by other mods, and treasure maps drawn in the game.
License
MIT. Bundling it in a modpack is fine: keep the license with it.




