This tutorial will explain how to configure mIRC for use with a psyBNC.

Remember, in 99.9% of all cases, the psybnc is working just fine - it's your mIRC configuration that's wrong! Before asking for help, first read this page as it answers all your questions, really.

Please don't forget to carefully read the tips & tricks part of this page!
Find more information on mIRC on www.mirc.com and for psyBNC on www.psybnc.info.

Parts:
Configuration
PsyBNC commands
!!! Tips & Tricks !!! (read this!)

Add your bouncer to mIRC server list

From your bouncer provider, you will receive the following information:

IP address - the IP address of your psybnc bouncer.
Port - the port, where the psyBNC listens.
Username - your username/login/ident for the bouncer.
Password

Open your mIRC and make sure you are disconnected (1). Then click on 2 to open the mIRC option dialog.

Write the bouncer IP address, which you received from your provider, into the field IRC Server.

Check mIRC Identd settings

Now, check your mIRC Identd options. Make sure that the User ID field matches your bouncer username (= login, ident)!

Connect to bouncer!

Select the bouncer server entry which you added in step 1. Then make sure that the Email Address field matches your bouncer username (= login, ident).
For example, if your bouncer username is whiskey, then your email address setting should be something like whiskey@provider.com.

Important commands

Here is a list of important psyBNC bouncer commands which you should know about.
For Freakshells, always use
irc.freakshells.com port 6667 for IPv4 connections and
irc.ipv6.freakshells.com port 6667 for IPv6 connections.
These hosts will always point to all supported IRC servers!

Note: if you want to use IPv4, make sure that you use an IPv4 vhost AND an IPv4 IRC server. If you want to use IPv6, use an IPv6 vhost AND an IPv6 IRC server. DO NOT MIX IPv6 servers with IPv4 vhosts (and the other way round)!

/bvhost	Change your vhost!
/addserver irc.freakshells.com:6667	Add hostname:port to your psyBNC server list
/delserver 1	Delete entry 1 from your psyBNC server list
/listservers	List your psyBNC servers
/jump	Jump to next server in your psyBNC serverlist
/setaway	Change your away message
/setleavemsg	Change your quit message
/bconnect	Connect bouncer to IRC server
/bquit	Disconnect bouncer from IRC server
/leavequit 1	If you set /leavequit to 1, the bouncer will part all channels when you quit!

Tipps & Tricks

If you have problems logging into your bouncer ...
Check the identd and email address settings in your mIRC! Both must match your psyBNC username.
For example, if your username is "freak", then your email address setting in mIRC must be like "freak@provider.com".

How to add an IPv6 IP vhost to psyBNC ...
If you want to add an IPv6 IP as vhost, like 2001:1408:1337::2, do it like this:
/bvhost :2001:1408:1337::2
Note the leading ":" before the IPv6 IP!

psyBNC says: "Cannot create listening port .. aborting"
If you have a shell and setup your own psyBNC, and see this error message, try to use a different listening port (not the default 31337!). Also, use a vhost IP as the listening IP, not the default ("*").
The setting in psybnc.conf should, for example, look like:
PSYBNC.SYSTEM.PORT1=31440
PSYBNC.SYSTEM.HOST1=195.149.115.30

Be careful, PsyBNC is case-sensitive for username and password!
Take care that you type your username / login / ident and your password correctly. PsyBNC is case-sensitive. This means, 'a' is not the same as 'A'!

My psyBNC says "wrong pass", can you change my password?
First, you can change the passwords yourself. Please go to our member area http://members.freakshells.com.
Second, the password is ok - it's your mIRC configuration that's wrong. Read this page carefully and check your mIRC config.

I tried everything but my psy still doesn't connect to IRC!