Chat Widgets

Version 1.1.0

Create custom chat widgets that display any combination of message types. Each widget is independently configurable with its own message filters, positioning, fade behaviour, and more. Manage widgets from the sidebar panel — add, remove, reorder, and configure as many as you need.

Examples

Display options are quite flexible. Below are some configuration examples.

Positioning

Standard Overlay

• Game Messages: Position set to "Default" (user-specified) with a bottom margin applied to clear infoboxes.
• Private Messages: Anchored to the top-left with a top margin applied.

!default

Relative to Player

• Position: Above Player (0 margin applied)
• Fade Out Duration: 3s
• Max Messages: 1

<video src="https://github.com/user-attachments/assets/61abed62-1deb-4149-988c-a731826156f1" style="width: 100%"></video>

Configuration

Settings are split between the RuneLite config panel (global) and the sidebar panel (per-widget).

Global Settings (Config Panel)

| Setting | Description |

| :----------------------- | :--------------------------------------------------------------------------- |

| Hide Side Panel | Hide the Chat Widgets panel from the sidebar. |

| Font Size | Font size for all messages (Small, Regular). |

| Text Shadow | Draw a shadow behind text for better readability. |

| Wrap Text | Wrap long messages to multiple lines instead of truncating. |

| Hide Private Chat | Hide the default split private chat widget. |

| Smart Positioning | Automatically reposition widgets based on client mode and chatbox state. |

| Collapse Duplicates | Merge consecutive identical messages into one with a count. |

| Show Channel Names | Show the channel name prefix for friends and clan chat messages. |

| Show Timestamps | Prefix messages with a timestamp. |

| Timestamp Format | Format string for timestamps (e.g., [HH:mm:ss], [HH:mm]). |

#### Message Colours

Per-category text colours for: Game, Public, Private, Friends, Clan, Guest Clan, GIM Clan, Trade, Challenge, Did You Know, Broadcast, and Autochat.

Per-Widget Settings (Sidebar Panel)

Each widget is configured independently from the sidebar panel.

| Setting | Description |

| :----------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|

| Title | Display name for the widget. |

| Show | Enable or disable the widget. |

| Message Types | Which message categories this widget displays (Game, Public Chat, Private Chat, Friends Chat, Clan Chat, etc.). |

| Always Visible | When enabled, the widget is always shown. When disabled, it only appears when the chatbox is minimized. |

| Contextual Colours | Retain colour formatting from in-game messages (e.g. coloured boss kill messages, music tracks). |

| Max Messages | Maximum number of messages visible in the widget (1–20). |

| Fade Out (sec) | Seconds before messages start fading out (0 = never fade). Messages fully disappear after 2x this duration. |

| Position | Widget position mode. Widget uses standard overlay positioning. Below Player and Above Player position the widget relative to your character (works best with fade and low max messages). |

| Dynamic Height | Widget height adjusts based on message count rather than using fixed height. Disable this if you notice a subtle jitter effect when Fade Out is enabled. |

| Margin Top | Extra spacing above the widget (0–200). |

| Margin Bottom | Extra spacing below the widget (0–200). |

Tips

If you want to anchor a chat widget in the bottom left above the chatbox, use the anchor fixed to the right of the chatbox. This anchor point stacks widgets vertically, unlike the bottom left which stacks widgets horizontally.

<img width="1036" height="250" alt="image" src="https://github.com/user-attachments/assets/fa24e015-b43d-48ef-90b9-e843fc3651ce" />