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.
• No pings. You cannot point at a place and have it appear on everyone's map. A place is shared by words, or through the cartography table. Pings from other players are not shown either.
• Whistle instead: the Z key, the last slot of the emote wheel (that is the way on a gamepad), or /whistle in chat. Your character raises a hand to the mouth and gives a long finger whistle, echoing off the valley: nothing appears on any map, but the others hear where you are — the sound comes from your direction and fades with distance, so they can walk to you. It costs stamina, you cannot sprint while whistling, and each player's whistle has its own pitch. Creatures hear it too, like a pickaxe on rock, and come running.
• A compass, once you have iron — and lightning. A separate item, put together from parts like a real one: a bronze case, an iron needle magnetised by the lightning of an obliterator, a wooden lid. Carry it in your bag — no need to hold it, your hands are busy with the map. Open the bag and the needle swings inside the compass icon and settles on north; open the map and the compass lies in its top left corner; keep it on the hotbar and its needle is always in sight. The map is drawn north up, so now the two agree.
• 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. Once you have iron, make a Compass (all recipes configurable):

   • at the forge: a Bronze compass case (1 bronze) and an Iron needle (1 iron);
   • put the needle into an obliterator (the game's own: 8 iron, 4 copper and a thunder stone from Haldor) and pull the lever — the lightning makes it a Magnetised needle. Put the needles in alone: everything else in there burns;
   • at the workbench: a Wooden compass lid (2 fine wood), then the Compass itself: the case, the magnetised needle, the lid and 2 bronze nails.

   Keep the compass anywhere in your bag; open the bag or the map to see the needle, or put it on the hotbar to keep it in sight.

2. Craft a Parchment map at the workbench: 2 deer hide, 1 coal, 1 feathers (configurable).

3. Equip it like a tool. While it is in your hand, walk around: the parchment notes down what you pass.

4. 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.

5. 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.

6. 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	BlockPings	true	No pinging places on the map, and pings from others are not shown.
Rules	CompassCaseRecipe	Bronze:1	Forge recipe for the bronze compass case, same format as Recipe.
Rules	CompassNeedleRecipe	Iron:1	Forge recipe for the iron needle. The needle is magnetised only by an obliterator's lightning.
Rules	CompassLidRecipe	FineWood:2	Workbench recipe for the wooden compass lid.
Rules	CompassRecipe	Q8_CompassCase:1,Q8_CompassNeedleMagnetised:1,Q8_CompassLid:1,BronzeNails:2	Workbench recipe that assembles the compass. Until 0.6.0 the default was Iron:2,FineWood:3,Resin:2; a config that still has exactly that is switched to the new default.
Rules	WhistleStamina	12	Stamina one whistle costs. 0: free.
Rules	WhistleRange	180	How far a whistle carries, metres (the game's shout carries 70).
Rules	WhistleCooldown	2	Pause between whistles, seconds.
Rules	WhistleNoise	100	How loud a whistle is to creatures, in the game's noise units (a pickaxe on rock: 100). 0: they do not hear it.
Visual	WhistleKey	Z	The key that whistles. Your own setting.
Visual	WhistleHandOffset	0.07, 0.08, 0.03	Where the whistling hand's wrist goes, metres from the mouth: forward, down, to the side. Saved changes apply immediately.
Visual	CompassPosition, CompassScale	24, 24, 1	Where the compass sits on the open map, counted from its top left corner, and how big it is. Saved changes apply immediately.
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 its picture of the drawn part of the map is when you zoom in. 0: relief and water only. 1: a sketch (also paths, fields, buildings, ruins, boss altars). 2: also the forest and large rocks. 3: everything down to bushes. Without SatelliteMap the parchment shows the game's own map picture. 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 оленьи шкуры, уголь, перо). Карта открывается и ведётся, только пока пергамент в руке; руки при этом заняты. Пройденное сначала копится в пергаменте и появляется на карте у стола картографа. У каждого пергамента своя разведка и свои метки: новый пергамент — чистый. Карта — просто картинка: ни себя, ни других игроков, ни пингов на ней нет, и за игроком она не следует. Метки ставятся только там, где карта уже нанесена, в том числе метки боссов с рунных камней. Пинга нет: место не показать одним щелчком всем сразу — только словами или через стол картографа; чужие пинги тоже не видны (правило BlockPings). Вместо него — свист (клавиша Z, последняя ячейка колеса эмоций — так и на геймпаде — или /whistle в чате): персонаж подносит руку ко рту и протяжно свистит, с эхом; на карте при этом не появляется ничего, но остальные слышат, с какой стороны и примерно как далеко, и приходят на звук. Свист тратит выносливость, пока рука у рта — бежать нельзя, слышен за 180 м (ванильный крик — за 70); у каждого игрока своя высота свиста. Слышат его и твари — как удар киркой по камню — и сбегаются. Когда появится железо, можно собрать компас — как настоящий, из деталей: на кузнице — бронзовый корпус (бронза) и железная стрелка (железо), на верстаке — деревянная крышка (2 качественной древесины). Стрелку намагничивает молния: положите её в мусоросжигатель и дёрните рычаг («Тор вознаграждает вас!»; всё остальное в нём сгорит, так что стрелки кладите отдельно). Собирается компас на верстаке: корпус, намагниченная стрелка, крышка и 2 бронзовых гвоздя. Он лежит в сумке: откройте сумку — стрелка качнётся в значке компаса и встанет на север; откройте карту — компас лежит в её левом верхнем углу; на панели быстрого доступа стрелка видна всегда. Карта тоже севером вверх, так что одно сходится с другим. В руку компас брать не надо, руки заняты картой. Если рядом стоит отдельный мод SatelliteMap, при приближении нанесённая часть пергамента показывается подробно: рельеф, берега, лес, тропы, постройки, руины и алтари боссов; насколько подробно — решает пергамент (пока настройка DetailLevel). Карта показывает местность такой, какой вы её видели, а не какая она сейчас: построили дом или проложили тропу — пройдитесь там с картой в руке (изменения попадут в заметки) и нанесите их у стола картографа. Для этого нужен SatelliteMap 0.2.0 или новее — и на сервере, и у себя. Через стол карта переносится между пергаментами: с пергаментом в руке «Записать» добавляет карту в записи стола, «Прочитать» переносит записи стола на пергамент. Стёртая метка со стола не возвращается. Мод нужен серверу и всем игрокам.