NarcLab DevTools

NarcLab DevTools

NarcLab DevTools provides server-authorized Valheim devcommands and unrestricted

network prefab spawning for explicitly trusted dedicated-server administrators.

WARNING

NarcLab DevTools gives authorized administrators powerful world and gameplay

commands, including unrestricted network prefab spawning. Only grant native

Valheim server-admin privileges to players you trust. Large spawn quantities

can heavily affect server performance; avoid extreme creature or object counts

on production worlds.

Qualified environment

• Valheim 1.0.12 (network version 40)
• BepInExPack Valheim 5.4.2333
• Dedicated multiplayer server

Installation

Install the package on the dedicated server and on each administrator client

that needs DevTools commands. A compatible mod manager can install the package,

or the DLL can be placed through the normal BepInEx plugin mechanism.

Authorization is server-authoritative. The public default is

AuthorizationMode = DevToolsAdmins; the player's stable platform identity must

be present in:

BepInEx/config/NarcLabDevTools/adminlist.txt

Add one identity per line. The validated Steam form is

Steam_. Blank lines and lines beginning with # are ignored.

Malformed entries are ignored safely. A missing list is created automatically

and remains empty, which grants nobody. Restart the server after editing it.

Available authorization modes in

BepInEx/config/ca.narclab.valheim.devtools.cfg:

• DevToolsAdmins: requires the dedicated DevTools admin list.
• ValheimAdmins: requires Valheim's native server-admin authorization.
• Either: accepts either source.
• Both: requires both sources.

Display names and client-side admin state never grant access. The old

RequireServerAdmin and AllowAdditionalSteamIds settings are not active in

0.1.4; AuthorizationMode is the single mode selector.

Usage

Open the F5 console. You do not need to enter devcommands first.

Validated examples:

spawn Wood 1000

spawn Coins 50

spawn Boar 1

god

fly

nocost

players

listkeys

spawn accepts an amount from 1 through 1000 inclusive. Prefab names are

case-sensitive in the qualified version and are resolved dynamically against

the current server's network prefab registry. Unknown or non-networked prefabs

are rejected. Item stacks are split according to the prefab's current maximum

stack size; non-item objects are created as server-owned network objects.

The players command provides an authenticated server player list. Other

available commands follow the current Valheim command registry. Some

client-local commands require a connected player character and execute on the

authorized client only after a fresh server authorization response.

NarcLab Resources compatibility

NarcLab Resources 0.1.1 is optional and is not a hard dependency. When both

mods are installed on the server and client:

• authorized administrators receive DevTools spawn behavior;
• non-admin players fall through to NarcLab Resources;
• non-admin players can still spawn only Wood and Stone through Resources.

Runtime testing also confirmed that a Resources-only client continues to work

when DevTools is installed on the server.

Unmodded clients

A fully unmodded Valheim 1.0.12 client was able to join the qualified dedicated

server, load the world, remain connected, see vanilla Wood and Stone drops, and

pick them up normally. Unmodded clients do not receive DevTools commands.

Dedicated-server notes

• DevTools commands require the plugin on both the dedicated server and the

administrator client.

• Authorization is checked for each request by the server.
• The dedicated DevTools admin list is independent from Valheim's native list

in the default mode.

• Requests are rate-limited and protected against replay.
• Spawned objects must be current registered network prefabs.
• The mod does not provide arbitrary server filesystem, reflection, or shell

command access.

NarcLab DevTools is not affiliated with or endorsed by Iron Gate Studio.