XChat Guide

NOTE: Xchat is recommended for Mac users but most of our Ops use mIRC and cannot provide help for XChat

• This is a step-by-step guide to setting up XChat for first-time users.

What is XChat?

• XChat is an Internet Relay Chat (IRC) client that allows people to communicate with each other by chatting in a basic format that most people can find simple and easy to use.

Download

• You can download XChat for Windows here or XChat Aqua for Mac here.

• The latest version is XChat v2.8.7c for Windows (0.9MB) and 0.16.0 for Mac (2.21MB)

Setup

• The following is a setup for the GameSurge IRC servers with connecting to Nick's channels. This setup will connect you to all of Nick's channels, which will also allow you to edit entering certain ones.

Starting XChat for the first time

When you first bring up Xchat you will get a window titled X-Chat: Server List (seen on the right). Gamesurge is not listed on the available servers and we must enter it ourselves.

Enter your first, second, and third choices for nicknames. This is in case someone already chooses the nick you want to represent you, and you can always have a backup ready. Enter your username. Enter your "Real" name. NOTE: Do NOT enter your real full name. We recommend using your forum name here.

Next, click the "+" button outlined in Red. You should have a line to enter in another network. Type in "Gamesurge," and check the two boxes to the left of it. The boxes are to say that you want to connect to this network every time you open the program up.

• With Gamesurge highlighted, click Show Details, which is outlined in the first image in Blue.
• Highlight the newserver that is automatically entered and double click to edit the hostname.
• Enter one of the Gamesurge servers from the list here. Choose the one that is closest to you, and enter the name of it under hostname.
• Next, you need to enter the port. For this you just need to find which hostname you entered on the list, and in the same row there should be a port for it. Double click the space under port to enter this port. NOTE: If the port says 6667-9 (or something similar), you can use any of the numbers the numbers 6667 through 6669 as the port. Your window should look something like the image on the left.

Now we're going to add some customization - which channels you want to be able to connect to on start up of the program, and for X-Chat to automatically log into your Gamesurge auth.

• First, click the "On Join" tab at the top. On the image to your right, you'll see it is outlined in Blue.
• To add any channels you want to connect automatically to when the program starts up, click the + button outlined in Red.
• Add one of the channels below and repeat this for all channels you wish to add. You can confirm you've done this step right if you compare your window to the image already mentioned on the right.

toontowncentral
vmkforums
disneysonlineworlds
piratesonlineforums
clubpenguinfansite
carsonlineforums
coldcallersguild
toontowntrivia
vmktrivia
pixietrivia
toontowntrivia
pixiehollowforums

Next, we're going to add commands that will automatically run when your program starts. This is for those that want to use a Gamesurge auth. If you do not, you can skip the rest of this section.

Click here to register at Gamesurge. Registering enables you to hide your IP and be added to the userlist so that you are voiced whenever you enter the channels. You won't receive any spam e-mails from Gamesurge. Once registered, verify your account and make any changes you wish to your password.

• If you have already joined Gamesurge, or are now on this step, use the auth command they gave you, and put it in the Command box. Just double click the space under the column where it says Command to type. The command should be something like "authserv auth username password"

Where it says username and password, are the places you put the information you registered with Gamesurge.}}

• Click the + button outlined in Red to add other commands. In the image to the right, I've added "mode +xi". This is a useful command for hiding your IP.
• At this point you may want to compare your windows with the images in this guide to make sure everything looks right.
• Go back to the Server List window.
• Click the Connect button. You should connect at this point, but if you have issues it is always worth restarting the program or posting on the forums.

Basic Operations

There are some basic operations you may need to use while chatting on XChat. These basic operations include private queries, changing your nickname, actions, joining additional channels or rejoining channels, and utilizing our stats bot (Keswick).

Private Queries

Sometimes you will find it necessary to enter into a private conversation with a member or an Op. To enter into a private conversation with a member in the channel, you can right-click on their name and choose Open Dialog Window.

Another option to enter into a private conversation, which will work for anyone online, whether they are in the channel or not, is to type /query , replacing with their nickname while online.

NOTE: All of our policies apply to private conversations as well as channel chat.

Changing Your Nickname

To change your nickname, simply type the following, replacing with the nickname you desire. Or you can also click on your name next to the chat bar and change it there. /nick

NOTE: Nicknames are across the entire Gamesurge Network, not just our channels. If your nickname does not change after entering this command, it is likely it is in use already. Choose another nickname.

NOTE: Repeatedly changing your nickname or choosing a nickname that is non-G rated could cause you to be warned and/or banned from our channels by an Op. If requested to change your nickname by an Op, please do so immediately.

Using Actions

Some members find it fun to use actions. To do this, simply type /me previous to the action. For instance, typing /me whistles will return a line of * whistles. You can do this with any action of your choosing, as long as it follows our policies.

Joining Additional Channels or Rejoining a Channel

To join any channel, simply type:
/join #channelname
So to join the #toontowncentral channel, type /join #toontowncentral

Utilizing the Channel Bot

Our channel bot will retain certain stats about you. Don't be alarmed when you get a message telling you that you've been added to the userbase. It simply means the bot is logging statistics about you. The channel bot not only logs basic information about you, but can also hold quotes in his database. Some common commands to control the channel bot are as follows:

• !stat - Tells you how many words, lines, letters, smileys, and actions you've typed in that channel, as well as how much total time you've been logged into that channel (time wasted).
• !top 10 (regular channels) - Gives all of the nicknames that have typed the most in that particular channel.
• !top10 (This is different in the trivia channels) - Gives the top 10 players in trivia.
• !place - Tells exactly what place your nickname is in for how many words typed in that channel.
• !addquote - Use this command with a quote afterwords to add a quote to the stats bot.
• !quote - The stats bot will randomly generate a quote that has been added to the database.

NOTE: Please refrain from repeatedly using bot commands

Scripts Guide

While you're in a channel, right-click on a user's name. A variety of commands come up (some of the defaults only work for channel operators, using them will not do anything for you). However, this list can be customized. This will show you how. The script editor is accessed under Settings->Advanced->Userlist Popup.

Menu Customization

As you may have noticed, actions can be grouped into submenus (the default setup has a handful). To add a new menu, create a new entry with SUB in the Name box, and the name of your menu in the Command one. For example, I have grouped some scripts that I use for TTC channels into a TTC menu, done via the following:

• SUB TTC

To end a submenu, create a new entry with ENDSUB in the Name box and nothing in the Command box.

Creating New Scripts

To add a new script, simply hit the Add New button. New scripts will always be added to the top, regardless of where your cursor is at the time. Use the Move Up and Move Dn buttons to arrange the new command on the menu as you would like. The first box will contain the name as it appears on the popup menu, and the second contains the command. NOTE: The opening slash (/) needs to be excluded, it is implied. If you simply want to say something into the channel, start the command with say (which is the generic speak command).

For example, if you want to create a script to poke someone, do the following:

1. Click the Add New button.
2. Enter Poke in the Name box.
3. Enter me pokes %s in the Command box. The %s will be replaced with the name of the target. %a can also be used for this purpose.
4. Click the Save button to update the menu.
5. Now click someone, and select Poke from the menu. Watch as the script executes.

PLEASE EXERCISE CAUTION WHEN MAKING YOUR OWN.

If your script contains very violent actions or not G-rated material, an Operator will ask for you to refrain from using it and/or ban you.