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. !(https://raw.githubusercontent.com/pajicadvance/mapstitch/refs/heads/v2/images/worldmap.png) 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. !(https://raw.githubusercontent.com/pajicadvance/mapstitch/refs/heads/v2/images/help.png) ## 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. !(https://raw.githubusercontent.com/pajicadvance/mapstitch/refs/heads/v2/images/emptymap.png) ## 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. !(https://raw.githubusercontent.com/pajicadvance/mapstitch/refs/heads/v2/images/atlas.png) ## 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. !(https://raw.githubusercontent.com/pajicadvance/mapstitch/refs/heads/v2/images/minimap.png) ## 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 (https://modrinth.com/mod/sodium) video settings or in a config screen provided by (https://modrinth.com/mod/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