ValheimEssentials

ValheimEssentials

A Valheim mod inspired by FTB Essentials (Minecraft) that adds teleportation commands via in-game chat. Built for private servers with friends — no warmup timers, no cooldowns, no permissions.

Features

• Named Homes — Save, teleport to, and manage multiple named locations
• Back — Return to your last position before any teleport or death
• TPA — Request teleport to another online player
• RTP — Random teleport to a safe land location anywhere in the world

Commands

| Command | Description |

|---------|-------------|

| /sethome | Save your current position as a named home |

| /home | Teleport to a saved home |

| /delhome | Delete a saved home |

| /homes | List all your saved homes with count |

| /back | Return to your last position (before teleport or death) |

| /tpa | Request teleport to another player (partial name match supported) |

| /tpaccept | Accept an incoming teleport request |

| /rtp | Random teleport to a safe location |

How It Works

Chat Commands

All commands are typed in the regular in-game chat (not the console). Commands starting with / are intercepted and never appear as chat messages to other players. Normal chat messages pass through unaffected.

Homes System

• Each player can save up to 5 homes (configurable)
• Home names are case-insensitive (/home Base = /home base)
• Homes are saved per-world in a text file at BepInEx/config/ValheimEssentials/homes_.txt
• Each player's homes are stored on their own PC, identified by their Steam ID
• Homes persist across server restarts

Back System

• Position is automatically saved before every teleport (/home, /tpa, /rtp)
• Position is also saved when you die — /back takes you to your death location
• Shows context-aware messages: "Teleported to death location!" vs "Teleported to previous position!"
• Two consecutive /back commands will swap between two positions

TPA (Teleport to Player)

• Player A types /tpa PlayerB → Player B receives the request in chat
• Player B types /tpaccept → Player A teleports to Player B
• Requests auto-expire after 60 seconds (both players are notified)
• Partial name matching: /tpa Jo finds "JoJo" if it's a unique match
• Multiple matches show a disambiguation message
• Self-TPA is blocked
• Only one pending request per player at a time
• Works in both P2P (host) and dedicated server modes via ZRoutedRpc

RTP (Random Teleport)

• Teleports to a random safe land position within a configurable radius
• Uses WorldGenerator to validate terrain even in unloaded chunks
• Avoids ocean biome and positions below water level
• Shows "Searching for safe position..." while looking
• Uses distantTeleport flag to handle unloaded zones smoothly
• Range defaults: 1000-8000 blocks from player position

Installation

Requirements

• BepInEx 5.x installed in your Valheim folder

-.NET Framework 4.6.2 SDK (for building from source)

From Release

• Download ValheimEssentials.dll from Releases
• Place it in Valheim/BepInEx/plugins/ValheimEssentials/
• Start the game

Building from Source

• Clone the repository
• Update ValheimDir in ValheimEssentials.csproj to point to your Valheim installation
• Run dotnet build
• The DLL is automatically copied to BepInEx/plugins/ValheimEssentials/

Important: All players on the server need the mod installed, not just the host.

Configuration

Configuration is managed via BepInEx config at BepInEx/config/com.jojo.valheimessentials.cfg.

| Setting | Default | Description |

|---------|---------|-------------|

| General/CommandPrefix | / | Chat command prefix |

| RTP/MinRange | 1000 | Minimum RTP distance from player |

| RTP/MaxRange | 8000 | Maximum RTP distance from player |

| RTP/CooldownSeconds | 0 | RTP cooldown (0 = disabled) |

| Home/CooldownSeconds | 0 | Home teleport cooldown (0 = disabled) |

| Home/MaxHomes | 5 | Maximum homes per player |

| Back/CooldownSeconds | 0 | Back teleport cooldown (0 = disabled) |

Technical Details

• Mod Loader: BepInEx 5.x
• Framework:.NET Framework 4.6.2
• Harmony Patches: S