Troubleshooting
A practical first-stop checklist for connection, rooms, whispers, multiline paste, appearance, add-ons and update problems.
I cannot connect
- Right-click Status → Getting Started....
- Check whether the status says Setup needed.
- Open Set Up Connection... and reselect the correct network preset.
- For account mode, re-enter your email and password. For guest mode, verify the guest nickname.
- If you use a custom network, verify the Connect Address, Port, SSL/TLS and Web Domain under Advanced Connection Settings.
If the connection still fails, open Advanced → System Information... and keep the relevant error text from Status when asking for support.
I connected but I am not in a room
Connection and room membership are separate. Choose Status → Rooms → Browse Rooms... or Join a Room.... If you expect rooms to open automatically, check both the saved Auto Join list and the Automatically join these rooms after connecting option.
A room name will not join
Try the friendly Join Room dialog first. Do not manually type IRCWX prefixes unless you need to. For commands, these forms are supported:
/j My Room
/join %#My\bRoom
If the server responds with Invite Only, Room Full or Key Needed, the problem is the room's access/modes rather than the spelling alone.
I was disconnected after pasting many lines
Open Tools → Queue / Pacing Manager... and choose Proven Defaults. The recommended text profile is 4 lines per chunk, 1800 ms recovery, rapid threshold 8, 999 ms settle delay and a 400-line safety ceiling.
Whispers are not working
- Start the whisper from the room's people list rather than using normal
/msg. - Check Settings → Options → Block Whispers.
- Remember that room mode
+wcan turn room whispers off, and+Wcan block guest whispers. - A self-target whisper is intentionally rejected.
Webchat looks wrong or is empty
- Make sure you are actually joined to the room whose Webchat window you opened.
- Close and reopen the Webchat window from the room menu.
- For hard-to-read colors, open Appearance → Colors and enable the Webchat readability adjustment or return to following the channel background.
- Use Webchat Options → Reset Webchat Options for transcript-specific preferences.
An add-on does not appear or load
- Put manager-visible add-ons under the
addons\folder. - Choose Refresh in Add-on Manager.
- Check the Status and API requirement shown in the details pane.
- If it is an ordinary script outside
addons\, use normal mIRC Alt+R or/load -rsinstead. - Do not edit updater-owned
aliases.inito install permanent custom aliases.
An update says restart is required
Use the built-in Restart Now option and let ircWx-Conn finish the maintenance cycle. After restart, the Updates window should identify the installed/current build and stop showing a pending restart.
Do not run Factory Reset while an update or previous-build restore is pending.
I changed colors and now something is unreadable
Go back to the specific appearance dialog and use its defaults/reset controls. For menu problems, use Menu Theme's global/default behavior. For Webchat, re-enable auto-adjusted user colors. Factory Reset is the last resort, not the first.
When to use Factory Reset
Use Factory Reset only when ircWx-Conn-owned settings/runtime data are badly confused and targeted fixes did not help. Read what Factory Reset erases and preserves before continuing.