Parchment Map

A map you have to make, carry and keep up to date yourself. It replaces the game's own map, and it is just as much at home in worlds played without a map (the nomap world modifier, part of the Hardcore preset).

You craft a parchment at the workbench. The map exists only on that parchment:

• The map opens only while the parchment is in your hand. Put it away and there is no map again.
• The land is charted only while you walk with the parchment in your hand. Both hands are busy: no shield, no weapon, no punching.
• What you see is first only noted down. It appears on the map when you use a cartography table.
• The map is just a picture. It shows neither you nor other players, no pings, shouts or raids, and it does not follow you: it opens where you last looked.
• Marks go only where the map is already drawn. That includes boss marks from runestones: if the place is not on your map yet, you only get turned towards it.
• A detailed picture, if you want one. With the separate SatelliteMap mod installed, zooming in shows the drawn part of the parchment as the world itself: relief, shores, forest, the paths you have made, buildings, ruins and boss altars. How detailed it is decides the parchment (for now: the DetailLevel setting). Without that mod everything else works the same.
• The map shows the land as you saw it, not as it is now. Build a house, lay a road, cut a forest: the parchment does not know. Walk there again with the parchment in your hand to note the changes, then visit a cartography table to draw them. Needs SatelliteMap 0.2.0 or newer on the server and on your side; with an older one the picture follows the world live.
• Every parchment is its own map. A fresh parchment is blank. Drop it, put it in a chest, hand it to a friend: the explored area and the marks travel with the item.
• The cartography table copies maps between parchments, so a lost parchment is not lost progress.

How to use it

1. Craft a Parchment map at the workbench: 2 deer hide, 1 coal, 1 feathers (configurable).
2. Equip it like a tool. While it is in your hand, walk around: the parchment notes down what you pass.
3. At a cartography table, with the parchment in your hand:
   • Read draws your notes onto the map and copies everything the table already knows onto your parchment.
   • Write does the same and also adds your map to the table's records.
4. Open the map with the usual key (M) while the parchment is in your hand. Marks are placed as usual, on drawn land only, and are stored on the parchment.
5. Read a runestone with the parchment in your hand: the boss mark is added if that place is already on the map. Without the parchment, or if the place is still blank, you are only turned towards it.

To copy a map: hold parchment A and Write, then hold parchment B and Read. On a world where items are deleted on death, Write before you leave home: a new parchment will get everything back from the table.

A mark you erase stays erased: it does not come back from the table, and your next Write removes it from the table too.

The tooltip of a parchment shows how much of the world is charted on it, how much is still waiting for a table, how many already drawn places you have charted anew (changes waiting for a table), and how many marks it has.

Copying through the table copies the picture too: a parchment that reads the table gets every place the way the most recent cartographer saw it.

Installation

Requires BepInEx and Jötunn.

The server and every player need the mod, in the same minor version; the game refuses the connection otherwise. This is on purpose: a client without the mod does not know the item and would silently delete parchments from chests it touches.

Before you play your character without the mod, leave your parchments in a chest: an unmodded game drops unknown items from the inventory.

In a world that has the map enabled the mod takes the map over as well (rule ReplaceVanillaMap): no minimap, no map on M, nothing gets charted until you hold a parchment. The map your character already had is not lost: it stays in the character file, hidden, and is back as soon as the rule is switched off. It is not copied onto parchments. With the rule off, the mod does nothing in such a world: the item can be crafted but is of no use.

Configuration

BepInEx/config/qua8ion.valheim.parchmentmap.cfg. The Rules section is controlled by the server and sent to all players.

Section	Key	Default	What it does
Rules	ReplaceVanillaMap	true	The parchment replaces the game's map in every world: a world with the map enabled is played like a no-map world. false: the mod works only in worlds without a map.
Rules	RevealAtTableOnly	true	New areas appear on the map only at a cartography table. false: the map is revealed while you walk.
Rules	ExploreRadiusMultiplier	1	Multiplier for the radius recorded around you (0.25 to 4).
Rules	ShowMinimap	false	Also show the small corner map while the parchment is in your hand.
Rules	BlockAttacks	true	No punching while the parchment is in your hand.
Rules	PinsOnlyOnExplored	true	Marks (yours and the game's location marks) only where the map is already drawn.
Rules	LiveMarkers	false	false: the map is a picture — no players, pings, shouts or raids, game-made marks (bed, traders) only on drawn land, the view stays where you left it. true: vanilla behaviour.
Rules	DetailLevel	3	Only with the SatelliteMap mod: how detailed the picture of the drawn part of the map is when you zoom in. 0: the plain game map. 1: a sketch (relief, water, paths, fields, buildings, ruins, boss altars). 2: also the forest and large rocks. 3: everything down to bushes. Planned: the level will come from the grade of the parchment.
Rules	Recipe	DeerHide:2,Coal:1,Feathers:1	Workbench recipe, Item:amount pairs with prefab names.
Visual	HandPosition, HandRotation, HandScale		How the sheet sits in your hand. Saved changes apply immediately, no restart needed.

Notes

• Your character's own map of that world (the one the game keeps in the character file) is left untouched.
• The table keeps the parchment records separately from the vanilla shared map data, so removing the mod leaves tables as they were.
• A parchment belongs to the world it was first used in. In another world it cannot be read, and nothing is drawn on it.
• The parchment stores only which snapshot of each place it shows; the snapshots themselves are kept by the server (see SatelliteMap, "Snapshots": back that file up together with the world).
• Parchments and tables made before 0.3.0 keep working. Their drawn places get a snapshot of the world as it is at the moment you first hold the parchment with 0.3.0; from then on they change only through walking and the table, like everything else.

Кратко по-русски

Карта на пергаменте вместо карты игры — и в мирах без карты (nomap, входит в пресет Hardcore), и в обычных: там мод сам убирает миникарту и карту по M (правило ReplaceVanillaMap, выключается на сервере; прежняя карта персонажа при этом не пропадает, а просто не показывается). На верстаке делается карта на пергаменте (2 оленьи шкуры, уголь, перо). Карта открывается и ведётся, только пока пергамент в руке; руки при этом заняты. Пройденное сначала копится в пергаменте и появляется на карте у стола картографа. У каждого пергамента своя разведка и свои метки: новый пергамент — чистый. Карта — просто картинка: ни себя, ни других игроков, ни пингов на ней нет, и за игроком она не следует. Метки ставятся только там, где карта уже нанесена, в том числе метки боссов с рунных камней. Если рядом стоит отдельный мод SatelliteMap, при приближении нанесённая часть пергамента показывается подробно: рельеф, берега, лес, тропы, постройки, руины и алтари боссов; насколько подробно — решает пергамент (пока настройка DetailLevel). Карта показывает местность такой, какой вы её видели, а не какая она сейчас: построили дом или проложили тропу — пройдитесь там с картой в руке (изменения попадут в заметки) и нанесите их у стола картографа. Для этого нужен SatelliteMap 0.2.0 или новее — и на сервере, и у себя. Через стол карта переносится между пергаментами: с пергаментом в руке «Записать» добавляет карту в записи стола, «Прочитать» переносит записи стола на пергамент. Стёртая метка со стола не возвращается. Мод нужен серверу и всем игрокам.