Runic Sentinel Server 1.3.0

Runic Sentinel Server manages approved mods, player admission, administrator permissions and bans on your dedicated server. Administrators connect using the full Runic Sentinel mod and its F3 dashboard.

Installation and setup

1. Install RunicSentinelServer on the dedicated server and RunicSentinel on the administrator's client. A listen host uses full RunicSentinel. Use only one of these two packages in each profile.
2. Install the dependencies listed by your mod manager, including Runic Safety. Ordinary players use RunicSentinelClient.
3. Start with Remote Admission → Policy = Optional in the server configuration.
4. Add your account ID to the server's adminlist.txt, join the game and press F3.
5. Select Set Up Sentinel, choose your mod policy, and select Apply & Sign Policy.
6. When your players' mod profiles are ready, set admission to Required and restart the server.

Keep the server's private key in BepInEx/config/RunicSentinel/server-private on the server. Keep your existing Sentinel configuration when updating.

F3 dashboard

• Mod Policy: search mods by name, choose Required, Allowed, Greylisted or Blocked, then select Apply & Sign Policy. Advanced rules let you specify versions and file restrictions.
• People: filter all people, online accounts, administrators or banned accounts. Manage administrator rights and bans, kick connected players, review recent activity and create player reports.
• Commands: enter a command and press Enter or Run. Browse the command guide, read command output, and toggle God, Ghost, Fly, Freefly, debug mode or no-cost building with live On/Off indicators. Sentinel authorizes each request; no separate Server Devcommands mod is required.
• Catalog: filter by mod or type and select an item or piece for its icon, internal ID, details and recipe. Build its arguments using quantity, applicable quality and qualifier controls, then append them to the selected console command. Review the console line and press Run.
• Players: select an online character to view observations and last-known position, use character commands, teleport, bring them to you or kick them. Administrator names carry an Administrator suffix. Account roles, bans and reports are managed in People.
• Server Cap: with Runic World Engine installed on the host, choose 2–64 players and select Save for Next Restart. Restart the host to apply the saved limit.

Administrator access

Server administrators have Sentinel access by default. Add your account ID to the server's adminlist.txt; for Steam, use V_<SteamID64>. Close and reopen F3 after changing the list.

To use only Sentinel roles, set UseServerAdminList = false under Administrator Access in the server configuration. Remove separately assigned Sentinel roles in the People tab when revoking access. Bans take precedence over administrator roles.

Commands and reports

This authority package contains no client profile reporter or F3 renderer, remains inert on a non-server client, and is intentionally incompatible with the full RunicSentinel plugin in the same process. Use the full plugin on the administrator's client and this package on the dedicated server.

The authenticated player-detail endpoint returns observations without scanning world objects. Explicit report requests create JSON, CSV and TXT files under BepInEx/config/RunicSentinel/PlayerReports. Object attribution uses current world creator metadata and is not verified account authorship or complete historical activity.

• runic_sentinel status shows the current policy and admission status.
• runic_sentinel report saves a support report in BepInEx/config/RunicSentinel/reports.
• runic_sentinel networks saves a snapshot of loaded portal and production networks from the host console.

Language files

The mod follows Valheim's selected language. Add translations in Translations/RunicSentinelServer beside the mod file. Missing translations use English. See TRANSLATING.md for instructions.

Support My Work

Enjoying the mods? You can support my work and future creations. Thank you for playing!

Support My Work

Dashboard update

Drag the lower-right corner to resize F3, or select Fit screen. Run, Clear Output and Insert into console remain outside the command-list scroll area. Use Arguments to browse parameters and installed completion options; hover a parameter for its explanation. Dynamic values depend on the installed command's completion provider.

People combines connected/session players with accounts from the native server access lists and signed policy. Administrator and Banned changes save native server files with backups; revoking a signed role also requires the server signing key. Native grants require UseServerAdminList=true. Self-removal is blocked to prevent lockout. Kick targets the authenticated connection. Offline access-list entries have no invented character location.

Admin Tools creates distinct health and network text reports, retains server copies and downloads complete copies to BepInEx/config/RunicSentinel/Reports on the administrator client. The network scan is a bounded sample of configured Runic links, not a full-world topology reconstruction. Player report previews remain explicitly bounded. Enforcement displays recent server evidence and explains threshold tradeoffs. The policy label names the signed rules, not an r2modman profile.

Selected-player actions

Administrators use the Players dossier in RunicSentinel 1.6.0 with RunicSentinelServer 1.3.0. Inline tools target the selected online character: teleport to them, bring them, move them to coordinates/another player, raise or lower/reset a skill, heal, clear food/status, set adrenaline, and apply a registered status effect. Skill changes follow native 0–100 clamping and character-save behavior.

The affected player needs either full RunicSentinel 1.6.0 or lightweight RunicSentinelClient 1.0.4 for character actions. Native teleport does not require the new receiver. Client-side cheat actions require the affected player's own prior confirmcheats acknowledgment; the administrator cannot silently acknowledge it for them. The UI disables unavailable receivers and waits for the exact target client's result. A timeout or disconnect is explicitly unconfirmed, not success. No arbitrary remote console execution is provided. Requests and replies are recorded in player activity.

Integrated command engine

The Server Devcommands 1.109 command/feature baseline is integrated into RunicSentinel 1.6.0 and RunicSentinelServer 1.3.0. Do not install the separate Server Devcommands plugin alongside these packages. Native Valheim commands remain available.

Examples:

• addstatus Rested 3600 applies one hour of Rested; addstatus Rested 6000 applies 100 minutes.
• addstatus Burning 20 100 supplies duration and supported effect intensity.
• alias rest addstatus Rested 3600 creates a shortcut; run rest from F3 or F5.
• bind F7 addstatus Rested 3600 stores a binding.
• fly; wait 1000; fly runs a chain with a delay in milliseconds. Each executable command receives fresh Sentinel authorization.

The command guide includes registered parameters and completion values. dev_config exposes the integrated gameplay/configuration options; permissions manages command and feature restrictions on the server. Automatic devcommands defaults off. Valheim's own explicit cheat confirmation remains required for cheat handlers.

Command configuration uses RunicSentinel.alias*.yaml, RunicSentinel.binds*.yaml and RunicSentinel.commands.permissions.yaml in BepInEx/config. Previous third-party configuration is not silently imported. The dedicated-server binary excludes client GUI/input modules. YAML parsing is embedded; there is no separate parser or command-mod installation step.

Character mode and status controls

Use RunicSentinel 1.6.0 on the administrator client, RunicSentinelServer 1.3.0 on the dedicated server, and RunicSentinelClient 1.0.4 or full RunicSentinel 1.6.0 on each player receiving character actions.

In Players, select an online character and choose On or Off beside God, Ghost, Fly or No-cost. Refresh character mode status reports that character's current modes. Grants last for the current connection and character; previous mode settings are restored on disconnect or character change. The affected player must run confirmcheats in their own F5 console before receiving cheat actions.

Choose a status effect and enter Duration (seconds). Leave duration blank for the effect's default, or enter 0 for indefinite duration. 3600 is one hour. Shields offer damage absorption; Burning and Poison offer total effect damage. Leave intensity blank for the effect's default. When intensity is entered without duration, the selected effect's default duration is used.

The full administrator client takes ownership of character actions when both Sentinel client packages are installed.

1.3.0

• Added authenticated selected-player God, Ghost, Fly and No-cost controls and mode-status results.
• Added duration and intensity parameters for selected-player status effects.
• Updated character-action compatibility for RunicSentinel 1.6.0 and RunicSentinelClient 1.0.4.

1.2.0

• Integrated Server Devcommands 1.109 command and feature baseline into Sentinel; no separate Server Devcommands plugin is required.
• Added status-effect duration and intensity, command aliases/chains/waits, bindings, parameter autocomplete, command permissions and gameplay options.
• Preserved Sentinel backend administrator checks and connection-bound command requests; expanded chains authorize each executable command separately.
• Adapted Valheim 1.0 API changes; YAML configuration support is embedded in the shipped DLL.
• Command configuration files use RunicSentinel-prefixed names. Automatic devcommands is available but defaults off.

1.1.6

• Add selected-player actions through a bounded, exact-server/character RPC receiver: raise/reset skills, heal, clear food/status, adrenaline and registered status effects.
• Preserve affected-player cheat confirmation, reject replays and show acknowledged completion or failure.

1.1.5

• Repair the player roster transport with Valheim's bundled JSON serializer.
• Add authenticated native administrator/ban file changes, exact-peer kicking, file backups and role-source visibility.
• Add actual server/world metadata and recent enforcement findings.
• Generate distinct readable health/network reports and authenticated chunked downloads.

1.1.3

• Added server authorization for the F3 command dashboard, named server mod metadata, and administrator-only player reports.
• Added Server Devcommands as an installation dependency. Provider permissions remain required.
• Added per-mod language files using Valheim's selected language, with English fallback and no new plugin dependency.

Changelog

1.1.2 - 2026-09-14

• Fixed administrator connection recognition with ServerSync and Conditional Config Sync buffering sockets, including nested wrappers.
• Preserved native Steam and PlayFab identity verification without changing configuration-sync queues or permissions.
• Added specific diagnostics for unsupported socket wrappers and mismatched connections.

1.1.1 - 2026-09-14

• Fixed administrator setup rejecting Steam session-authenticated players when a connection certificate is unavailable.
• Kept authentication tied to the current connection, with session revocation and disconnect cleanup.
• Added specific connection-verification details to administrator error messages.

1.1.0 - 2026-09-12

• Added the authenticated server handler for full RunicSentinel 1.4.0's F3 Server Cap tab and RunicWorldEngine 1.2.x.
• Added running-cap, saved-cap, connected-player, and restart-status reporting.
• Added backed-up, stale-edit-protected saves for the cap override and 2–64 player limit, applied on the next restart without changing admission policy.
• Kept the server-only package free of client UI and admission-reporting code.

1.0.2 - 2026-09-10

• Added server-verified adminlist.txt access and first-time setup from the full Sentinel F3 panel.
• Added support for Steam raw, Steam_, and Valheim 1.0 V_ administrator ID formats.
• Preserved existing signed roles, bans, policies, and keys; setup leaves admission mode unchanged.
• Added an option to require signed Sentinel roles only and recheck access before cached panel responses.

1.0.1 - 2026-09-09

• Updated Required-mode admission for Valheim 1.0.7's invite-secret server handshake and reject a changed secret on the approved native resume.
• Moved the permanent fail-closed world gate to Valheim 1.0's common server-load boundary so both legacy and chunked saves are covered.
• Added complete chunked-world transition backups through Runic Safety 1.0.2's verified directory sources, with a hard 1,024-file ceiling.
• Updated the release dependency floor to BepInExPack Valheim 5.4.2350.

1.0.0 - 2026-09-09

• Added a distinct gold-and-ember authority icon with a fortified server-network badge.

• Added a distinct authority-only Sentinel package for dedicated servers and listen hosts.

• Added earliest-role preparation, exact authoritative-network lifetime tracking, and permanent Required-mode world-load and native-admission gates for authority-start failures; accidental player-only installations remain inert.

• Kept the v2 direct admission wire name compatible with Runic Sentinel Client and full Sentinel.

• Made the server-only and full authority packages mutually incompatible.

Authority package boundary

• Compiled out client profile reporting and administrator GUI code; the dedicated package only contains authority-side handlers.

1.2.1

• Fixed private-field access exceptions that interrupted player login and periodic network updates.
• Removed local-player ghost network hooks from the dedicated server and moved optional position updates out of player-list construction.

1.2.2

• Resolve character IDs from the current peer-owned character ZDO instead of the unused legacy peer PlayerID field.
• Restore matching player-action readiness and accurate roster IDs for administrator teleport targeting.
• Keep exact connection, ownership, character-change and disconnect checks; existing Sentinel Client 1.0.3 and full Sentinel 1.5.1 remain compatible.