Maps of the Unknown

Maps of the Unknown

Improves explorer map creation upon loot-table processing

by
27.5K Downloads
fabricquiltgame-mechanicsoptimizationutility
Rent Server with this Mod

About this Mod

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.

Available Versions

Maps of the Unknown 0.9.1release
MC 26.1, 26.1.1, 26.1.2fabric
April 21, 2026
Maps of the Unknown 0.9.0release
MC 26.1, 26.1.1, 26.1.2fabric
April 20, 2026
Maps of the Unknown 0.8.0 - Mc 1.21.11+release
MC 1.21.11fabric
January 2, 2026
Maps of the Unknown 0.7.3 - Mc 1.21.9+release
MC 1.21.9, 1.21.10fabric
October 6, 2025
Maps of the Unknown 0.7.3 - Mc 1.21.5+release
MC 1.21.5, 1.21.6, 1.21.7, 1.21.8fabric
September 28, 2025

How to Install Maps of the Unknown on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).

3

Install Mod

Open the mod browser in the dashboard and search for "Maps of the Unknown". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabricquilt

Minecraft Versions

26.1.2, 26.1.1, 26.1 (+23 more)

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Maps of the Unknown server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.2). You can switch loaders with one click in the panel.

Is Maps of the Unknown compatible with fabric and quilt?

Maps of the Unknown officially supports fabric, quilt for Minecraft 26.1.2, 26.1.1, 26.1. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Maps of the Unknown – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Maps of the Unknown consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install Maps of the Unknown with just one click on your server.

Recommended RAM
4 GBfrom €5.2/mo
Minimum 3 GB | per 8 players
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

26.1.226.1.126.11.21.111.21.101.21.91.21.81.21.71.21.61.21.5+16 more