Town Portal

Find a ruined old book, restore it at a workbench, and use it to open a portal home from anywhere in the world.

The Tome of Town Portal opens a temporary portal back to the bed you have claimed. Friends can follow you through, and a return gate at your bed takes everyone back to where you opened it. It doesn't join the normal portal network, and it follows the same cargo rules as a wood portal.

More details and pictures: valtownportal.sprekn.com

Needs BepInEx and Jötunn. In multiplayer, every player and the server need the mod installed.

Features

A way home. With the tome anywhere in your inventory, press Left Alt + H. On a controller, hold L2 and click the right stick. A blue-lit wood portal opens beside you.
Bring your friends. Anyone can walk through your portal. They arrive at your bed, not their own, and they don't need a tome.
A way back. A blue return gate appears at your bed. Press E on it to go back to the portal.
Know whose gate it is. Each return gate shows its owner's name when you hover it, and a small floating name when you are close, so you can tell gates apart in a busy base.
Home can be your Runic Spawn Point. The finished tome also teaches you a respawn stone. Claim one and the portal takes you there instead of your bed. See below.
Fair limits. A portal lasts 15 minutes, and the tome needs 5 minutes to rest before you can open another one. Ore, metal bars and anything else a wood portal won't take are refused here as well. World settings that turn off portals, or block them during boss fights, apply to the tome too.
Something to find. Mysterious Tomes turn up in Meadows and Black Forest chests, and Haldor sells them once the Elder is dead.
Matches the game's look. Both books use pixel-style textures like Valheim's own items. The finished tome is warm brown leather with glowing cyan runes. The Mysterious Tome is the same book, dusty and worn.
Works on existing worlds. You don't need a new world.

Getting the tome

1. Find a Mysterious Tome

Chests: about 1 in 4 loot chests in the Meadows and Black Forest also have one. It's added on top of the normal loot, so nothing else is replaced.
Haldor: sells one for 250 coins after the Elder is dead. If you find one in a chest before that, you can still use it.

Each chest gets one chance the first time it loads with the mod installed, even chests you've already looted. Barrels and chests that players built don't count.

2. Restore it at a workbench

Craft the Tome of Town Portal at a level 1 workbench:

Ingredient	Amount
Mysterious Tome	1
Surtling core	10
Greydwarf eye	25
Leather scraps	15
Deer hide	5

You keep the finished tome. Opening a portal doesn't use it up, and you don't need to equip it.

Runic Spawn Point

Runic Spawn Point used to be a separate mod. It is now part of Town Portal.

Unlocked by the tome. The first time the finished Tome of Town Portal is in your inventory, you learn the Runic Spawn Point and get the usual "new piece" message. The Mysterious Tome doesn't count. Once learned, it stays learned for that character, even if you put the tome away.
Build it anywhere. Find it in the Hammer under Furniture. It costs the same as a bed and needs no roof.
Claim it. Press E on the stone to make it your spawn point. Shift + E releases it. When you die, you wake up beside it, however far away it is.
Sails with you. Build it on a ValheimRAFT boat and you respawn on deck wherever the boat has gone, and get put back on the deck if you land in the water.
Town Portal opens to it first. With a stone claimed, your portal goes to the stone. If the stone is gone, it goes to your bed, and then to the starting stones.

If you still have the old Runic Spawn Point mod installed, remove it. Stones you already built and claimed keep working.

How it works

Carry the Tome of Town Portal and press Left Alt + H (or L2 + right stick click). The portal opens on the nearest clear spot beside you. It won't open in open water.
Walk through. You arrive at your claimed bed, or at the starting stones if you haven't claimed one.
Anyone else can press E on the return gate to go back to the portal, and come home again as often as they like while it's open.
When you press E on the return gate, it says Return and close. You go back and both ends close. They don't wait for anyone, so send your friends through first.
If nobody closes it, the portal and return gate disappear after 15 minutes. The timer runs in real time, so sleeping doesn't shorten it, and logging out doesn't close it early.

While the portal is open, the map shows a marker labeled "[name]'s town portal". The marker is hidden while the person who opened it is offline, but the portal stays open until its time runs out.

Opening a new portal replaces your old one.

The portal uses the game's own wood portal model, loaded from your game when you play. No Valheim files are included in this package.

Settings

Settings are in BepInEx/config/com.townportal.mod.cfg, which is created the first time you start the game with the mod. If you play on a server, use the same settings on the server and on every player's PC. Restart the game after changing the cooldown or duration.

Setting	Default	What it does
Open	Left Alt + H	Key that opens a portal
CooldownSeconds	300	Rest time before you can open another portal
DurationSeconds	900	How long a portal stays open
MysteriousTomeDropChance	0.25	Chance that a chest has a Mysterious Tome
HaldorPrice	250	What Haldor charges for a Mysterious Tome
HaldorRequiresElder	true	Haldor only sells it after the Elder is dead
SearchRadius	6	How far from you, in meters, the portal can open
PortalYawOffset	0	Set to 180 if the portal frame faces the wrong way
ShowGateNames	true	Shows the owner's name floating above return gates. Only changes what you see.
LogChestPrefabs	false	Writes chest names to the log, for troubleshooting
ServerLookupTimeout	10	Runic Spawn Point. Seconds to wait for the server to say where your stone is
AreaLoadTimeout	45	Runic Spawn Point. Seconds to wait for the area and the boat to load when you respawn
ResnapSeconds	5	Runic Spawn Point. How long after a respawn you get put back on deck if you fall off
VerboseLog	false	Runic Spawn Point. Logs every respawn step, for troubleshooting

Console commands

With devcommands turned on:

Command	What it does
`spawn TownPortal_MysteriousTome 1`	Drops a Mysterious Tome at your feet
`spawn TownPortal_Tome 1`	Drops a finished Tome of Town Portal
`spawn BatBoys_BoatSpawnTotem`	Places a Runic Spawn Point stone
`townportal_clear`	Removes every town portal, return gate and map marker, and resets the timers. Save the world afterwards.

Known limitations

There is no PvP lock yet. Anyone who reaches your portal can follow you home until it closes.
The mod's own text is English only.