Valheim · Jötunn · 1.0.15

Town Portal

A blue wood portal back to the bed you have claimed. Anyone can follow. The caster's trip home closes both ends.

Thunderstore package. The dll is already inside. Upload the zip as-is.

Spawn

Turn on devcommands, open the console, and drop either book at your feet. No Elder, chest, or workbench required.

spawn TownPortal_MysteriousTome 1
spawn TownPortal_Tome 1

The first is the ruined Mysterious Tome, the recipe piece. The second is the finished Tome of Town Portal.

If a door, the cooldown, or an old map marker gets stuck, the same console clears every town portal in the world, both buffs, and the markers. Save once afterward. They stay gone.

townportal_clear

Use it

Keep the Tome of Town Portal anywhere in your inventory. It is not equipped, and the door does not consume it.
Press Left Alt + H.
A wood portal opens on the nearest clear spot beside you. The glow is blue. It has no tag and does not pair with other portals. While it is up, the map shows a blue circle labeled with the caster's name.
Walk through. You arrive at the caster's claimed bed, or the starting stones if they never claimed one.
A blue field about one Viking tall stands there. It does not push players, creatures, or furniture. The hover text shows the time left.
Anyone else presses E to go back to the door, and the pair stays up. They can walk through again.
If you opened it, the hover says Return and close. You go back, and both ends disappear. Send visitors through first.
If nobody closes it, the door, the field, and Nowhere Like Home all end together at 15 minutes. Logging out does not remove them early.

Opening a door starts The Tome Rests for 5 minutes. A new door replaces your previous one, including a return field in an unloaded area. Followers go to your bed, not theirs. Each person is checked for portal-blocked cargo.

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

Ingredient

Amount

Mysterious Tome

1, consumed

Surtling core

Greydwarf eye

Leather scraps

Deer hide

Mysterious Tome

A ruined book. The way home is still written in it, for someone willing to make it whole.

It does not stack. Each copy takes its own inventory slot.
Extra roll on loot chests in the Meadows and the Black Forest. About 1 in 4 also contain one tome.
The roll is separate. Axe heads and every other drop stay on their own tables.
Barrels are skipped. Chests a player placed are skipped.
Chests that already exist roll once, the first time they load with this mod, including chests you have opened before.
Haldor sells one for 250 coins after the Elder is dead. A tome found earlier still crafts.

On the ground both tomes are the strapped leather book. The finished tome uses that icon. The mysterious tome keeps a plain brown icon so the two are easy to tell apart.

Rules

These match a wood portal. The mod does not call portal code to do it.

NoPortals seals the tome. The deny sound plays and nothing is placed.
NoBossPortals seals it while a boss is loaded.
TeleportAll lets every item through. Otherwise each item's own teleport flag is checked.
Open water is refused. The door still opens beside you at the starting stones, inside a camp, or in grass. The deny sound is only "The door has nowhere to open."
The wood frame keeps its collision. Only the return field is non-solid.
The timer is real time. Sleeping does not burn it down.
The caster's return removes Nowhere Like Home immediately. The Tome Rests still finishes its 5 minutes.

Config

BepInEx/config/com.townportal.mod.cfg. The server's copy wins for every row except the open key. A saved Alt+T or Shift+T binding is switched to H + LeftAlt the next time the game starts. Restart after changing cooldown or duration.

Section	Key	Default
Client	Open	Left Alt + H
Server	CooldownSeconds	300
Server	DurationSeconds	900
Server	MysteriousTomeDropChance	0.25
Server	HaldorPrice	250
Server	HaldorRequiresElder	true
Server	SearchRadius	6
Server	PortalYawOffset	0
Debug	LogChestPrefabs	false

If the wood frame faces the wrong way, set PortalYawOffset to 180. LogChestPrefabs writes one line per container prefab the first time it is seen.

Test pass

spawn TownPortal_Tome 1, then Alt+H. The blue wood frame is not on the portal list and has no tag.
Walk through. You arrive at your bed, the return field is there, and its countdown matches Nowhere Like Home.
A second character presses E and the door stays. You press E, it says Return and close, and both ends vanish. The tome is still resting.
After 5 minutes a new door replaces any previous one, even if that field was far away.
Ore is refused with the same message a wood portal uses. Drop it and the door works.
On a world with portals disabled, Alt+H plays the deny sound and places nothing.
After the Elder, Haldor sells a Mysterious Tome for 250 coins.
Meadows and Black Forest loot chests sometimes hold an extra tome. Axe heads that were there are still there.
A follower who walks through arrives at the caster's bed, not their own.

Not in this version: a PVP lock, a custom book mesh, and translations. Custom lines are English. The cargo refusal uses the game's own message.

Town Portal

Spawn

Use it

Recipe

Mysterious Tome

Rules

Config

Install

Test pass