Sylwis Charm v1.8.2

An ethereal, glowing companion orb that follows the player, built with reliable multiplayer synchronization.

This mod introduces a persistent, visually appealing orb that floats above and behind the player character. It is designed to be fully functional and stable in multiplayer environments, specifically handling instant, long-distance travel (like using portals) by instantly snapping the orb to the owner's new location for all observers.

Features

• Ethereal Companion: A constantly orbiting, glowing blue sphere that gently hovers above and behind the player.
• Toggle Key: Summon or dismiss the orb using the F8 key.
• Multiplayer Safe: Uses RPCs and intelligent movement logic to ensure the orb's position is accurately synchronized for all players in the game.
• Teleport Correction: Includes a built-in logic to instantly snap the orb to the player's position if they travel more than 50 meters in a single frame (e.g., using a portal), preventing the common "stuck orb" bug for observers.

Installation (Thunderstore Mod Manager)

1. Install Thunderstore Mod Manager or r2modman.
2. Search for Sylwi's Charm and click Install.
3. Ensure the required dependency, BepInExPack Valheim, is also installed.

Manual Installation

1. Make sure you have BepInExPack Valheim installed.
2. Download the latest release ZIP file.
3. Extract the Sylwi's Charm.dll file from the ZIP.
4. Move the Sylwi's Charm.dll file into the BepInEx/plugins folder of your Valheim installation.

Known Issues

Changelog

v1.8.1

• Implemented instant snap logic (TeleportSnapDistance = 50m) to ensure the orb synchronizes instantly after portal travel for all players (owner and observers).
• Added comprehensive player cleanup logic for better stability on death/logout.
• Fixed RPC signature for Dismiss function.

v1.8.2

• replaced icon

Changelog

v1.8.7

• Unified orb spawn and dismiss logic under a single, synchronous network broadcast to improve multiplayer reliability.

v1.8.6

• Reworked orb movement to correctly hover over water and elevated platforms, while ensuring it consistently clamps to the local terrain height when traveling to prevent ground clipping.

v1.8.5

• Fixed dependency.

v1.8.4

• Orb Movement Stability: Fixed a critical bug in the orb's movement logic (UpdateOrbMovement) which prevented it from smoothly tracking the player's speed (walking vs. running). The orb now reliably uses the player's actual velocity magnitude, ensuring consistent and correct follow behavior.
• Configurable Summon Key: The key used to summon and dismiss the orb is now fully configurable via the BepInEx config file (com.miha.sylwiisorb.cfg). Each player can set their own local preference without affecting the server.

v1.8.3

• Resolved an issue where the orb would briefly drop and halt before fully despawning after a manual dismissal (F8). The fix implemented a deferred cleanup state flag to ensure the orb's destruction is safely handled.

v1.8.2

• Replaced icon.

v1.8.1

• Implemented instant snap logic (TeleportSnapDistance = 50m) to ensure the orb synchronizes instantly after portal travel for all players (owner and observers).
• Added comprehensive player cleanup logic for better stability on death/logout.
• Fixed RPC signature for Dismiss function.