ZenMap

WARNING: 

Please be sure to have character backups before using this mod on an existing world.
Existing character map exploration data will be reset.

Designed for low-map games where you do not want universal map access but would like the map to only be available at the cartography table ~ OR ~ from a crafted item.

Admins in God mode can always view the map from anywhere.

NOTE: Pairs excellent with ZenCompass they were designed together.

When viewing the map from the Cartography Table, the map is locked to the location of the table itself. That means you can't pan the map. You can only see the area around the Cartography Table, and the zoom is limited based on the age of the table.

When you create a Cartography Table it automatically begins exploring the surrounding area. It takes a few game days to fully reveal the area. Check back with the table regularly. You will see the explored area expanding. The time delay is intentional as to prevent the player from carrying the crafting materials around and crafting a table whenever they want to see the map. Instead, you have to intentionally place a table where you want to collect map information on the surrounding area and fortify it against destruction. If the table is destroyed, then it's revealed area is lost. A new table needs to be created, and time needs to pass before the area is explored fully again. You can change the location of your table without destroying it using the ZenRedecorate mod.

This creates an immersive play experience where you can get lost, maps become useful and spread out. No world view. Orientation and direction and paths become important. (Install ZenPath for reduced stamina usage on paths)

This also means that your own exploration radius is irrelevant. The table itself is what defines revealed areas of the map, not your character.

TIP: Tables are shown on the map as the House icon. They are named "Town" by default. The table is represented by the house icon on the map because it is intended to reflect the idea of a town or home since maps are important things. You can rename the table if you would like. The chosen name you select will be reflected on the map pin representing the table. The rename function can be blocked with a ward.

Charting New Area: Time Remaining

First Day: Small Mapped Area

Last Day: Max Mapped Area

TIP: You can display the map icon labels by holding Shift (or Gamepad Y)

Craftable Map Items

You can craft a portable map item and carry it with you from any table. The item is a static copy of the map table that it was copied from. It will not update as you move around. NOTE: you can turn craftable map items off if you would like to only allow the map from the cartography table.

By default, the Parchment required to craft maps is not available until the Artisan Table can be created. This is to give the player some time to experience the game with only having map access from the Cartography Table and thereby make the discovery of the Parchment a nice reward for progression.

How they work:

Once you have crafted a Parchment, take it to the Cartography Table and select Record Discoveries to create a copy of the map and store it as an item in your inventory. The map item you just created is a static snapshot of that Cartography Table's explored area. If you travel to a new area and look at the map you created, it will still show the same world area copied onto it when it was crafted. Just like a real paper map, not a GPS. This means that even if the table is destroyed, the copied map you created will persist. However, it's a little bit magical. Any new pins that appear in the area it covers will be shown on the map. It's a live map of the area it's focused on, but its explored area is static and its view is fixed on a specific area of the world and will never change.

Usage:

Pressing the Map button on your Keyboard or Gamepad will open the map in your inventory. In the case where you are carrying multiple maps, then pressing the map button will open the last one you used. You can open them manually by Right-Clicking on them or pressing X on Gamepad.

TIP: You can rename any maps you are carrying by pointing at the item and pressing Shift + Left-Click or the Gamepad equivalent. Key hints at the bottom of the screen shows which buttons to press.

Map Pins

Map pins can not be placed from the map view, nor can automatically created ones be removed. Instead, certain key elements are tracked automatically while others are added manually by the player to Signs in the world itself.

Since pins are no longer added to the map screen as they are in vanilla, they are instead tied to objects in the game world itself and automatically updated.

This means, for example, if you destroy a bonfire, the pin is automatically removed from the map. If a ship changes position, then it updates instantly on the map. Corpse pins are automatically removed once looted, etc.

• Map data is universal and does not need to be shared manually between players at the cartography table.
• Anyone can look at a map table or make a copy of it with Parchment. If you do not want someone else to see your map, then put it in a room with a warded door and lock the door.
• Player icons always show on the map unless their PVP flag is enabled, then they are hidden.
• Show/Hide pin labels to reduce visual clutter: Hold Left-Shift, or Gamepad button Y.

Automatic Pins

• All ships, carts, and other vehicles are automatically tracked.
• Cartography Tables themselves are displayed as a house icon on the map.
• Bonfires automatically create a fireplace pin on the map. This includes both player-crafted and goblin bonfires in the wild.
• Death pins are automatically created and removed. Anyone can see your death pin on the map. Use teamwork to find your tombstone with one friend at the base guiding the other player towards their corpse.

Crafted Marker Locations (Map Pins)

But what about places the player wants to mark manually? In that case Map Pins can be crafted and attached to signs in the game world. Think of Map Pins as scraps of metal, they are crafted from a single Bronze nail (configurable).

TIP: Install ZenUseItem to attach pins to signs without needing to place the item on your 1-8 hot bar first

• Player crated Map Pins are always private. This means that only you can see your pins attached to signs. If the pinned sign is destroyed, then the marker will vanish from the map. Any map pins applied to it will not drop. If the pinned sign is moved via ZenRedecorate then the marker will move on the map too.
• Map Pins are spent when applied to signs.
• Remove a pin from a sign by assigning another Map Pin to the sign again. Alternatively you can assign the Hammer to the sign to remove the pin.
• The pin will be refunded back into your inventory.
• Removing a manually attached pin can also be done from the Cartography Table by pressing LeftCtrl + RightClick on the marker.
• You can not remove automatically tracked pins from the map.
• Pins removed from the Cartography Table do not refund the Map Pin item.
• Since pins are per-player you can not remove someone else's pinned signs nor see their sign pins on the map.
• Multiple people can pin the same sign, you will only see your pin. This prevents map spam.
• Many pin icons to select from.

If you want to draw someone's attention to a location on the map just ping it with the middle mouse button.

Using Location Markers on Signs

TIP: Uses ZenHoverItem to show the pin icon over the sign.

Pin Types

Extend Functionality with Additional ZenMods

• ZenCompass: Show map pin data on the compass radar which makes finding your dead corpse or other areas of interest much easier.
• ZenHoverItem : View item icons when hovering over objects.
• ZenRedecorate: Reposition chests or a Cartography Table without destroying it.
• ZenUseItem: Interact directly from your inventory without using your 1-8 hot bar.
• ZenPath: Run on paths using less stamina.
• ZenSign: Assign items to signs and view the total available in nearby chests.

Improve Your Experience

CORE MODS

The full collection of all Zen MODS:

• Radically improved QoL
• Incredible performance
• Pre-configured
• 100% Gamepad support
• Spectacularly immersive

Enjoy!

Sample Config File

## Settings file was created by plugin ZenMap v0.8.0
## Plugin GUID: ZenDragon.ZenMap

[Crafting]

## [Admin] When true the player can apply parchment to a cartography table and copy the table's map to an item.
## The item can then be opened from anywhere in the world and it will always reflect that snapshot.
## The map can be stored in chests or traded with other players.  The map can be renamed.
## Maps can be recrafted at the Cartography Table via 1-8 Use Item.
## When false, map items can not be created from the map table.
## [reboot required for changes to take effect]
# Setting type: Boolean
# Default value: true
Enable Map Items = true

## [Admin] Crafting station required for creating a parchment.
# Setting type: String
# Default value: ArtisanTable
# Acceptable values: None, Workbench, Forge, Stonecutter, Cauldron, ArtisanTable, BlackForge, GaldrTable, MeadKetill, FoodPreparationTable
Parchment Crafting Station = ArtisanTable

## [Admin] Minimum level required for the crafting station to craft parchment
# Setting type: Int32
# Default value: 1
# Acceptable value range: From 1 to 5
Parchment Crafting Station Level = 1

## [Admin] Resource requirements for crafting a parchment.
# Setting type: StringList
# Default value: Resin:4, MeadTasty:2, Guck:3, LoxPelt:1
Parchment Resources = Resin:4, MeadTasty:2, Guck:3, LoxPelt:1

## [Admin] Crafting station required for creating the map pin item.
# Setting type: String
# Default value: None
# Acceptable values: None, Workbench, Forge, Stonecutter, Cauldron, ArtisanTable, BlackForge, GaldrTable, MeadKetill, FoodPreparationTable
Map Pin Crafting Station = None

## [Admin] Minimum level required for the crafting station to craft map pins
# Setting type: Int32
# Default value: 1
# Acceptable value range: From 1 to 5
Map Pin Crafting Station Level = 1

## [Admin] Resource requirements for crafting a Map Pin.
## Bronze nails is the default because it gives a perioid of early game progression without pins
## for added challenge and reward.
# Setting type: StringList
# Default value: BronzeNails:1
Map Pin Resources = BronzeNails:1

## [Admin] Max stack size. How many pins can be stored in a single inventory slot.
## [restart required for changes to take effect]
# Setting type: Int32
# Default value: 100
# Acceptable value range: From 1 to 100
Map Pin Stack Size = 100

## [Admin] Refund the map pin when manually removing it from a sign?
# Setting type: Boolean
# Default value: true
Map Pin Refund = true

[General]

## [Admin] Automatically set the world modifier nomap on startup.
## If nomap is enabled then the only way to view the map is via the cartography table (or admin god mode)
# Setting type: Boolean
# Default value: true
Autoset World Modifier NoMap = true

## [Admin] Hide the player's arrow icon when looking at the map table.
## Instead, use the landscape and compass to get your bearings.
## [close/open map to see changes]
# Setting type: Boolean
# Default value: true
Hide Player Arrow = true

## [Admin] Always show players on the map unless PVP is enabled.
# Setting type: Boolean
# Default value: true
Show All Players Unless PVP = true

## [Admin] The map button is available for admin when they are in god mode
# Setting type: Boolean
# Default value: true
God Mode - Allow Map = true

## [Admin] When in god mode the entire map will be revealed when pressing the map button.
## When using a map table or portable map the full map will not be revealed.
## The global key "nomap" must be set for this config to function.
# Setting type: Boolean
# Default value: true
God Mode - Full Map = true

## [Admin] How long must pass for a map table to be fully explored. (game days)
# Setting type: Int32
# Default value: 7
# Acceptable value range: From 0 to 100
Days Until Full Map = 7

## [Admin] How large of an area does the fully explored map reveal
# Setting type: Int32
# Default value: 2000
# Acceptable value range: From 400 to 10000
Map Table Fully Explored Radius = 2000

## [Admin] Key that admin can hold while interacting with the table to accelerate its age. (God mode must be active)
# Setting type: KeyCode
# Default value: LeftAlt
# Acceptable values: None, Backspace, Tab, Clear, Return, Pause, Escape, Space, Exclaim, DoubleQuote, Hash, Dollar, Percent, Ampersand, Quote, LeftParen, RightParen, Asterisk, Plus, Comma, Minus, Period, Slash, Alpha0, Alpha1, Alpha2, Alpha3, Alpha4, Alpha5, Alpha6, Alpha7, Alpha8, Alpha9, Colon, Semicolon, Less, Equals, Greater, Question, At, LeftBracket, Backslash, RightBracket, Caret, Underscore, BackQuote, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z, LeftCurlyBracket, Pipe, RightCurlyBracket, Tilde, Delete, Keypad0, Keypad1, Keypad2, Keypad3, Keypad4, Keypad5, Keypad6, Keypad7, Keypad8, Keypad9, KeypadPeriod, KeypadDivide, KeypadMultiply, KeypadMinus, KeypadPlus, KeypadEnter, KeypadEquals, UpArrow, DownArrow, RightArrow, LeftArrow, Insert, Home, End, PageUp, PageDown, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15, Numlock, CapsLock, ScrollLock, RightShift, LeftShift, RightControl, LeftControl, RightAlt, LeftAlt, RightCommand, RightMeta, RightApple, LeftCommand, LeftMeta, LeftApple, LeftWindows, RightWindows, AltGr, Help, Print, SysReq, Break, Menu, WheelUp, WheelDown, Mouse0, Mouse1, Mouse2, Mouse3, Mouse4, Mouse5, Mouse6, JoystickButton0, JoystickButton1, JoystickButton2, JoystickButton3, JoystickButton4, JoystickButton5, JoystickButton6, JoystickButton7, JoystickButton8, JoystickButton9, JoystickButton10, JoystickButton11, JoystickButton12, JoystickButton13, JoystickButton14, JoystickButton15, JoystickButton16, JoystickButton17, JoystickButton18, JoystickButton19, Joystick1Button0, Joystick1Button1, Joystick1Button2, Joystick1Button3, Joystick1Button4, Joystick1Button5, Joystick1Button6, Joystick1Button7, Joystick1Button8, Joystick1Button9, Joystick1Button10, Joystick1Button11, Joystick1Button12, Joystick1Button13, Joystick1Button14, Joystick1Button15, Joystick1Button16, Joystick1Button17, Joystick1Button18, Joystick1Button19, Joystick2Button0, Joystick2Button1, Joystick2Button2, Joystick2Button3, Joystick2Button4, Joystick2Button5, Joystick2Button6, Joystick2Button7, Joystick2Button8, Joystick2Button9, Joystick2Button10, Joystick2Button11, Joystick2Button12, Joystick2Button13, Joystick2Button14, Joystick2Button15, Joystick2Button16, Joystick2Button17, Joystick2Button18, Joystick2Button19, Joystick3Button0, Joystick3Button1, Joystick3Button2, Joystick3Button3, Joystick3Button4, Joystick3Button5, Joystick3Button6, Joystick3Button7, Joystick3Button8, Joystick3Button9, Joystick3Button10, Joystick3Button11, Joystick3Button12, Joystick3Button13, Joystick3Button14, Joystick3Button15, Joystick3Button16, Joystick3Button17, Joystick3Button18, Joystick3Button19, Joystick4Button0, Joystick4Button1, Joystick4Button2, Joystick4Button3, Joystick4Button4, Joystick4Button5, Joystick4Button6, Joystick4Button7, Joystick4Button8, Joystick4Button9, Joystick4Button10, Joystick4Button11, Joystick4Button12, Joystick4Button13, Joystick4Button14, Joystick4Button15, Joystick4Button16, Joystick4Button17, Joystick4Button18, Joystick4Button19, Joystick5Button0, Joystick5Button1, Joystick5Button2, Joystick5Button3, Joystick5Button4, Joystick5Button5, Joystick5Button6, Joystick5Button7, Joystick5Button8, Joystick5Button9, Joystick5Button10, Joystick5Button11, Joystick5Button12, Joystick5Button13, Joystick5Button14, Joystick5Button15, Joystick5Button16, Joystick5Button17, Joystick5Button18, Joystick5Button19, Joystick6Button0, Joystick6Button1, Joystick6Button2, Joystick6Button3, Joystick6Button4, Joystick6Button5, Joystick6Button6, Joystick6Button7, Joystick6Button8, Joystick6Button9, Joystick6Button10, Joystick6Button11, Joystick6Button12, Joystick6Button13, Joystick6Button14, Joystick6Button15, Joystick6Button16, Joystick6Button17, Joystick6Button18, Joystick6Button19, Joystick7Button0, Joystick7Button1, Joystick7Button2, Joystick7Button3, Joystick7Button4, Joystick7Button5, Joystick7Button6, Joystick7Button7, Joystick7Button8, Joystick7Button9, Joystick7Button10, Joystick7Button11, Joystick7Button12, Joystick7Button13, Joystick7Button14, Joystick7Button15, Joystick7Button16, Joystick7Button17, Joystick7Button18, Joystick7Button19, Joystick8Button0, Joystick8Button1, Joystick8Button2, Joystick8Button3, Joystick8Button4, Joystick8Button5, Joystick8Button6, Joystick8Button7, Joystick8Button8, Joystick8Button9, Joystick8Button10, Joystick8Button11, Joystick8Button12, Joystick8Button13, Joystick8Button14, Joystick8Button15, Joystick8Button16, Joystick8Button17, Joystick8Button18, Joystick8Button19, F16, F17, F18, F19, F20, F21, F22, F23, F24
Admin Accelerate Age Key = LeftAlt

## [Admin] Hide the ship marker (yellow banana) when the player is controlling a ship.
# Setting type: Boolean
# Default value: true
Hide Ship Marker = true

## [Admin] When true the map ping can only be seen on the map table, not in the game world as floating text, not on the compass either.
## You can still see each other's pings when both viewing the map table.  Even if you are at different tables.  
## This prevents guiding players via ping spam. You have to talk to each other and plan ahead instead.
# Setting type: Boolean
# Default value: true
Map Ping - Hide In World = true

## [Admin] When true hides the shout pings from the cartograpy table large map.
## However, they can still be seen in world or on ZenCompass if you are in range.
## God mode can always see all shout pings.
# Setting type: Boolean
# Default value: true
Map Ping - Hide Shout Pings = true

[Pin Rules]

## Hold down this key to display the pin labels on the map.
## Note: Gamepad is button Y.
# Setting type: KeyCode
# Default value: LeftShift
# Acceptable values: None, Backspace, Tab, Clear, Return, Pause, Escape, Space, Exclaim, DoubleQuote, Hash, Dollar, Percent, Ampersand, Quote, LeftParen, RightParen, Asterisk, Plus, Comma, Minus, Period, Slash, Alpha0, Alpha1, Alpha2, Alpha3, Alpha4, Alpha5, Alpha6, Alpha7, Alpha8, Alpha9, Colon, Semicolon, Less, Equals, Greater, Question, At, LeftBracket, Backslash, RightBracket, Caret, Underscore, BackQuote, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z, LeftCurlyBracket, Pipe, RightCurlyBracket, Tilde, Delete, Keypad0, Keypad1, Keypad2, Keypad3, Keypad4, Keypad5, Keypad6, Keypad7, Keypad8, Keypad9, KeypadPeriod, KeypadDivide, KeypadMultiply, KeypadMinus, KeypadPlus, KeypadEnter, KeypadEquals, UpArrow, DownArrow, RightArrow, LeftArrow, Insert, Home, End, PageUp, PageDown, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15, Numlock, CapsLock, ScrollLock, RightShift, LeftShift, RightControl, LeftControl, RightAlt, LeftAlt, RightCommand, RightMeta, RightApple, LeftCommand, LeftMeta, LeftApple, LeftWindows, RightWindows, AltGr, Help, Print, SysReq, Break, Menu, WheelUp, WheelDown, Mouse0, Mouse1, Mouse2, Mouse3, Mouse4, Mouse5, Mouse6, JoystickButton0, JoystickButton1, JoystickButton2, JoystickButton3, JoystickButton4, JoystickButton5, JoystickButton6, JoystickButton7, JoystickButton8, JoystickButton9, JoystickButton10, JoystickButton11, JoystickButton12, JoystickButton13, JoystickButton14, JoystickButton15, JoystickButton16, JoystickButton17, JoystickButton18, JoystickButton19, Joystick1Button0, Joystick1Button1, Joystick1Button2, Joystick1Button3, Joystick1Button4, Joystick1Button5, Joystick1Button6, Joystick1Button7, Joystick1Button8, Joystick1Button9, Joystick1Button10, Joystick1Button11, Joystick1Button12, Joystick1Button13, Joystick1Button14, Joystick1Button15, Joystick1Button16, Joystick1Button17, Joystick1Button18, Joystick1Button19, Joystick2Button0, Joystick2Button1, Joystick2Button2, Joystick2Button3, Joystick2Button4, Joystick2Button5, Joystick2Button6, Joystick2Button7, Joystick2Button8, Joystick2Button9, Joystick2Button10, Joystick2Button11, Joystick2Button12, Joystick2Button13, Joystick2Button14, Joystick2Button15, Joystick2Button16, Joystick2Button17, Joystick2Button18, Joystick2Button19, Joystick3Button0, Joystick3Button1, Joystick3Button2, Joystick3Button3, Joystick3Button4, Joystick3Button5, Joystick3Button6, Joystick3Button7, Joystick3Button8, Joystick3Button9, Joystick3Button10, Joystick3Button11, Joystick3Button12, Joystick3Button13, Joystick3Button14, Joystick3Button15, Joystick3Button16, Joystick3Button17, Joystick3Button18, Joystick3Button19, Joystick4Button0, Joystick4Button1, Joystick4Button2, Joystick4Button3, Joystick4Button4, Joystick4Button5, Joystick4Button6, Joystick4Button7, Joystick4Button8, Joystick4Button9, Joystick4Button10, Joystick4Button11, Joystick4Button12, Joystick4Button13, Joystick4Button14, Joystick4Button15, Joystick4Button16, Joystick4Button17, Joystick4Button18, Joystick4Button19, Joystick5Button0, Joystick5Button1, Joystick5Button2, Joystick5Button3, Joystick5Button4, Joystick5Button5, Joystick5Button6, Joystick5Button7, Joystick5Button8, Joystick5Button9, Joystick5Button10, Joystick5Button11, Joystick5Button12, Joystick5Button13, Joystick5Button14, Joystick5Button15, Joystick5Button16, Joystick5Button17, Joystick5Button18, Joystick5Button19, Joystick6Button0, Joystick6Button1, Joystick6Button2, Joystick6Button3, Joystick6Button4, Joystick6Button5, Joystick6Button6, Joystick6Button7, Joystick6Button8, Joystick6Button9, Joystick6Button10, Joystick6Button11, Joystick6Button12, Joystick6Button13, Joystick6Button14, Joystick6Button15, Joystick6Button16, Joystick6Button17, Joystick6Button18, Joystick6Button19, Joystick7Button0, Joystick7Button1, Joystick7Button2, Joystick7Button3, Joystick7Button4, Joystick7Button5, Joystick7Button6, Joystick7Button7, Joystick7Button8, Joystick7Button9, Joystick7Button10, Joystick7Button11, Joystick7Button12, Joystick7Button13, Joystick7Button14, Joystick7Button15, Joystick7Button16, Joystick7Button17, Joystick7Button18, Joystick7Button19, Joystick8Button0, Joystick8Button1, Joystick8Button2, Joystick8Button3, Joystick8Button4, Joystick8Button5, Joystick8Button6, Joystick8Button7, Joystick8Button8, Joystick8Button9, Joystick8Button10, Joystick8Button11, Joystick8Button12, Joystick8Button13, Joystick8Button14, Joystick8Button15, Joystick8Button16, Joystick8Button17, Joystick8Button18, Joystick8Button19, F16, F17, F18, F19, F20, F21, F22, F23, F24
Show Labels Key = LeftShift

## [Admin] Set the condition to display the boss pins. (Vanilla: Anywhere)
## Never: Never show the boss pins on the map.
## Anywhere: Add the boss pin to the map when you touch any Vegvisir anywhere in the world.
## NearOnly: Only add the boss pin to the map when you touch a Vegvisir close to the boss altar.
# Setting type: RevealMode
# Default value: NearOnly
# Acceptable values: Never, NearOnly, Anywhere
Boss Reveal = NearOnly

## [Admin] Displayed on the Cartography Table globally for all players who look at the table, except Sign pins.
## Sign: PRIVATE pins visible only to the player who placed the Sign pin, nobody else can see these.
## MapTable: marked as towns so players know where to go for map info.
## Bonfire: large bright sources of light that can be seen by everyone at great distances.
## Tombstone: pin markers are global, everyone can see the tombstone pins for all players.
## Cart: tracked so they don't get lost easily
## WarMachine: BatteringRam and Catapult, tracked.
## SmallBoat: coastal craft, Raft and Karve, tracked.
## LargeShip: deep sea adventures, Longship and Drakkar, tracked.
## Portal: Portals are disabled by default because portals are secrets. Also, portal rooms clutter pins on the map.
## [restart required for changes to take effect]
# Setting type: PinOption
# Default value: Sign, MapTable, Tombstone, Bonfire, Cart, LargeShip, SmallBoat, WarMachine
# Acceptable values: None, Sign, MapTable, Tombstone, Bonfire, Cart, LargeShip, SmallBoat, WarMachine, Portal, All
# Multiple values can be set at the same time by separating them with , (e.g. Debug, Warning)
Show - Cartography Table = Sign, MapTable, Tombstone, Bonfire, Cart, LargeShip, SmallBoat, WarMachine

## [Admin] Map Item is a SNAPSHOT of the current explored area and pins on the map, INCLUDING private Sign pins.
## New pins added after the map item is crafted will not be visible. Craft a new map at the table.
## Sign pins are copied from the table to the crafted map and are visible to anyone who looks at that map item.
## The pins on the snapshot live update. If the object is destroyed or moved the pin will be updated as well.
## Consider immersion before enabling pins for objects that move, they will live update on the crafted map.
## If you have a cart and pins are configured to show carts then you can easily figure out where you are.
## The default configuration preserves immersion by restricting pins to non-movable objects except large ships.
## Large ships are enabled by default because a large ship would have onboard navigation and are restricted to water.
## However, if the ship sinks it will not be on the map anymore. Recraft the map and buld a new ship.
## NOTE: The Map Item will not display tracked pins that are not visible on the Cartography Table.
## Example: If Ships are not shown on the Cartography Table they will never display on the Map Item.
## [enabling pin options requires recrafting existing maps to add the newly enabled pins]
# Setting type: PinOption
# Default value: Sign, MapTable, Tombstone, Bonfire, LargeShip
# Acceptable values: None, Sign, MapTable, Tombstone, Bonfire, Cart, LargeShip, SmallBoat, WarMachine, Portal, All
# Multiple values can be set at the same time by separating them with , (e.g. Debug, Warning)
Show - Map Item = Sign, MapTable, Tombstone, Bonfire, LargeShip

Like My Mods? Donations Welcome

Bitcoin

v0.8.6

• added a config key: Hold HideInfo key to hide all pins and other info on the map so you can see a clean view. (default: LeftAlt, or Gamepad: Right-Bumper)

v0.8.5

• fix: Inventory close via the "E" key works again.

v0.8.4

• fix: calendar year was being updated when renaming a map item.
• add configs for calendar year and day offset.

v0.8.3

• Add color coding to the map pins based on visibility and intent.

v0.8.2

• add optional calendar year info to tooltip and map display

v0.8.1

• CRAFTED MAP PIN UPDATE
• any existing maps you have will not display any pins until you recraft them. visit any cartography table to recraft the map via 1-8 interaction.
• crafted map items introduced a design flaw. this update corrects it:
  • Prior: when the player crafted a map they could add pins in the wild and see the updates instantly to determine where they were. This was incorrect.
  • New Behavior: when you craft a map item at the table it now takes a snapshot of the pins on the map. any new pins created after that moment will not be on the crafted map. The pins are dynamic, tied to the underlying object. If the sign is destroyed the pin will vanish from both the table and the map item.
  • If you want to update an existing crafted map use the 1-8 interaction on the map table and apply the existing map item to the table, it will prompt for a name and then overwrite the map item with the current table information.
  • portable maps, by default, do not show all map pins, they only show non-movable pins because otherwise the player could craft a cart, craft a map, and then have a GPS cart.
  • The default exception to this is large ships. Large ships are enabled on the crafted map by default because they only travel on water and they are expensive to build. If they sink they will vanish from your map and you will need to recraft a new map and a new ship.
  • You can adjust the configuration options for what type of pins are visible on both the table and the crafted map. Read the descriptions of the configuration options.
  • Revisit your existing configs, the Map Pins section was changed significantly.
• added languages: German, Russian

v0.8.0

• same as v0.8.1, just a readme update to v0.8.1

v0.7.10

• update for Valheim v0.221.4, Call to Arms
• the Valheim update adds a new GlobalKey to the enum, shifting the value of the nomap flag. recompile required.

v0.7.9

• fix: on modded worlds with huge maps, the fully zoomed out map was displaying as a ring instead of a fullscreen big beautiful map.

v0.7.8

• change map pin dot icon to flag

v0.7.7

• fix typo and a few edge cases.

v0.7.6

• fix logic for show/hide the ship marker.

v0.7.5

• Added a config option to hide shout pings on the map.

v0.7.4

• play sound fx when opening and closing a map (because i am silly and forgot to add the close fx in the prior version)

v0.7.3

• play sound fx when opening a map.

v0.7.2

• fix: display the map correctly on ultrawide displays (or any other aspect ratio).

v0.7.1

• cleanup alien world message formatting for edge cases of map items in inventory from alien worlds.

v0.7.0

• updated for Zen.ModLib v1.2.0
• recompile for BepInEx v5.4.2332
• recompile for JVL v2.26.0

v0.6.4

• remove unused assets
• reduce file size 50%
• fixed a minor cosmetic issue relating to HoverText when using location markers on signs.

v0.6.3

• single player optimization

v0.6.2

• fix: KeyHint "Rename" on Map Item mouse over was not resetting when moved onto a blank square in the inventory.

v0.6.1

• update readme with instructions on how to craft map items.
• notify the user when they create a map.

v0.6.0

• new feature: portable maps that can be crafted from parchment and copied from cartography tables.
• map tables now have the icon label "Town" on the minimap, you can rename them to whatever you like by interacting with the table. (Unless it is warded)
• rename portable map items after you have crafted them (shift left mouse or the gamepad equivalent in your inventory)
• config default change: admin age override changed from LeftShift to LeftAlt because of conflict with the new Rename feature.

v0.5.8

• bugfix: handling map display when in god mode and nomap is off.

v0.5.7

• refactored to optionally be used even when on a play session that has the map enabled. Important pins are still auto-tracked, and manually placed pins must still be crafted and attached to signs. However, if the nomap flag is not set then the map can be viewed from anywhere without the cartography table interaction if desired. In that case the cartography table will revert to vanilla behavior. However, in my opinion, it's still far better to use the cartography table as an immersive experience. To rely on your wits for navigation. Don't depend on the crutch of the minimap, or you may miss the experience of the journey.

v0.5.6

• improved the logic behind the v0.5.5 fix so that it handles all the possible config states for boss pin reveal mode.

v0.5.5

• fix: reveal boss pin while in god mode was not reverting to vanilla behavior.

v0.5.4

• fix: error when booting on a dedicated server.

v0.5.3

• fix: the pin label toggle key was not working when in admin god mode.

v0.5.2

• display map pin labels when holding down LeftShift or Gamepad Y.

v0.5.1

• adjust pin icon dialog display order.

v0.5.0

• new feature: map pin icon selection dialog when attaching a pin to a sign. NOTE: If you also install ZenHoverItem you will see the icon over the sign.

v0.4.9

• clear texture cache when switching between worlds with different sized modded maps.

v0.4.8

• add config options for toggling auto track for:
  • ships
  • carts (and catapults / battering rams)
  • tombstone
  • bonfire
  • cartography table
• the default days to achieve max exploration changed from 5 to 7. this does not affect existing configs.
• some configs got renamed related to the above, check your configs.
• bugfix: Max zoom now correctly adjusts to the Fully Explored Radius config option. Note: this will slightly alter the max zoom range from prior versions. It should not be a noticeable difference. However, if you like you can adjust the Max Explored Radius config value to compensate if desired.

v0.4.7

• fix to handle large maps and optimize loading and caching when opening the map from the table.

v0.4.6

• add config to toggle discoverability of Boss pins so that you have to be near them before they show.
• add config to hide tombstone pins for an extra challenge if desired.
• add cause of death to tombstone pins if ZenPlayer is installed

v0.4.5

• update for Zen.ModLib v1.1.0

v0.4.4

• remove config option: Wooden Pole No Workbench, does not align with this mod's purpose.
• added basic config options for crafting pins: workstation, max stack size
• bugfix: sync crafting item configs from server.

v0.4.3

• fixed config sync

v0.4.2

• removed gamepad remap requirement. By itself ZenMap does not require the gamepad controls to be remapped as it adds no new buttons.

v0.4.1

• removed BepInEx from dependency, Zen.ModLib handles it.

v0.4.0

• Refactor for Zen.ModLib
• Add config option to hide map ping in the world and compass, but you can still see each other's pings when viewing the map table even if you are at different tables. This prevents guiding players via ping spam. You have to talk instead. Default true.

v0.3.3

• update description - no code changes.

v0.3.2

• update logging and configs subsystem

v0.3.1

• cleanup logs

v0.3.0

• UPDATE FOR VALHEIM v0.220.3
• IMPORTANT: if you did not run ZenMap v0.2.13 yet please run that on your old data with the old version of valheim BEFORE you run the new version of Valheim or you will lose all your manually placed pins due to a data format change in Valheim. See patch notes for ZenMap v0.2.13 below:

v0.2.13

• IMPORTANT UPDATE
• RUN THIS ON VALHEIM VERSION: <= 0.219.16 (n-32)
• THIS IS BEFORE THE NEXT UPDATE. After the update it will not be possible to recover any custom pinned signs.
• Run this once and look at your map. Every player needs to do this once as pin data is saved in the player profile, not the world file.
• This update migrates pin data from an old format that will be obsolete in the next version of Valheim. Custom pins will be lost if you play your save character on the new version of valheim before running this update on v0.219.16 or earlier.

v0.2.12

• Add config option to set world modifier nomap on startup.

v0.2.11

• Add config option for refunding pins.
• Added ability to remove pins with the Hammer.
• Fixes compatibility issue with ZenSign.

v0.2.10

• Add hover text and pin indicator when adding pins to signs.
• Refund map pin when removing manually from the sign.

v0.2.9

• Update readme, no code changes.

v0.2.8

• Initial release