MapStitch

MapStitch

This mod adds a world map and a minimap using vanilla maps and makes vanilla maps cheaper and easier to manage by using the new Atlas item.

Unlike other world map/minimap mods which ignore vanilla maps and make them obsolete, MapStitch makes them much more enjoyable to use and turns them into a core part of the world map and minimap.

World map

MapStitch uses filled maps from your inventory to create a world map which you can open at any time by pressing M or right-clicking while holding an atlas.

The world map can only show one dimension and scale at once. These can be switched in the world map itself. There are basic controls like panning and zooming using the mouse, and toggleable player following and map grid overlay. A keybind reference can be brought up at any time by pressing H. Most of the keybinds can be rebound in the vanilla Controls menu.

The player marker, coordinates, and grid overlay require having a compass anywhere in the inventory.

Cheaper maps

Making maps is now cheaper, requiring only 9 paper instead of 8 paper and a compass, but they won't show your position unless you have a compass in your inventory.

Atlas

The inventory doesn't have much space for maps, but the brand-new Atlas item does! Create an atlas by combining a filled map and a book. The atlas can then be used like a bundle to store empty maps and filled maps matching the scale of the filled map used to create the atlas (up to 16384 items in total, configurable via a game rule).

Maps from the atlas will be used to create the world map, and the atlas will automatically turn empty maps inside it into filled maps as you enter unmapped areas.

Scrolling while hovering over an atlas will switch between ejecting filled or empty maps first.

Right-clicking with an atlas in hand when targeting a banner will create a banner marker on the currently active map, just like regular maps do.

Minimap

Having an atlas in the hotbar and a compass anywhere in your inventory will display a minimap showing the map where you're currently located.

If multiple atlases are present, the minimap will prioritize the atlas in your hands, otherwise the first atlas will be used.

Configuration

Game rules

Game rule changes apply in real-time for all players without having to rejoin or restart.

• mapstitch:require_compass_for_pos: Whether a compass is required to display the minimap and the player marker, coordinates, and grid overlay in the world map (default true)
• mapstitch:max_atlas_items: The maximum amount of items each atlas can have (default 16384)
  • When decreasing the value, make sure that no atlases exist in the world which have more items than what you're about to set, otherwise item loss or crashes may occur. Increasing the value should always be safe.

Data packs

The following features are built-in data packs and can be toggled on/off from the data packs screen during world creation or using the /datapack enable and /datapack disable commands:

• Cheaper maps
• Atlas slot
• Compass slot

Client settings

These can be configured either through Sodium video settings or in a config screen provided by YACL. Both mods are optional and the config can be edited manually through mapstitch.json in the config folder, but it's highly recommended to use one of the two config screens instead.

• Minimap display condition (HANDS, HOTBAR, INVENTORY)
  • Controls where the atlas item has to be located in order to display the minimap
  • Default is HOTBAR
• Minimap position (TOP_LEFT, TOP_RIGHT, BOTTOM_LEFT, BOTTOM_RIGHT)
  • Default is TOP_RIGHT
• Minimap size (0.05x to 2.0x)
  • Default is 1.0x
• Minimap background (CLEAR, TEXTURE, NONE)
  • Clear is a transparent rectangle, Texture is the map texture from the cartography table
  • Default is CLEAR
• Minimap background opacity (if Clear is set as the background)
  • Default is 50%
• Minimap effect overlay prevention
  • Automatically moves the minimap when player has active effects to prevent overlap
  • Works only if position is set to TOP_RIGHT
  • Default is true
• Minimap horizontal and vertical offsets
  • Defaults are 0 and 0
• World map text highlight color
  • Default is Yellow
• World map text background opacity
  • Default is 50%
• World map buttons
  • Controls whether to show the row of buttons on the right
  • Default is true
• World map help toggle
  • Controls whether to show the help toggle option
  • Default is true

Mod integration

• Trinkets (Updated), Ohmega, or Curios API: Allows equipping one atlas as an accessory, from where it will function as usual and be prioritized for the minimap

Recommended mods

• Better Nether Map: Makes maps made in the Nether display at a certain height instead of displaying the Nether roof