Parchment Map

A map for 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.
• 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, and how many marks it has.

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 does nothing: 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.

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.

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

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

Changelog

0.3.0

• The parchment now replaces the game's map in worlds that have the map enabled too, not only in no-map worlds: no minimap and no map on M without a parchment in hand. New server rule ReplaceVanillaMap, on by default; set it to false to keep the old behaviour (the mod does nothing where the map is enabled).
• The map your character already had in such a world is left untouched in the character file and comes back when the rule is switched off. It is not copied onto parchments.
• The detailed picture (SatelliteMap 0.2.0 or newer) now shows the land as it was when you charted it, not as it is now. A new house or road appears on the parchment only after you walk there again with the parchment in your hand and then visit a cartography table. The tooltip counts the places charted anew that still wait for a table. Copying through the table copies the picture as well: the most recent cartographer wins.
• Parchments and tables made with older versions keep working: their drawn places get a snapshot of the world as it is when you first hold the parchment with 0.3.0. Parchments touched by 0.3.0 cannot be read by older versions.
• Server and players need the same minor version, so everyone has to update. For the "as charted" picture the server needs SatelliteMap 0.2.0 as well; with an older one the picture stays live.

0.2.0

• Works together with the new SatelliteMap mod (optional): zooming in shows the drawn part of the parchment as a detailed top-down picture of the world, with relief, forest, player-made paths, buildings, ruins and boss altars.
• New server rule DetailLevel (0-3) decides how detailed that picture is. It is the groundwork for parchment grades: the level will come from the grade of the parchment.
• Maps made with 0.1.0 keep working. Server and players need the same minor version, so everyone has to update.

0.1.0

• First release: a craftable parchment map for no-map worlds. It works only in your hand, keeps its own explored area and marks, gets drawn at the cartography table and can be copied through it. The map is a picture: no player markers, marks only on drawn land.