Hal's Mapper

Map information for Hytale operators and quest writers: find any ore, block, mob or prefab, routes through caves, map markers, what players changed, and treasure hunts that end in a real chest. MIT.
hm-01-quest.png

hm-01-quest.png

hm-02-chest.png

hm-02-chest.png

hm-03-find.png

hm-03-find.png

hm-04-map.png

hm-04-map.png

hm-05-route.png

hm-05-route.png

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 copper lists 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). Add mark to 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 show marks the way on your map.

  • Describe here. /hm describe tells 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 changes reports 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

  1. Install CommandDeck 1.3.0 or later.
  2. Put the Hal's Mapper jar in your server's mods folder (singleplayer: %APPDATA%\Hytale\UserData\Mods\).
  3. 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 route draws 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.

Hal's Mapper Team

profile avatar
  • 1
    Followers
  • 11
    Projects
  • 441
    Downloads

Systems Engineer, enjoying life.

Donate

More from HledjolfView all

  • Calendar & Seasons project image

    Calendar & Seasons

    Gives your world a named calendar. /date answers "Sunday, October 21, Year 1, Autumn". Gregorian, harvest, Old Icelandic or your own months, with seasons announced as they change. Server-side only: players install nothing. MIT.

    • 29
    • November 20, 2026
  • Hal's Quest Generator project image

    Hal's Quest Generator

    The building blocks and scaffolding for quests and quest chains: steps, gates and links between quests, a Quest Log, rewards through Generous Operator, and an in-game quest constructor. MIT.

    • 6
    • November 20, 2026
  • Generous Operator project image

    Generous Operator

    One-click gifts for server operators. Pick a player or everyone online, pick a kit, press Give. Kits from catalogs any mod can ship, optional limits, and a log of every gift. Built on CommandDeck. MIT.

    • 12
    • November 19, 2026
  • Buff Effects project image

    Buff Effects

    A status-effect engine: timed or permanent buffs and debuffs on players and NPCs. Mods apply effects through it; it owns timers, stacking and cures. /bfx commands, an editor window, and caps the server owner sets. MIT.

    • 25
    • November 17, 2026
  • Calendar & Seasons project image

    Calendar & Seasons

    Gives your world a named calendar. /date answers "Sunday, October 21, Year 1, Autumn". Gregorian, harvest, Old Icelandic or your own months, with seasons announced as they change. Server-side only: players install nothing. MIT.

    • 29
    • November 20, 2026
  • Hal's Quest Generator project image

    Hal's Quest Generator

    The building blocks and scaffolding for quests and quest chains: steps, gates and links between quests, a Quest Log, rewards through Generous Operator, and an in-game quest constructor. MIT.

    • 6
    • November 20, 2026
  • Generous Operator project image

    Generous Operator

    One-click gifts for server operators. Pick a player or everyone online, pick a kit, press Give. Kits from catalogs any mod can ship, optional limits, and a log of every gift. Built on CommandDeck. MIT.

    • 12
    • November 19, 2026
  • Buff Effects project image

    Buff Effects

    A status-effect engine: timed or permanent buffs and debuffs on players and NPCs. Mods apply effects through it; it owns timers, stacking and cures. /bfx commands, an editor window, and caps the server owner sets. MIT.

    • 25
    • November 17, 2026