SignScribe

SignScribe is an authentic, developer-style in-game rich text formatting studio for Valheim signs. Designed with Jötunn's native GUI framework, SignScribe blends seamlessly into Valheim's Viking aesthetic, giving you effortless control over sign colors, typography, sizing, alignments, icons, and live formatting previews.

---

Features

⚔️ Icons Tab

• 400+ Curated Symbols: Emojis and icons categorized under Combat & Tools, Nature & Outdoors, Base & Building, Food & Farming, Monsters & Trophies, Treasures & Runes, and Symbols & Direction.
• Real-Time Search Filter: Instant search filtering by name or keyword with high-performance object pooling.
• Custom Emoji Input: Paste any Unicode character from the web or Emojipedia and insert directly into your sign.

🛡️ Sprites Tab

• Native Valheim Sign Sprites: Seamlessly browse and insert game icons (<sprite name="...">) rendered directly from Valheim's internal sprite catalog.
• Dedicated Sprite Search Filter: Rapidly filter sprite names in real time without lag.
• True In-Game Icons: Clean 3-column layout displaying authentic Valheim sprites.

🎨 Colors Tab

• 16 Palette Presets: Quick-select vibrant colors matching common sign styles.
• Custom RGB Color Mixer: Interactive Red, Green, and Blue sliders with a live color swatch.
• Direct Hex Code Input: Type or paste any #RRGGBB hex code directly with instant two-way synchronization with the sliders and swatch.
• 5 Persistent Saved Color Slots: Save your favorite custom colors across sessions. Left-click to apply; Shift + Click to overwrite any slot with your current mixer color; click ✕ to clear.

✍️ Styles Tab

• Basic Formatting: Bold (<b>), Italics (<i>), <u>Underline</u> (<u>), and Strikethrough (<s>).
• Typography Transforms: UPPERCASE, lowercase, and SmallCaps.
• Text Alignment: Left (|≡), Center (≡), and Right (≡|).
• Absolute Text Size Slider: Fine-tune font sizes from 1 to 50 with real-time feedback.
• Default Text Size (6) Button: One-click reset that snaps the slider back to default and formats the text with <size=6>.

🛠️ Tools Tab

• 1-Click Quick Presets: Instant storage chest and travel labels with professional colors and icons:
  • ⚔️ Weapons · 🛡️ Armor · 🌲 Materials · 🥩 Food
  • 🧪 Potions · 🪙 Valuables · ⚡ Portal · ⚠️ Warning
• Advanced Tags: Subscript (<sub>), Superscript (<sup>), and Mark Highlights (Yellow highlight or Dark backing).
• Line Break (<br>): Insert multi-line row breaks (<br>) on narrow signs without triggering the vanilla dialog submit.
• Raw Text (<noparse>): Escape angle brackets and prevent tag interpretation.
• Cleanup Utilities:
  • Strip Colors Only: Clean color tags while keeping formatting, sizes, and layout.
  • Clear Tags: Remove all formatting tags and restore plain text.
  • Clear All: Instantly wipe the entire sign text (fully reversible with Ctrl+Z undo).
• Window Opacity Slider: Adjust HUD transparency from 20% to 100%.

📺 Live Preview

• True In-Game Rendering: Live TextMeshProUGUI preview box inheriting the sign's font, material, and sprite assets for accurate real-time rendering.
• Native Sprites: Displays genuine Valheim game sprites directly in the preview HUD.
• Dynamic Size Scaling: Proportional real-time font scaling so size adjustments are immediately visible as you edit.

⚡ Performance & Polish

• World Sign Font Unlock: Automatically unlocks sign font sizes up to 60pt (unclamping vanilla limits) so chosen sizes render beautifully on 3D in-game signs.
• Zero-Stutter Lazy Loading: Lightweight instant window open (~5 ms) with deferred icon and sprite catalog instantiation.
• Camera & Scroll Isolation: Scrolling over the studio window never shifts your camera zoom, rotates pieces, or moves the minimap.
• Configurable Scroll Sensitivity: Responsive scrolling across both Icons and Sprites tabs with in-game configurable speed (UI.ScrollSensitivity).
• Selection Safety: Highlighted words format smoothly without auto-selecting or wiping out existing text when clicking emojis or sprites.
• Extended Sign Limit: Automatically expands sign character limits to 999 characters (via Harmony prefix patches on TextInput.RequestText and Sign.Awake).
• Diagnostic Logging: Optional General.DebugLogging setting in config for troubleshooting formatting without cluttering standard logs.

---

Controls & Keybinds

Action	Control	Description
Interact / Edit	<E>	Open sign edit prompt with SignScribe Studio
Toggle HUD	F8	Show/hide the SignScribe Studio window (configurable in cfg)
Move Window	Click & Drag	Drag the studio by its woodpanel frame; position is saved automatically
Undo	Ctrl + Z	Step backwards through formatting changes (up to 50 steps)
Redo	Ctrl + Y or Ctrl + Shift + Z	Step forward through undone changes
Bold Hotkey	Ctrl + B	Wrap selected text or insert <b>...</b> tags
Italic Hotkey	Ctrl + I	Wrap selected text or insert <i>...</i> tags
Underline Hotkey	Ctrl + U	Wrap selected text or insert <u>...</u> tags
Close HUD	Escape or ✕ Button	Close the studio window and save current coordinates
Overwrite Saved Color	Shift + Click	Overwrite a saved custom color slot with the current mixer color

---

Installation

Mod Manager (Recommended)

Install directly using Thunderstore Mod Manager or r2modman by clicking "Install with Mod Manager".

Manual Installation

1. Install BepInExPack Valheim (v5.4.2202 or later).
2. Install Jötunn, the Valheim Library (v2.20.0 or later).
3. Download and extract SignScribe.dll into your <Valheim>/BepInEx/plugins/ folder.
4. Launch Valheim and interact with any sign!

---

Author & Support

• Created by jubaroo
• Compatible with multiplayer servers (client-side only; other players can view formatted signs without needing the mod installed).