Take full command over your Valheim console! ConsoleBuddy empowers developers, server administrators, and players to fully customize the in-game terminal with custom font faces, font sizes, colors, console dimensions, positioning, transparency, and expanded buffer history.

---

✨ Features

• 🔤 Custom Fonts & Styling: Select any installed system font (with automatic cross-platform fallbacks for Linux, Steam Deck, and Windows) and customize font size and color.
• 📐 Custom Size & Positioning: Adjust console window width, height, and screen alignment to fit your display resolution and preference.
• 🎨 Background Customization: Set custom background colors and transparency levels to keep gameplay visible behind the terminal.
• 📜 Expanded Buffer History: View and retain hundreds of log lines with configurable visible lines and buffer capacity.
• ⚡ Zero Performance Impact: Operates purely on event triggers when the console opens or settings change—no per-frame overhead.

---

🕹️ Controls & Keybinds

Input	Default Action
F5	Toggle the in-game console open and closed.
↑ / ↓	Navigate through prior command history.
Tab	Autocomplete commands and arguments.
Page Up / Page Down	Scroll through console log buffer history.

---

⚙️ Configuration & Settings

Tailor all visual settings in real time via the in-game BepInEx Configuration Manager (F1):

Setting	Default	Description
Font Size	14	The text size in points rendered in the console window.
Font Color	White	Color of output text (accepts Hex colors or standard names).
Font Face	Consolas	Name of the font face to render.
Console Width	800	Width of the console window in pixels.
Console Height	400	Height of the console window in pixels.
Console Position X/Y	(0, 0)	Screen offset position for the console window.
Background Color	Black	Background color of the terminal panel.
Background Alpha	0.75	Transparency level of the console background (0.0 = transparent, 1.0 = solid).
Buffer Limit	1000	Maximum number of log lines preserved in memory buffer.
Visible Lines	25	Number of log lines displayed simultaneously on screen.

---

🛡️ Advanced Safeguards

• 🐧 Cross-Platform Resilience: Gracefully falls back to default Unity font rendering if a configured font is missing on Steam Deck or Linux.
• 🔒 Client-Side Module: Safe for multiplayer servers; runs strictly on the client without modifying server game rules.

---

🌐 Available Translations

Want to help translate Console Buddy? Community translations are welcome! Please submit a PR on GitHub or stop by our Discord.

---

📥 Installation

Mod Manager (Recommended)

1. Install via R2ModMan or Thunderstore Mod Manager.
2. Dependencies (BepInExPack, Jotunn (JVL)) are installed automatically.

Manual Installation

• Copy ConsoleBuddy.dll to your Valheim/BepInEx/plugins directory.

---

🔒 Anonymous Telemetry & Privacy

Console Buddy includes lightweight, privacy-first anonymous telemetry to help monitor mod stability, diagnose unhandled errors, and understand active version adoption across game updates.

• 100% Anonymous: We never collect personal data, Steam IDs, IP addresses, character/world names, or file system paths. Stack traces from errors are automatically sanitized to strip local user directories.
• Full Player Control: Telemetry is completely optional and can be enabled or disabled at any time:
  • In-Game (Startup Modal): Check or uncheck the Enable Telemetry toggle in the startup splash window.
  • In Configuration: Set Enable Anonymous Telemetry = false under [Local Config] in BepInEx/config/vapok.mods.consolebuddy.cfg (or adjust it live via the BepInEx Configuration Manager).
• Privacy Policy: Read our full data practices and commitment at vapok.io/privacy-policy.

---