Sagas

Sagas

Sagas is an optional extension. It adds map, stories, armory and recent rankings pages to your installed website. The home page summarizes recent shared moments and feats. You can arrange their links in the site menu (Layout Editor → Menu). The pages are part of your site; installing the game client and server bridge is a separate choice.

The screenshot uses illustrative data.

Set it up

1. Install Heimdall Nexus and BepInEx on the Valheim server first.

2. In the Nexus checkout, install the bridge included with this release:

   cd ~/Heimdall-Nexus
   git switch main
   git pull --ff-only origin main
   sudo ./deploy/update.sh
   sudo ./deploy/install-sagas-extension.sh "$PWD/dist/sagas/HeimdallSagas.Bridge.dll"

   On Windows, use an administrator PowerShell with Valheim stopped:

   cd C:\HeimdallNexus-src
   & "$env:ProgramFiles\HeimdallNexus\venv\Scripts\python.exe" deploy\windows\install-sagas.py dist\sagas\HeimdallSagas.Bridge.dll

3. Restart Valheim from Jarl → Console to load the bridge. Bridge installation does not restart the game automatically.

4. On each participating computer, download the client 0.2.1 ZIP and extract it into the game folder. The result should be BepInEx/plugins/HeimdallSagas/HeimdallSagas.Client.dll. The bridge DLL belongs only on the server; the client DLL belongs only in the player's game.

5. Open Jarl → Sagas and follow the Para funcionar requirement cards. Enable only the features you want.

6. Each player controls consent in the client's Privacy configuration. Every option starts off:

   Option	Shared data
   ShareProfile	Public name, presence and equipment.
   ShareMap	Biomes and event locations; public display also requires ShareProfile.
   SharePosition	Live position when Valheim's own public map setting is also on.
   ShareStories	Shared facts for chapters; requires ShareProfile.

Revoking profile sharing deletes retained events. Revoking map sharing erases saved coordinates and biomes. Revoking story sharing deletes chapters that mention the player. Public reads also check current consent.

Map and halls

The Birds Eye atlas uses layers calculated by the bridge and locally served tiles. Known lands reveals terrain within 700 m of shared locations; Full world reveals every biome and may spoil exploration. Individual in-game exploration fog is not captured yet.

Armory

The Armory is each viking's profile, in the style of a character sheet: a 3D portrait, the equipped gear with the game's own icons (modded items included), quality, durability, stats, effects and gem sockets, the hotbar and vital stats. The client takes the portrait when the viking is standing in the world, again when the look or gear changes, and whenever you press F9; it needs ShareProfile. The [Portrait] section of the client configuration adjusts it:

Option	Default	Effect
Enabled	on	Send a portrait at all.
RefreshKey	F9	Take the portrait again now.
Ambient, KeyLight, FillLight	.62, .8, .35	Soft, main and fill light.
Reflection	.65	Shine on metal armor.
FieldOfView	12	Camera lens; lower looks flatter.
CameraAngle	.2	Turn of the camera around the viking; 0 is straight ahead.

Pictures are checked and cleaned on the server and served only while the player shares the profile; the admin can hide equipment in Jarl → Sagas. The page background is /assets/armaria-bg.webp. Add /assets/armaria-<biome>.webp (prados, floresta-negra, pantano, montanha, planicies, terras-nebulosas, terras-de-cinzas, extremo-norte, oceano) to change it to the biome of the viking's last shared moment; that needs ShareMap.

Rankings

Rankings is currently a limited view of the latest 100 public moments, with its scoring rules on the page. Full time-window rankings and trophies are still planned. Pages explain when no shared data is present.

AI stories

In Jarl → Sagas → Histórias, enable stories, choose OpenRouter, OpenAI, Anthropic or Gemini, save that provider's API key and set a daily limit. Gerar história tests generation from available facts. Automatic chapters use new boss kills and discoveries after automation is enabled. A provider's chat subscription may not include API access; review its separate billing and limits. The Nexus sends selected, consented facts only. API keys stay on the server, outside browser responses and logs.

Public chapters are labeled as AI fiction and cite the real shared records that inspired them. The requirement card explains missing setup or consent.

Updates and limits

In Jarl → Sobre e atualizações, check for an update on the stable channel and approve the reviewed version. An update replaces an installed bridge by itself; restart Valheim afterward to load it. Player computers do not receive client updates automatically.

Individual login, real exploration fog, journey replay, trophies and advanced mod integrations remain on the roadmap. Version 1.0.0 refers to Heimdall Nexus; the Sagas DLLs are versioned separately (bridge and client 0.2.1).