All Mods Resource Packs Data Packs Shaders Modpacks Plugins
Maps of the Unknown

Maps of the Unknown

by Nerjal_Nosk • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

Ever been tired of your server lagging an awful lot when you open a chest that may contain an explorer map? Or when you level up a cartographer villager?

Even more with a lot of mods, so much that you can get up to multiple explorer maps in a single chest, or as villager trades, which would cause massive lag upon generation?

You don't want your server to crash anymore because of that?

Then look no further! I have a simple yet effective mod right here for you.

Maps of the Unknown

Maps of the Unknown (or BetterMaps) only tweaks it so that the structure location logic is processed at a later point, upon request of the player, by replacing the map item by what would look like an empty map, but would become the regular explorer map upon use.

This mod doesn't come with any config file, for it doesn't need it, but adds two gamerules:

  • do_better_maps, which acts as a pure toggle for the mod (true by default)
  • do_better_maps_loot, which serves as a toggle only for the chest loot map generation (true by default)
  • do_better_maps_trades, which serves as a toggle only for the villager trade map generation (true by default)
  • do_better_map_from_player_pos, which sets the mod to start locating the structure from the player (false by default). Beware, despite it being on false by default, keeping it as such can alter the location algorithm's behavior, thus locating a different instance of the wanted structure than expected, although still trying to keep it as close as possible from the location the map was generated at (default behavior).
  • do_better_maps_dynamic_locating, which toggles whether the map locating tasks should be run in a dynamic way (when true, default value) or vanilla. Enabling it makes it so the world isn't frozen until the task is finished, and solves some crash issues with maps creation. In order to prevent map duping with starting multiple tasks before the first one is finished, it is required for the player to keep the map in hand until they get the result map, so that the mod can effectively consume the initial map (except in creative of course)
  • do_better_maps_feedback, which toggles whether dynamic locating tasks should get logged in the server console and to OP players. This gamerule doesn't do anything if do_better_maps_dynamic_locating is disabled.

What's even better with this mod you may ask, is that it is entirely server-sided! There is no need for the client to install it, or you can just install it on a server with another modpack, for the pure sake of improving the map creation logic!


Q&A

My world still crashes when I use a map, why?

  • While improving the loot-table processing, this mod doesn't change the structure location logic. It only prevents the game from trying to locate multiple structures during a single tick, which can easily end up crashing even the most powerful servers.

Why do you use the vanilla empty map?

  • To make the mod able to work purely server-side.

Why doesn't it do anything when I use the map?

  • I added one more thing to the map creation, that is dimension specification. You may see what dimension is a map for by hovering it in your inventory, as a tooltip. If you are not in the matching dimension when using the map, look forward to seeing a red "x" temporarily appear over your hotbar, and your action not doing anything.
  • Additionally, a blue "x" means that the structure couldn't be found for some other reason. Thus meaning that there either is no such structure in that dimension, or none in search range.

Why didn't you just name it "BetterMaps"?

  • Because it sounds cool.

What happens if I remove the mod?

  • This mod works hand in hand with vanilla Minecraft, but only change the latter's behavior when loaded. Thus, if you remove the mod, using a special "empty map" created by the mod would only make the game behave as normal with a regular empty map.

Is this mod incompatible with ?

  • The only real response I can give you is maybe.
  • Async Locator: Yes and no. This mod cannot work when enabled with Async Locator if its exploration map and villager trade features are enabled, or you may need to toggle at least the corresponding feature of this here mod. And considering my plans for the future of this mod, they will most probably not be compatible at all on the long term. But until further notice, you may use both while validating the aforementioned conditions.

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.3 26.2
Fabric
1mo ago 1
26.1.x
Fabric
6mo ago 1
26.1.x
Fabric
6mo ago 1
1.21.11
Fabric
10mo ago 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x
Fabric
last yr. 1
1.21.x 1.20.x
Fabric Quilt
last yr. 1
1.20.x
Fabric Quilt
last yr. 1
1.19.x
Fabric Quilt
last yr. 1
1.18.2
Fabric Quilt
last yr. 1
1.20.x
Fabric Quilt
last yr. 1
1.19.x
Fabric Quilt
last yr. 1
1.20.x
Fabric Quilt
last yr. 1
1.19.x
Fabric Quilt
last yr. 1
1.20.x
Fabric Quilt
last yr. 1
1.19.x
Fabric Quilt
last yr. 1
1.20.x
Fabric Quilt
last yr. 1
1.19.x
Fabric Quilt
last yr. 1
1.20.x
Fabric Quilt
last yr. 1
1.19.x
Fabric Quilt
last yr. 1
1.20.x
Fabric Quilt
last yr. 1
1.19.x
Fabric Quilt
last yr. 1
(long overdue) 26.2 update
[0.9.1] Maps of the Unknown 0.9.1 by Nerjal_Nosk on Apr 21, 2026
Download
Fix trade control gamerule not being taken into consideration anymore
Updated Unruled API dependency to enforce reload fix inclusion
[0.9.0] Maps of the Unknown 0.9.0 by Nerjal_Nosk on Apr 20, 2026
Download
Updated to Mc 26.1+

Now better compatible with non-vanilla explorer map trades
Updated to Mc 1.21.11 and for Unruled API 2.x

Renamed gamerules to fit 1.21.11 restrictions
0.7.3 hotfix for Mc 1.21.9+

  • fixed various method renamings
  • fixed a missing null check after vanilla codebase changes on structure lcoation return
0.7.2* hotfix for 1.21.5+

  • Fix missed Mojank changes in the Nbt API
  • Changes**
  • Made doBetterMapsFeedback gamerule actually useful
  • Removed pointless Server Translation API inclusion
  • Improved translations
  • Removed pointless gamerule creation AW

  • Improved build
  • Upgraded Unruled API dependency
  • Fixed crashes when inventory item insertion cannot be done (map completion with a full inventory), ensuing with server-asynchronous item entity creation
  • Improved build process
  • Upgraded Unruled API dependency
  • Fixed crashes when inventory item insertion cannot be done (map completion with a full inventory), ensuing with server-asynchronous item entity creation
  • Improved build process
  • Upgraded Unruled API dependency
  • Fixed crashes when inventory item insertion cannot be done (map completion with a full inventory), ensuing with server-asynchronous item entity creation
Unruled API 1.0+ compatibility update
Unruled API 1.0+ compatibility update
Patched for Mc 1.21.2+

Unruled API is no longer bundled inside the mod
Marked as non-beta
1.21 Unruled patch
# First beta release for 1.20.5+

  • upgrade to 1.20.5+ (components)
  • workflow improvements
  • moved to (embedded) Unruled API for Gamerules
  • added configurable (gamerule) maximum number of simultaneous search tasks
[0.5.2] Maps of the Unknown 0.5.2 by Nerjal_Nosk on Jan 17, 2024
Download
# Release 0.5.2

[0.5.2] Maps of the Unknown 0.5.2 by Nerjal_Nosk on Jan 17, 2024
Download
# Release 0.5.2

# Release 0.5.1

Ported to 1.18
# Release 0.5.1

# Release 0.5.1

[0.5] MotU 0.5 - 1.20 by Nerjal_Nosk on Nov 17, 2023
Download
# Release 0.5

  • Added villager map trades
  • Added refined control gamerules
[0.5] MotU 0.5 - Mc 1.19 by Nerjal_Nosk on Nov 17, 2023
Download
# Release 0.5

  • Added villager map trades
  • Added refined control gamerules
[0.4] MotU 0.4 - Mc 1.20 by Nerjal_Nosk on Sep 24, 2023
Download
# Changes

  • Fixed issue locking the map upon use
  • Added a control command (OP only)
[0.4] MotU 0.4 - Mc 1.19 by Nerjal_Nosk on Sep 24, 2023
Download
# Changes

  • Fixed issue locking the map upon use
  • Added a control command (OP only)
[0.3] MotU 0.3 - Mc 1.20 by Nerjal_Nosk on Sep 21, 2023
Download
Improved thread handling

Fixed potential issue with task not being validated locking map item
[0.3] MotU 0.3 - Mc 1.19 by Nerjal_Nosk on Sep 21, 2023
Download
Improved thread handling

Fixed potential issue with task not being validated locking map item
[0.2] MotU 0.2 - Mc 1.20 by Nerjal_Nosk on Sep 02, 2023
Download
Added dynamic structure locating!
  • Prevent world freeze while searching for a structure
  • Requires the player to keep the map in hand until locating finished
  • Can be toggle with the doBetterMapsDynamicLocating gamerule (default to true)

Other changes:
  • loot table can now set a specific dimension for the map to be used in. Can be useful for modpack creators to make maps to specific structures harder to acquire.
[0.2] MotU 0.2 - Mc 1.19 by Nerjal_Nosk on Sep 02, 2023
Download
Added dynamic structure locating!
  • Prevent world freeze while searching for a structure
  • Requires the player to keep the map in hand until locating finished
  • Can be toggle with the doBetterMapsDynamicLocating gamerule (default to true)

Other changes:
  • loot table can now set a specific dimension for the map to be used in. Can be useful for modpack creators to make maps to specific structures harder to acquire.
[0.1] MotU 0.1 - Mc 1.20.1 by Nerjal_Nosk on Aug 23, 2023
Download
Initial version for Mc 1.20.1
Maps of the Unknown Icon
Download Maps of the Unknown
Select game version
Select platform