commit 00b9388936a5470da1442f8a8ef0c2ba1e957c48 Author: the_minisip Date: Thu Sep 24 17:42:03 2026 -0300 Add Home diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..8d8e4bd --- /dev/null +++ b/Home.md @@ -0,0 +1,19 @@ + + +

Managed Valheim Server — Overview

This project provides a fully automated, self-updating, BepInEx‑patched Valheim dedicated server designed for TrueNAS SCALE and other containerized environments. It includes SteamCMD installation, mod patching, managed startup, and optional world backup automation.

Core Features

SteamCMD Auto‑Install & Auto‑Update

Server installs and updates itself on container start.
Uses anonymous SteamCMD login.
Verifies installation and applies updates automatically.

BepInEx Managed Integration

Downloads the official BepInExPack Valheim from Thunderstore.
Validates and extracts the pack.
Applies custom patches:
- Password override fix
- Launch command rewrite
- Managed wrapper installation

Managed Wrapper (`start_server_managed.sh`)

Handles server startup.
Ensures correct savedir path.
Passes environment variables cleanly.
Supports background tasks (e.g., backup loop).

World Backup System

Optional automated backups via wrapper.
Uses /backups volume.
Creates timestamped .zip archives of world directories.
Requires zip installed in the container (now fixed).

TrueNAS SCALE Ready

Exposes Valheim ports (2456–2458 UDP).
Uses /config and /backups volumes.
Logs accessible through TrueNAS UI.

Directory Layout

+Path | Purpose +-- | -- +SteamCMD installation +Valheim server root +World saves +Managed backup output +Main startup script +Optional standalone backup script +Managed wrapper + +

Startup Flow

Container starts → entrypoint.sh runs.
SteamCMD installs/updates Valheim.
BepInEx pack downloaded & patched.
Managed wrapper installed.
Wrapper launches server with correct flags:
- -name
- -world
- -savedir
- -password
- -public
Server boots, loads world, begins accepting connections.

Logging

SteamCMD logs: /root/Steam/logs/
Valheim logs stream to container stdout (TrueNAS UI).
BepInEx logs appear under /opt/valheim/BepInEx/.

Backup Behavior

Wrapper runs a background loop (default: hourly).
Each cycle:
- Checks world directory.
- Creates ZIP archive in /backups.
- Logs success or warnings.
World auto-backups (Valheim internal) continue normally.

Requirements

TrueNAS SCALE or Docker environment.
Mounted volumes:
- /config
- /backups
Ports 2456–2458 UDP exposed.
zip installed in container (added in your updated Dockerfile).

Known Non-Issues / Safe Warnings

These appear in logs but do not affect server operation:

DllNotFoundException: libParty.so +(PlayFab Party SDK — unused by dedicated servers)
Shader fallback warnings +(headless Unity server)
OnGUI function detected… +(IMGUI stripped — normal)

+ + \ No newline at end of file