Configuration
There are various different ways to modify the capabilities of the Locator Map.
structure_key is used to define which structure you would like to locate. If it is a vanilla minecraft structure, it's name should start with minecraft:. Structures from other datapacks or mods can also be located, with the condition that the proper namespace is specified (e.g. in order to locate the "Invertedtower" structure from Cobblecore, it should be created with the following command:
/give @s locatormaps:locator_map[locatormaps:structure_key="cobblecore:invertedtower"]
The provided map should function as intended:
Additionally, structure tags can be specified, instead of a specific structure. For example if you wanted to locate any village instead of a specific type, you could do as follows:
/give @s locatormaps:locator_map[locatormaps:structure_key="#minecraft:village"]
The dimension_key tells the map what dimension the structure belongs in. It defaults to minecraft:overworld and cant be used outside the specified dimension. Specify as so:
/give @s locatormaps:locator_map[locatormaps:dimension_key="{dimension}"]
Fairly self explanatory. Specifies how many chunks around the player the map may search before failing. The default is a radius of 20,000 chunks, if undefined. You may specify it like so:
/give @s locatormaps:locator_map[locatormaps:locator_range={range}]
Again, note that if the Structure Key is not specified, the map will not function.
This specifies if the map should display the coordinates of the structure. If enabled, it will display in the description of the map the X and Z coordinates of the located structure. If disabled, the coordinates will not be shown. Coordinates are shown by default. This can be set like so:
/give @s locatormaps:locator_map[locatormaps:map_show_coords={true/false}]
Controls whether or not this Locator Map can create a map to a structure that has already been located. By default, this is false, as it allows any subsequent locator maps to find new structures, to prevent the same structure from being mapped more than once. If enabled, any Locator Map used will always point to the same structure if it is the closest one. It can be set like so:
/give @s locatormaps:locator_map[locatormaps:allow_duplicate_finds={true/false}]
By default if you use a map in the same location with allow duplicate finds set to false, each map will point to a different structure:
Specifies whether advanced terrain painting should be used on the resulting map (only valid in dimensions other than The Overworld). While defaulting to false, if true it will use experimental features to attempt to draw the outlines of surrounding terrain like an overworld explorer map would. Please note that this feature is still work-in-progress and causes significant lag for 30-60secs on use. It can be toggled like so:
/give @s locatormaps:locator_map[locatormaps:use_advanced_terrain={true/false}]
