iWxircWx-ConnHelp Guide
⌕
Fix Common Problems

Troubleshooting

A practical first-stop checklist for connection, rooms, whispers, multiline paste, appearance, add-ons and update problems.

Beginner friendlyAdvanced notes included

I cannot connect

  1. Right-click Status → Getting Started....
  2. Check whether the status says Setup needed.
  3. Open Set Up Connection... and reselect the correct network preset.
  4. For account mode, re-enter your email and password. For guest mode, verify the guest nickname.
  5. 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.

Do not make pacing faster just because it feels slow. IRCWX servers can disconnect clients for excess flood. Conservative automated pacing is intentional.

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 +w can turn room whispers off, and +W can 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 -rs instead.
  • Do not edit updater-owned aliases.ini to 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.