You're about to install xdcc'n'stuff, a lame sounding script, with a lot of cool features. Installing it is fairly easy, but there are some important things you need to do first! Here's a fast install guide : - unarc the archive (well, you're reading this, so you've done that...) - copy xdcc.pl to your ~/.xchat dir(anything with .pl will be auto loaded) - edit the script with your favorite text editor. You will see a line stating something like "# EDIT THESE BEFORE USING THIS SCRIPT OR ELSE!" Under that line, you will see several defaults. The only important default to edit is the modelength option. Most IRC networks allow 6 mode changes per line, but some only allow 4. If you plan to be on networks that only allow 4, you may want to change this. The other settings are mostly cosmetic, and can be changed as you become used to the script. - now load xchat... you should see : | Making .xdcc dir for config files... | No config file found! Creating one! | Saved config! | Config file loaded! Not connected. Try /server [] | XDCC file not found! | Friendlist not found! At this point, your config file has been made with preset defaults. You will notice that you have no friendlist, or xdcclist, but this is normal, and nothing to be concerned with. You will make those as you go along. At this point, you are ready to go! Connect to a server, and go from there. By default, you will see some new buttons that have been added by the script. You can use ADDF to add a friend to your friendslist. This gives them the ofxp flags. I might as well get into more detailed info now, so here are the flag definitions : f = friend can page you, along with other +f only things p = protect the script will take action to protect this user, depending on the revenge level o = op this user will be given ops on join v - voice same as above, but for voice x - file this person is allowed file access k - kick this user is kickbanned from the channel on join i - invincible this user will NOT be deopped or banned by the script under ANY circumstances s - silence ignore eveything from this user BTW, you can use the "/xdcc help" command for a brief overview of the commands available. Anyhow, below is a listing of script commands. First, commands that have been changed : - /unban now does pattern matching, so /unban * will unban all bans on the channel. Unbanning a single ban will work like always. - /kick will now use the default kick reason from the script - /ban will now perform a -o on the user, add a proper banmask, and kick the user with your kick message - /ban w will perform a wideban on that user (ban the whole ISP) the button WideBan does this automatically Probably the first thing you should do, once you join a channel, is to click on your name, and then the AddF button. While the script does realise who you are, you want to make sure it knows what your hostmask is, in case you are in a netsplit, or have clones on the channel. You should also set your flood protection level as well. Now, for a listing of the commands : XDCC NOTE : FOR XDCC TO WORK CORRECTLY, YOU MUST SET THE "DCC STALL TIMEOUT" OPTION IN THE XCHAT PREFS, UNDER DCC SETTINGS. A good setting to use is 120 seconds (2 minutes), but its up to you... just set it to SOMETHING ;) /addp allows you to add a pack to your packlist. You can do pattern matching such as "/addp /home/buddy/*mp3 my 10 favorite mp3's!". This will, as it appears, add all files under the dir /home/buddy, that match *mp3. If you want a pack to have only a single file in it, then just enter the full filename. Once REALLY handy feature for users is the following command : "/addp /home/buddy/*mp3 FILES" If you use FILES as your description, each file will be individually added as a seperate pack, and the description will be the filename without path. The search is recursive, so if you do a "/addp /home/buddy/mp3/*" all subdirectories will be searched for files. /delp delete a pack, by number "/delp 3" /packlist allows you to display a packlist locally, so you can see what you have on offer /plist lets you list your packlist to a channel "/plist #it" /chan sets your channels for xdcc notify /noti by itself, will list to all the channels in your /chan list. If you use "/noti 15" or any other number, it will list in 15 minute intervals (or whatever you use). You can also add a description to the notification, such as "/noti 15 Lots of new stuff here, grab it!" /slots set the number of available slots for xdccing. Any number of files over this limit will be queued and sent to the user later. FRIENDS /addf you can use this command to add friends to you friends list. If you do a "/addf bob oxp", the script will search the channel you did the /addf from, and attempt to find a user who's nick is bob, and add him to the friendslist with the hostname, and flags oxp. You can also include the hostmask yourself, if the user isn't on the channel right now, or you don't like the hostmask provided by the script. Doing a "/addf bob oxp *!test@*.test2.t.com" will do the job. /delf lets you delete a friend, by number. You can get a list of numbered friends with a /listf. /listf gives you a list of your friends /editf lets you edit someone on your friendlist. You can add and delete hostmasks, change their flags, and add or remove comments. "/editf bob ixo" - change bobs flags to ixo "/editf bob +*!*@*.test.com" - add *!*@*.test.com to bob's hosts "/editf bob -*!*@*.test.com" - delete *!*@*.test.com "/editf bob COMMENT Good ol' Bob" - set a comment for bob /revenge this toggles your revenge level. There are 4 levels : NONE - absolutely no revenge NORMAL - actions against protected users will result in a kick SEVERE - actions against protected users will result in a kickban EXTREME - actions against protected users will result in a kickban, and the offender will be added to your friends list automatically with the k flag. Note that if an attacked user has a i flag, the revenge level is increased. Also, having the p flag reduces the revenge level. So, for example, if one of your p users kicks an i user, the revenge level won't change, but if a normal user kicks an i user, the revenge level will increase. This means that if a i user is kicked, revenge will happen, even if revenge is off! That is because revenge will be changed from NONE to NORMAL! Once again, the flags : f = friend can page you, along with other +f only things p = protect the script will take action to protect this user, depending on the revenge level o = op this user will be given ops on join v - voice same as above, but for voice x - file this person is allowed file access k - kick this user is kickbanned from the channel on join i - invincible this user will NOT be deopped or banned by the script under ANY circumstances s - silence ignore eveything from this user /ignore this command will add the user to your userlist, with the ignore (s) flag More to come....