ServerSideMapReborn

版本 v0.1.1·更新於 2026-09-13

Share explored areas and optional map pins through your server. Experimental Valheim 1.0.12 fork with a live-sync fix. Required on server and clients; multiplayer validation pending.

模組介紹 作者原文

ServerSideMapReborn

Share explored areas and map pins through your Valheim server. ServerSideMapReborn is an independent, experimental fork of Mydayyy/Valheim-ServerSideMap, adapted against Valheim 1.0.12.

Install this mod on the server and every participating client. Despite its name, it is not a server-only mod. Map sharing is enabled by default; pin sharing is optional and disabled by default.

Features

  • Share newly explored areas with connected players.
  • Merge explored areas when players connect.
  • Optionally share newly created map pins, including checked state and removal.
  • Save shared exploration and pins alongside the world.
  • Import existing local pins using chat commands.

Installation

  • Install the required BepInExPack Valheim dependency.
  • Disable or uninstall the original ServerSideMap, including the earlier experimental ServerSideMap.dll. This fork declares the original plugin incompatible to prevent overlapping patches.
  • Install ServerSideMapReborn on the server and every participating client, using the same mod version.
  • Start the server and clients to generate the configuration file.

For manual installation, place ServerSideMapReborn.dll in BepInEx/plugins/ServerSideMapReborn. Use the installation ZIP, not the source-code ZIP.

Configuration

Configuration file: BepInEx/config/local.valheim.serversidemapreborn.cfg.

[General]

EnableMapShare = true

EnableMarkerShare = false

To share pins, set EnableMarkerShare = true on the server and each participating client, then restart them. Existing local pins are not uploaded automatically. Create a new pin to test sharing, or use one of these chat commands:

  • /convertpins: upload existing local pins to the server.
  • /convertpins ignorelocaldupes: upload existing local pins while skipping nearby duplicates.
  • /downloadpins: convert shared pins into locally saved pins.

The duplicate-detection radius is controlled by DuplicatePinRadius in the configuration file.

Upgrading and migrating

When upgrading from ServerSideMapReborn 0.1.0, stop the server and clients, replace the DLL, and restart. Keep the existing configuration and exploration files. Do not leave multiple copies of the plugin installed.

When migrating from the original ServerSideMap, you can copy eu.mydayyy.plugins.serversidemap.cfg to local.valheim.serversidemapreborn.cfg while the game and server are stopped to preserve settings.

The original.mod.serversidemap.explored save suffix is retained to reuse existing shared exploration and pins. Back up this file before testing an update. Do not run both plugins against the same world.

Version 0.1.1: live map synchronization fix

Version 0.1.0 could discard live exploration updates because it looked for the removed private field Minimap.m_instance. Reconnecting used a different synchronization path, which could make the missing exploration appear after logging in again.

Version 0.1.1 uses the public Minimap.instance accessor, uploads pending map texture changes at the end of the frame, and restores temporary exploration suppression even if map loading throws an exception.

To check the fix, connect two players. Have one explore an unknown area while the other watches the map without moving or reconnecting. The newly explored area should appear during the session.

Compatibility and validation

  • Compiled against Valheim 1.0.12 game assemblies.
  • All 24 Harmony patch targets were verified through assembly metadata.
  • An isolated regression test reproduces the live-update failure in 0.1.0 and passes with the 0.1.1 correction.
  • Tests use Unity and network substitutes; this update still needs validation in a real multiplayer session.
  • Crossplay/PlayFab support has not been fixed or verified.
  • Compatibility with other map-changing mods has not been established.

Package identity

  • Package, assembly and namespace: ServerSideMapReborn.
  • Plugin and Harmony ID: local.valheim.serversidemapreborn.
  • Package/plugin version: 0.1.1.
  • Assembly/file version: 0

安裝與使用 安裝:BepInEx 外掛

  1. 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
  2. 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
  3. 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
  4. 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。

帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時,主機與所有用戶端需要安裝一致的模組。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

denikson-BepInExPack_Valheim

檔案與校驗

檔案名稱
ServerSideMapReborn-0.1.1.zip
檔案大小
23.2 KiB