valheim-oz-dsm 1.8.0 → 1.8.2

package/README.md

@@ -5,20 +5,22 @@
 
 ## About
 
-- This software is a dedicated server manager (DSM) for Valheim.
-- The Valheim DSM is part of the Land of Oz series of software.
-- This software is to provide an easy to use container and virtualization free
-  dedicate server hosting experience.
+**TL;DR:** A terminal-based Valheim server manager that doesn't need Docker, VMs, or a PhD in sysadmin.
+
+This is a dedicated server manager for Valheim that runs directly on your machine—no containers, no virtualization, just TypeScript and Node.js. Born from the "Land of Oz" series of server management tools, this project aims to make hosting a Valheim server as painless as possible.
+
+Whether you're running a private server for friends or managing a public realm, this tool handles the boring stuff (SteamCMD updates, crash recovery, config management) so you can focus on the Viking stuff (building, exploring, dying to Deathsquitos).
+
+[CONTRIBUTING.md](CONTRIBUTING.md) if you want to help make it better.
 
 ## Details
 
-- The software is written in TypeScript using Node.js as the runtime
-- The DSM program is a rich featured management tool with a Yoga powered TUI.
-  - The TUI uses Ink which is a React flavored TUI framework
-  - The motion in the TUI is accelerated by the ASCII Motion app.
-    - Any AI agent working in this repo has access to the ASCII Motion MCP
-      server tooling for generating beautiful and efficient animated ascii based
-      art.
+- **Runtime:** Node.js 22.x with TypeScript 
+- **TUI Framework:** Ink 6.x—React, but for your terminal 
+- **Layout Engine:** Yoga flexbox—the same layout engine that powers React Native
+- **Animations:** (ASCII Motion)[https://ascii-motion.app/]—why settle for static ASCII art when you can have *animated* ASCII art?
+- **State Management:** Zustand
+
 
 ## Quick Start
 
@@ -148,7 +150,7 @@ aesthetic. It prioritizes real-time observability while keeping management tools
 front and center. Below is a generalized mockup of the DSM TUI built using React
 via Ink. Motion is created using ASCII Motion.
 
-> The Valheim DSM: Land of Oz interface utilizes a structured three-zone TUI
+> The Valheim DSM interface utilizes a structured three-zone TUI
 > architecture designed for maximum administrative visibility. A bold animated
 > ASCII header anchors the top of the screen, followed by a responsive layout
 > that separates active management from passive monitoring. Where possible, the
@@ -164,11 +166,12 @@ via Ink. Motion is created using ASCII Motion.
 | Layer            | Technology       | Purpose                                          |
 | ---------------- | ---------------- | ------------------------------------------------ |
 | Runtime          | Node.js 22.x     | TypeScript-first with tsx execution              |
-| TUI Framework    | Ink 5.x          | React-based terminal UI with Yoga flexbox layout |
-| State Management | Zustand          | Lightweight, React-compatible global state       |
+| TUI Framework    | Ink 6.x          | React-based terminal UI with Yoga flexbox layout |
+| UI Library       | React 19.x       | Component-based rendering to terminal            |
+| State Management | Zustand 5.x      | Lightweight, React-compatible global state       |
 | Animation        | ASCII Motion MCP | Animated ASCII art for headers and transitions   |
 | Process Control  | child_process    | Cross-platform subprocess management             |
-| Configuration    | conf             | Persistent settings with JSON storage            |
+| Configuration    | conf 13.x        | Persistent settings with JSON storage            |
 
 ### Directory Structure
 
@@ -238,7 +241,7 @@ land-of-oz-dsm-valheim/
 │   ├── config/
 │   │   ├── mod.ts            # Configuration module exports
 │   │   ├── schema.ts         # Zod schemas for validation
-│   │   ├── store.ts          # Deno KV persistence layer
+│   │   ├── store.ts          # conf package persistence layer (JSON)
 │   │   └── defaults.ts       # Default configuration values
 │   │
 │   ├── valheim/
@@ -302,9 +305,9 @@ Handles all Steam-related operations:
 
 Persistent settings management:
 
-- **Deno KV**: Local key-value storage for settings
-- **Zod Validation**: Type-safe schema enforcement
-- **Migration Support**: Handle config version upgrades
+- **conf Package**: Cross-platform JSON-based configuration storage
+- **Zod Validation**: Type-safe schema enforcement with runtime validation
+- **Migration Support**: Handle config version upgrades gracefully
 
 #### 6. Valheim Integration (`src/valheim/`)
 
@@ -316,48 +319,78 @@ Game-specific functionality:
 
 ### State Flow
 
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                         Zustand Store                           │
-│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────────────┐ │
-│  │ server   │  │ config   │  │ logs     │  │ ui               │ │
-│  │ .status  │  │ .settings│  │ .entries │  │ .activeScreen    │ │
-│  │ .pid     │  │ .world   │  │ .filter  │  │ .modalOpen       │ │
-│  └──────────┘  └──────────┘  └──────────┘  └──────────────────────┘ │
-└─────────────────────────────────────────────────────────────────┘
-         │                │               │
-         ▼                ▼               ▼
-   ┌──────────┐    ┌──────────┐    ┌──────────┐
-   │ Process  │    │ Deno KV  │    │ TUI      │
-   │ Manager  │    │ Store    │    │ Renderer │
-   └──────────┘    └──────────┘    └──────────┘
-```
-
-### TUI Layout Zones
-
-```
-┌────────────────────────────────────────────────────────────────────┐
-│                    ╔═══╗ ╔═══╗ ╔═══╗                                │
-│  ZONE 1: HEADER    ║ L ║ ║ O ║ ║ Z ║  Animated ASCII Title          │
-│                    ╚═══╝ ╚═══╝ ╚═══╝  (ASCII Motion powered)        │
-├────────────────────────────────────────────────────────────────────┤
-│                                                                    │
-│  ZONE 2: MAIN CONTENT                                              │
-│  ┌──────────────────────┐  ┌─────────────────────────────────────┐ │
-│  │ [1] Dashboard        │  │ Server: ● ONLINE                   │ │
-│  │ [2] Settings         │  │ Players: 3/10                      │ │
-│  │ [3] Worlds           │  │ World: MyWorld                     │ │
-│  │ [4] Console          │  │ Uptime: 4h 23m                     │ │
-│  │ [Q] Quit             │  │                                    │ │
-│  └──────────────────────┘  └─────────────────────────────────────┘ │
-│                                                                    │
-├────────────────────────────────────────────────────────────────────┤
-│  ZONE 3: LOG FEED                                                  │
-│  [INFO]  Player "Viking01" connected                               │
-│  [INFO]  Player "Viking02" connected                               │
-│  [WARN]  High memory usage detected                                 │
-│  [INFO]  World saved successfully                                  │
-└────────────────────────────────────────────────────────────────────┘
+```mermaid
+graph TB
+    subgraph "User Interaction Layer"
+        TUI["TUI Components (Ink/React)"]
+        CLI["CLI Commands"]
+    end
+
+    subgraph "State Management (Zustand)"
+        Store["Global Store"]
+        ServerState["server: {status, pid, players}"]
+        ConfigState["config: {settings, world}"]
+        LogState["logs: {entries, filter}"]
+        UIState["ui: {activeScreen, modal}"]
+        Store --> ServerState
+        Store --> ConfigState
+        Store --> LogState
+        Store --> UIState
+    end
+
+    subgraph "Process Management"
+        PM["Server Process Manager"]
+        WD["Watchdog (Auto-restart)"]
+        LS["Log Stream Parser"]
+        PM --> WD
+        PM --> LS
+    end
+
+    subgraph "Persistence Layer"
+        Conf["conf (JSON Storage)"]
+        Worlds["World Files (.db/.fwl)"]
+    end
+
+    subgraph "External Systems"
+        Steam["SteamCMD"]
+        Valheim["Valheim Server Process"]
+        RCON["RCON Client (Optional)"]
+    end
+
+    TUI -->|User Input| Store
+    CLI -->|Commands| Store
+    
+    Store -->|Read/Write| Conf
+    Store -->|Start/Stop| PM
+    Store -->|Send Commands| RCON
+    
+    PM -->|Spawn| Valheim
+    PM -->|stdout/stderr| LS
+    LS -->|Parsed Logs| LogState
+    
+    Valheim -->|Events| WD
+    WD -->|Restart on Crash| PM
+    
+    ConfigState -->|Load| Conf
+    Conf -->|Load Worlds| Worlds
+    
+    CLI -->|Install/Update| Steam
+    Steam -->|Download| Valheim
+    
+    Store -->|React Updates| TUI
+    RCON -.->|Commands| Valheim
+
+    classDef userLayer fill:#F37A47,stroke:#B63C21,color:#fff
+    classDef stateLayer fill:#018DA6,stroke:#01657C,color:#fff
+    classDef processLayer fill:#FCF983,stroke:#000,color:#000
+    classDef persistLayer fill:#691E11,stroke:#B63C21,color:#fff
+    classDef externalLayer fill:#001018,stroke:#01657C,color:#fff
+    
+    class TUI,CLI userLayer
+    class Store,ServerState,ConfigState,LogState,UIState stateLayer
+    class PM,WD,LS processLayer
+    class Conf,Worlds persistLayer
+    class Steam,Valheim,RCON externalLayer
 ```
 
 ### Valheim Server Settings
@@ -383,12 +416,12 @@ The DSM exposes all Valheim dedicated server settings through the TUI:
 
 ### Platform Support
 
-| Platform      | SteamCMD Path                            | Valheim Install                             | Config Storage                                | Notes |
-| ------------- | ---------------------------------------- | ------------------------------------------- | --------------------------------------------- | ----- |
-| Windows       | `%LOCALAPPDATA%\steamcmd`                | `steamapps\common\Valheim dedicated server` | `%APPDATA%\valheim-dsm`                       | Fully supported |
-| macOS         | `~/Library/Application Support/steamcmd` | `steamapps/common/Valheim dedicated server` | `~/Library/Application Support/valheim-dsm`   | Fully supported |
-| Linux (Ubuntu)| `~/.local/share/steamcmd`                | `steamapps/common/Valheim dedicated server` | `~/.config/valheim-dsm`                       | **Requires 32-bit libs** (see Installation) |
-| Linux (Other) | `~/.local/share/steamcmd`                | `steamapps/common/Valheim dedicated server` | `~/.config/valheim-dsm`                       | Fully supported |
+| Platform      | SteamCMD Path                            | Valheim Install                             | Config Storage                              | Notes |
+| ------------- | ---------------------------------------- | ------------------------------------------- | ------------------------------------------- | ----- |
+| Windows       | `%LOCALAPPDATA%\steamcmd`                | `steamapps\common\Valheim dedicated server` | `%APPDATA%\oz-valheim`                      | Fully supported |
+| macOS         | `~/Library/Application Support/steamcmd` | `steamapps/common/Valheim dedicated server` | `~/Library/Application Support/oz-valheim`  | Fully supported |
+| Linux (Ubuntu)| `~/.local/share/steamcmd`                | `steamapps/common/Valheim dedicated server` | `~/.config/oz-valheim`                      | **Requires 32-bit libs** (see Installation) |
+| Linux (Other) | `~/.local/share/steamcmd`                | `steamapps/common/Valheim dedicated server` | `~/.config/oz-valheim`                      | Fully supported |
 
 ### Development
 

package/dist/main.js

@@ -4878,7 +4878,7 @@ import { useEffect as useEffect3, useMemo as useMemo2, useRef as useRef2, useSta
 // package.json
 var package_default = {
   name: "valheim-oz-dsm",
-  version: "1.8.0",
+  version: "1.8.2",
   description: "Land of OZ - Valheim Dedicated Server Manager",
   type: "module",
   bin: {
@@ -45131,22 +45131,29 @@ function useServer() {
     }, 1e3);
     return () => clearInterval(interval);
   }, [status, actions]);
+  const rconEnabled = rcon.enabled;
+  const rconPort = rcon.port;
+  const rconPassword = rcon.password;
+  const rconTimeout = rcon.timeout;
+  const rconAutoReconnect = rcon.autoReconnect;
+  const rconInitialized = useRef3(false);
   useEffect8(() => {
-    if (!rcon.enabled) {
+    if (!rconEnabled) {
       if (rconManager.isConnected()) {
         rconManager.disconnect();
         actions.setRconConnected(false);
       }
+      rconInitialized.current = false;
       return;
     }
     rconManager.initialize(
       {
         host: "localhost",
-        port: rcon.port,
-        password: rcon.password,
-        timeout: rcon.timeout,
-        enabled: rcon.enabled,
-        autoReconnect: rcon.autoReconnect
+        port: rconPort,
+        password: rconPassword,
+        timeout: rconTimeout,
+        enabled: rconEnabled,
+        autoReconnect: rconAutoReconnect
       },
       {
         onConnectionStateChange: (state) => {
@@ -45167,12 +45174,23 @@ function useServer() {
         // Poll every 10 seconds
       }
     );
+    rconInitialized.current = true;
     return () => {
-      rconManager.disconnect();
+      if (rconInitialized.current) {
+        rconManager.disconnect();
+        rconInitialized.current = false;
+      }
     };
-  }, [rcon, actions]);
+  }, [
+    rconEnabled,
+    rconPort,
+    rconPassword,
+    rconTimeout,
+    rconAutoReconnect,
+    actions
+  ]);
   useEffect8(() => {
-    if (status === "online" && rcon.enabled && !rconManager.isConnected()) {
+    if (status === "online" && rconEnabled && !rconManager.isConnected()) {
       const timer = setTimeout(() => {
         rconManager.connect().catch((error2) => {
           actions.addLog("warn", `RCON connection failed: ${error2}`);
@@ -45183,7 +45201,7 @@ function useServer() {
     if (status === "offline" && rconManager.isConnected()) {
       rconManager.disconnect();
     }
-  }, [status, rcon.enabled, actions]);
+  }, [status, rconEnabled, actions]);
   return {
     status,
     start,