Xpert's Drone Cam

The DroneCam allows you to join a multiplayer game as a drone, flying around, following, orbiting, and tracking a player or enemy. It works with un-modded, vanilla servers and MP games as well as modded ones. You simply join the game, enable the drone cam and then become an omnipotent spectator. Handy for tracking the Valheim action from a completely independent vantage point.

Built for Xpert Malfunction and shared to the community.

Requirements

• BepInEx 5.x
• Valheim (Unity 6 build)

Installation

Place XpertsDroneCam.dll in your BepInEx/plugins/ folder. If you are using the Spout or NDI streaming features, see the Streaming section below.

Overview

When the drone cam is active your character becomes invisible to other players, is protected from damage, and does not count toward enemy difficulty scaling. You can fly freely around the world, follow a specific player from behind, orbit a player or point of interest, or set up a fixed security camera that tracks a moving target.

If the player you are targeting goes through a portal to a distant part of the map, the drone will automatically teleport to follow them.

Commands can be entered in two ways:

• In-game console type dc followed by a subcommand, e.g. dc follow player Xmal
• Chat window type /dc followed by the same subcommand, e.g. /dc follow player Xmal

Player names that contain spaces must be wrapped in quotes in both the console and chat, e.g. dc follow player "Big Viking".

Key Bindings

Full Command Reference

All commands are entered as dc <command> <subcommand> <parameters> in the console, or /dc <command> <subcommand> <parameters> in chat.

Commands Table

Parameter units:

Abbreviated Commands Table

Every command and subcommand has a short alias for faster typing.

Examples using short forms:

dc f p Xmal
dc o e Troll 15 45 6
dc te
dc te Troll
dc te c
dc st on ndi 1920 1080

Command Details

on / freefly / ff

Activates the drone cam in free-fly mode. Your character is hidden from other players and the camera detaches and floats in place. Use WASD/QE to move, hold Shift to move faster, and hold Right Mouse Button to look around.

dc on
dc freefly
dc ff

off

Deactivates the drone cam and returns you to the normal third-person camera. Your character reappears at the last safe ground position near where the drone was.

dc off

hud

Toggles the game HUD (health bar, stamina, hotbar etc.) on and off. Useful for clean recording footage. The crosshair is always hidden while the drone is active regardless of this setting.

dc hud

snap

When following or orbiting a player, instantly moves the drone to the correct relative position near that player. Useful if the drone has drifted or you want to quickly reframe after issuing a new follow or orbit command. If the player is far away the drone will teleport to them.

dc snap

players

Lists all players currently connected to the server in the chat window. Players shown with (distant) next to their name are in an area of the map that is not currently loaded on your client ? the drone will automatically teleport to them if you target them.

dc players

follow player

Follows a named player from behind at a set distance. The camera stays behind the player and looks toward them as they move. Use the mouse wheel to adjust the follow distance and Alt + mouse wheel to adjust the height offset above the player.

dc follow player Xmal
dc follow player Xmal 8
dc follow player Xmal 8 3 0.2
dc f p "Big Viking" 5 2

If the player is in a part of the map that is not yet loaded, the drone will automatically teleport there.

follow enemy

Follows the nearest enemy with the given display name (the name shown when you hover your crosshair over an enemy in game). The camera stays behind the enemy and looks toward it.

dc follow enemy Troll
dc follow enemy Troll 10 4
dc f e "Fuling Berserker" 8 3 0.15

Parameters are the same as follow player.

orbit player

Orbits continuously around a named player at a fixed radius and height. The camera always looks toward the player while orbiting. Use the mouse wheel to adjust the orbit radius, Alt + mouse wheel to adjust height, and Alt + Ctrl + mouse wheel to adjust speed.

dc orbit player Xmal
dc orbit player Xmal 15 20 6
dc o p "Big Viking"

orbit enemy

Orbits the nearest enemy with the given name. Parameters are the same as orbit player.

dc orbit enemy Troll
dc orbit enemy Troll 12 25 5
dc o e Bonemass 20 15 8

orbit pos

Orbits around the point in the world that the drone camera is currently looking at. Position the drone first in free-fly mode, aim at your point of interest, then issue this command.

dc orbit pos
dc orbit pos 10 30 4
dc o pos 20 20 6

orbit speed

Changes the orbit speed while already orbiting without stopping or restarting the orbit.

dc orbit speed 15
dc o s 60

security player

Locks the drone in place at its current position and continuously rotates to track a named player as they move around. The camera does not follow the player ? it stays fixed and only rotates, like a security camera mounted on a wall.

dc security player Xmal
dc s p "Big Viking"

security pos

Locks the drone in place and tracks the point in the world you are currently looking at. The camera rotates to keep that point in frame as the drone stays fixed.

dc security pos
dc s pos

targetenemy

Sets an enemy as the look-at target. When a look-at target is set, the camera always points toward that enemy regardless of what the anchor target is. For example you can orbit a player while keeping the camera pointed at a nearby enemy instead of at the player.

dc targetenemy
dc targetenemy Troll
dc targetenemy clear
dc te
dc te Troll
dc te c

If used with no name, targets the nearest enemy. Use clear or c to release the look-at lock and return to pointing at the anchor target.

Targeting enemies by pointing

Press T while the drone is active to target the enemy in the center of your view and lock the camera look-at onto them. This works independently of the anchor target ? you can orbit a player while the camera constantly looks toward a nearby enemy.

Press T again while pointing at the same enemy to release the look-at lock. Press T while pointing at a different enemy to switch targets. Press T while not pointing at any enemy to clear the current target.

The selection cone angle can be adjusted in the config file with SelectEnemyConeAngle. The default of 3 degrees works well for enemies at typical combat range. Increase it if you have trouble targeting enemies at distance.

Selecting players by pointing

Press Left Click while the drone is active to target the player in the center of your view. The drone will immediately apply the last tracking mode you used (follow, orbit, or security) at the last settings used, targeting the player you are pointing at. This makes it easy to fly between players and lock the camera on each one in turn.

If no player is within the selection cone, nothing happens. The selection cone angle can be adjusted with SelectPlayerConeAngle in the config file.

F7 - free-fly toggle

Press F7 while tracking a player to instantly switch into free-fly mode without losing your tracking settings. Press F7 again to return to the same player, same mode, and same parameters you were using before. This is useful for repositioning the drone without losing your current target.

stream on

Starts broadcasting the drone camera view as a video stream that can be captured in OBS or other software. Requires KlakSpout (for Spout) or KlakNDI (for NDI) to be installed alongside the mod. See the Streaming section for setup instructions.

dc stream on
dc stream on spout
dc stream on ndi
dc stream on spout 1920 1080
dc stream on ndi 2560 1440
dc st on ndi 3840 2160

stream off

Stops the active video stream.

dc stream off
dc st off

stream res

Changes the resolution of an active stream without stopping and restarting it.

dc stream res 2560 1440
dc st res 3840 2160

Streaming

The drone cam can broadcast its view as a live video feed that OBS or other capture software can pick up. Two protocols are supported:

Spout is the recommended option for most users. It shares the video directly between programs on the same PC with no encoding overhead and no network required. To use it:

1. Install the OBS Spout2 plugin
2. Place Klak.Spout.Runtime.dll and KlakSpout.dll in your BepInEx/plugins/DroneCam/ folder
3. Place the dronecam_spout asset bundle file in the same folder
4. In OBS add a Spout2 Capture source and set the source name to DroneCam
5. Start streaming with dc stream on spout

NDI works over a local network, so OBS can be running on a different PC from Valheim. To use it:

1. Install NDI Tools on both the Valheim PC and the OBS PC
2. Install the OBS NDI plugin
3. Place Klak.Ndi.Runtime.dll and KlakNDI.dll in your BepInEx/plugins/DroneCam/ folder
4. In OBS add an NDI Source and set the source name to DroneCam
5. Start streaming with dc stream on ndi

Configuration

A configuration file is created at BepInEx/config/com.oathorse.xdc.cfg after the first run. The following settings can be adjusted:

Notes

• Your character is hidden from other players while the drone is active. Other players will not see your character model anywhere on the map.
• Your character cannot take damage while the drone is active.
• Nearby enemies do not scale their difficulty based on your presence while the drone is active.
• If the server has a sleep vote and all other players are sleeping, the drone will automatically suspend itself so your character can participate in the sleep vote, then resume when the night ends.
• Portals in the world cannot teleport the drone. Only the drone's own targeting system can initiate teleports.
• The drone camera can target players anywhere on the map, even in areas that are not currently loaded. It will automatically teleport to reach them.
• Player names are not case-sensitive in commands.
• Enemy names in commands use the same display name shown when you hover over the enemy in the game, not the internal creature name.

Version History

v0.2.0

• Added "track the thing I'm pointing at" functionality for swapping and out of free fly more easily.

v0.1.28

• Fixed bug where drone player was visible to target player shortly after teleporting to be with him

v0.1.27

• Fix teleport/distant player target acquire/reacquire problem
• Use PlayerInfo instead of ZNetPeer and modify player teleport/distant player check to use it

v0.1.26

• Fixed lock on problems using ZNetPeer, but still doesn't follow the player through portals

v0.1.25

• Fix bug where teleport would happen even if the player's ZDO had a valid Player object
• Fixed bug where drone would fail to reacquire player target

v0.1.24

• Fix player name quoted string parsing bug
• Allow drone to re-acquire target after teleporting, either through portal or to reach distant player

v0.1.23

• Use standard Player.TeleportTo() functionality instead of trying to move the drone to the player's new location when they teleport. Applies to cycling to distant players on servers as well.

v0.1.22

• When a net peer is found, but has no associated ZDO due to distance/unloaded state, use peer's location for moving camera and loading zone

v0.1.21

• Fix Console argument parsing bug

v0.1.20

• Added vertical offset for focal point, adjustable with scroll wheel while holding control
• Allow console commands to be entered via the dev console as well as the chat console

v0.1.19

• Use ZNetPeer to get list of players in game (on server)

v0.1.18

• ZDO based player name lookup everywhere

v0.1.17

• added /snap command to snap drone to player position and rotation, useful for teleporting to player position without having to wait for the drone to catch up
• refactored code to use the same function for snapping to player position on teleport and for the new snap command

v0.1.16

• use ZDO to look up players, and get player position

v0.1.15

• added grace period for reacquiring player target after teleporting to prevent rapid reacquisition if player is still in the process of teleporting/loading in

v0.1.14

• use the body position to determine player teleport and not the position on the player's transform?

v0.1.13

• remove SetSleeping patch and simply poll for sleep state
• Don't use drone TeleportTo() and simply snap the drone to the player's new position, moving the drone's rigid body so zone loading occurs

v0.1.12

• wait for player to fully reappear after teleporting before trying to reacquire target
• push sleep state for all players to server after setting it for drone so server has current data before checking for all sleepers

v0.1.11

• when switching from player or enemy targeting to position targeting, use the last position it was looking at. Should make setting up orbits easier.
• hide wet effect on drone for both client and server when drone passes though water
• use a fake bed when trying to get drone to sleep
• scan for player every tick rather than caching its target point to make it possible to reacquire after going through portal

v0.1.10

• another attempt at sleeping when player sleeps
• don't get the drone wet when passing through water
• use built in teleport function when player teleports rather than trying to relocate drone
• sleeping now uses "in bed" setting when drone tries to sleep

v0.1.9

• fixed a bug with command line interpret

v0.1.8

• Unified targeting for player/enemy/pos
• added /dronecam follow enemy and /dronecam orbit enemy commands specifying enemy name for nearest enemy
• added /dronecam hud command to toggle HUD visibility

v0.1.7

• fixed a chat console entry bug

v0.1.6

• added /dc targetenemy target nearest enemy for look-at
• added /dc targetenemy <name> target named enemy for look-at
• added /dc targetenemy clear clear enemy target

v0.1.5

• fixed bug where /dc was ignored
• prevent drone player from falling to death when turning /dronecam off
• dronecam now no longer prevents players from sleeping
• fix to re-aquiring player target after player goes through portal
• made sure drone can't be hit or die (should be in god/ghost mode)
• make Valheim server ignore drone with regards to difficulty scaling
• added modifiers (alt and ctrl) for scroll wheel to adjust drone distance and height on the fly
• added keys '.' and ',' to cycle the drone's target through players on the server

v0.1.4

• added requested features v0.1.0
• Initial Release