Twitcheim

Twitcheim

Twitcheim links your Twitch chat directly to Valheim! Allow your viewers to interact with your gameplay in real-time using customizable Twitch chat commands. Viewers can spend points to spawn items, spawn creatures/bosses, trigger buffs/debuffs, or heal you while you stream.

🌟 Key Features

• Dynamic Command Management: Easily edit, add, or remove chat commands directly in-game using the BepInEx Config Manager. No restarting required!

• Streamer-Friendly HUD Overlay: An in-game, resizable, and draggable chat HUD overlay shows incoming Twitch messages and executed commands live on screen.

• Persistent Position & Styling: Save your preferred HUD layout, position, font size, background color, and transparency automatically.

• Viewer Loyalty Points System: Viewers earn 1 point per second automatically while chatting. Points are used to redeem stream actions.

• Interactive Command Carousel (!commands): Viewers can type!commands or!help in chat to trigger an animated list of all available commands and their costs in the HUD overlay.

• Fair Spawning System: Spawn monsters and items at customizable minimum and maximum distances around the player.

🎮 Default Commands

| Command | Description | Cost |

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

|!points | Displays the viewer's current point balance in HUD. | 0 P |

|!commands!help | Cycles through all available commands and prices in the HUD overlay. | 0 P |

|!heal | Heals the player for 100 HP. | 600 P |

|!buff | Applies a status effect for 30 seconds (e.g.!buff poison,!buff rested). | 180 - 900 P |

|!spawn | Spawns creatures or materials nearby (e.g.!spawn troll,!spawn wood). | Varies |

⚙️ How to Setup

• Install BepInEx: Make sure you have BepInEx installed for Valheim.

• Install Twitcheim: Place Twitcheim.dll into your Valheim/BepInEx/plugins/ folder.

• Configure Channel:

• Launch Valheim and press F1 (or open the BepInEx Configuration Manager).

• Enter your Twitch Channel Name under 00 - Settings.

• Click Connect.

🛠️ Customizing Commands

Commands are stored in a text file located at Valheim/BepInEx/config/Twitcheim_Commands.txt.

You can modify them in two ways:

• In-Game (Recommended): Open the BepInEx Configuration Manager (F1) and use the visual manager under 01 - Commands File. Add new commands, adjust costs, set minimum/maximum spawn distances, or change item quantities, then click Save & Reload File.

• Text File: Edit Twitcheim_Commands.txt manually using the pipe-delimited format:

Command | Cost | MinDist | MaxDist | Quantity!spawn boar | 300 | 20 | 30 | 1

🎨 HUD Customization

Under the 02 - HUD Position section in the config menu, you can fully adjust:

• Font Size: Change text size to fit your resolution.

• Background Color & Transparency: Match your stream overlay theme.

• Drag & Resize: Open any UI/menu in-game to drag the HUD anywhere on screen or drag the bottom-right corner ◢ to resize it. Position is automatically saved!

⚙️ INFO

This mod is work in progress.