THIS GUIDE IS STILL UNDER CONSTRUCTION

:-(



IRC - Guide

written by It's Me

What is IRC?

Internet Relay Chat (IRC) is a real-time chat and mainly designed for group communication in different chat rooms,

called channels. One-to-one communication and data transfers via Direct Client-to-Client are possible, too.

IRC-Software is available for every computer that supports TCP/IP network, and the computer you are using does, i guess.

If you want to test IRC quickly, you can use QuakeNet Webchat

It is a webchat for the quakenet IRC network. At first you can try this little four commands:



/join #xonotic- If you type this command in the description field you will join #xonotic

/nick othername - Do you want to change your name? Use this command.

/me doing - If you want to show that you are doing something.

/away reason - You are away and want to tell others why?


Webchat is not that confortable, you should use a program....


There are several programms for IRC …

A full client list is here.


Because there are Xonotic players that are using Linux and players that are using Windows,

I will show you how to use XChat (Linux / Windows).


When you click on the link, you get to the download page of the program, so you do not have to search first.

XChat Windows

XChat Linux - binary


If you are running Linux you should use the packet manager!

sudo apt-get install xchat


What do you have to do now?


If you have downloaded the program, you decided, and after you installled it we can go on...


When you start XChat and run it the first time... you get a window like this one:

(By the way... at the moment i am running XChat on Windows. On Linux it might look different)




„Nickname“ Fill in your nickname. It need not to be your real name, of course.

This is the used name on IRC.

„Second Choice“ and „Third Choice“ …

There is only one nickname per person and if your nickname is forgiven,

there will be a try with the second and thir choice

The field „User name“ and "Real name" are explained by itself, too.


Next, you choose one of the IRC networks.

Click this in the drop-down menu, under the line "Networks" and select "QuakeNet",

because the channels "#capbots" and "#dietunichguten" are on QuakeNet, like every other Xonotic channel.


If you've done this, you have a window like thise one:






Click "Coonect" and the first step is completed.


Now you have two windows:




In the left upper window you can fill in the channels you want to join...

Fill in

#capbots and #dietunichtguten …




Klick on „OK“.


Now you are connected with QuakeNet and you are in those two channels.




On the left side you got the channel overview.

As you see #dietunichtguten is activ. If you klick on #capbots the CapBot channel is activ.

On the right side there are all visitors. As you can see, they have colored circles in front of there name.

The green one means operaror status and the yellow one allowed to speak.

In some other IRC programs it can be different (like @ for operator, + for allowed to speak).


You can test the simple commands, you have learned allready again.


In my opinion you do not need the window for channel joining.

If you want to join channels automaticly, there is a better way.

Klick on XChat and Network List ...

Mark QuakeNet (if it is not marked) and klick on „Edit“. Now you have this window.





Klick on Favorites and fill in the two channels i mentioned.

For some channels there is a key available. If you can fill this key in „key (password)“.


Close the window and connect to QuakeNet. Now you will be connected with those two channels at everytime you start XChat and connect with QuakeNet.


On next start of IRC you can unmark „Always show this dialog after connecting“ in the „channel join“ window


Who is this @Q?


Q is a bot that controls the channel and assigns the users.

It can give operator or voice access, for example. He cannot answer, so do not be surprised.


What are the availlable commands at QuakeNet?

Every command has to be filled in the input field!


Here are some simple commands that every QuakeNet-user should know...

But there are many more, as you can see, if you will go on with reading!


/join #channel

Use this command to join other channels.

Instead of "channel" simply specify the channel you want to join.

If you are already in a channel, the new channel will be added at the top in the channel bar.

The current channel will not be closed.

Note: All channel names on QuakeNet begin with a #.


/NICK name

This command will change your nick you specify, instead of "name" fill in the desired nickname.


/ME do

This command executes an action.

Instead of „do“ type what you are doing.


/AWAY reason

This command will switch you in away mode.

Instead of "reason" you give the reason why you are away.

If you are back to the PC, type "/away" and you will be switched away from the away mode.


/MSG #channel message

You can send a message to a channel even you have not joined...

At some channels those extern messages are blocked


/IGNORE nickname

All messages from the specified user will be ignored by your IRC client.

If you wish to remove the ignore, use: /IGNORE -r nickname. To list currently ignored users, use: /IGNORE -l.


/MSG Q SHOWCOMMANDS

Use this command tho show the available commands on QuakeNet.


How to sign up (AUTH) my Nick?


To register your nickname you have to type the following commands:


/MSG Q HELLO „email address“ „email address“

Where "mail address" means your email address. So it should look like this:

/MSG Q HELLO player@xonotic.org player@xonotic.org

The email address must be entered two times!


Then you get a mail with your password in a few and you can log in with the following command:


/MSG Q@CServe.quakenet.org AUTH nick password

(The password can you receive of the email.)

To keep security you should give NO ONE your password.


If you are successfully logged in you will receive a message in the QuakeNet window.

You do not have to login manually everytime:



Just open the window where you filled in the channels you want to join automatically and at „connect command“ you fill in


/MSG Q@CServe.quakenet.org AUTH nick password with your name and passwort.


Normally (on other Networks there is Nickserv and not Q)

There u can use the other field „Nickserv password“


To change your password you have to type:


/MSG Q@CServe.quakenet.org NEWPASS old-password new-password new-password


Do you want to create your own room (channel)?


That's easy, just type in /join #yourchannel.

Instead of „yourchannel“ the name you wish.

If you want to register your channel (if you want to become owner):

Type /MSG r requestbot #yourchannel


If yu are not the owner of a channel...

The first user that enters the channel gets automatically operator status.

You have to achieve some conditions. If you are successfully Q will come.


I have Q in my channel. What can he do?


There are several commands, that you can send to Q

All commands you can see at the command alphabet that is shown at the end of the tutorial.


You use a „Q command“ with

/MSG Q COMMAND #CHANNEL PARAMETERS


At this part only the most important ones are shown.

If you are a channel owner it is good to know them!


CHANLEV: This is one of the most important of the commands.

With this command, you determine the user flags (User Rights).

Here are the some important user flags:

+n OWNER Can add or remove masters and all other flags (except personal flags)

To keep high security you should give NO ONE owner status

+m MASTER Can add or remove all access except master or owner

+o OP Can get ops on the channel

+v VOICE Can get voice on the channel

+b BANNED Banned from the channel


Examples of user flags:

/MSG Q CHANLEV #channel nickname + av - gives the nickname autovoice.

/MSG Q CHANLEV #channel authname+ aom - gives the Authname automatically operator and master status at the channel

If you want to remove the rights. Use a simply "-".

For example:

/MSG Q CHANLEV #channel nickname -av – removes AutoVoice of the nickname

With /MSG Q CHANLEV #channel (without nickname and paramters) Q will post the userflags.


RECOVER: /MSG Q RECOVER #channel

This command resets the named channel if undesired modes, bans or ops have been

set. Q will do theese commands:

DEOPALL

UNBANALL

CLEARCHAN

To run the command you need the Userflag + m or + n.


This command is really important if you got the victim of an overtake!

If someone gets operator status and kickban, deops you to have your channel as his own channel, is called overtake.


SHOWCOMMANDS: /MSG Q SHOWCOMMANDS

Is the same as HELP, only without parameters. It displays all the commands that can be performed with Q.


UNBANNALL: /MSG Q UNBANALL #channel

All bans are removed with this command.


WELCOME: This command is used to set and display the welcome messageon the channel.

Place a welcome message: /MSG Q WELCOME #channel Welcome to my Channel.

Has to be activated with CHANFLAG +w

.

BAN: /MSG Q BAN #channel nick name

Use this command to permanently ban a user from the channel.


BANCLEAR: /MSG Q BANCLEAR #channel

This command deletes the bans from a channel. Unlike UNBANNALL also removes the forever banned users.


Bandel: /MSG Q Bandel #channel nickname

This feature is removes a ban from the banlist.


BanList: /MSG Q BANLIST #channel - Lists the banlist of the channel.


CHANFLAGS: Chanflags are similar to the user flags except that only the channel and not for users.

/MSG Q CHANFLAGS #channel – List the chanflags.

/MSG Q CHANFLAGS #channel + /-chanflag

Here are the most important Chanflags:


+a AUTOOP

Automatically ops any user who has op access when they join the

channel. Same effect as giving all ops the +a chanlev flag.

+b BITCH Prevents users who don't have operator access on the channel

from being opped (automatically deops them)

+g AUTOVOICE Automatically voices any user who has voice access when they join

the channel. Same effect as giving all voices the +g chanlev flag.

+t TOPICSAVE Saves the topic when it changes. Such saved topics can be restored

via settopic, or when the bot rejoins when a channel has been left

empty.

+v VOICEALL Automatically grants voice (+v) on the channel to any user who enters,

unless they have quiet (+q) chanlev flag.

+w WELCOME Sends the welcome message to users joining the channel.


With /MSG Q CHANFLAGS #channel (without paramters) Q will post the channelflags.


REQUEST PASSWORD: /MSG Q REQUEST PASSWORD yourmailadress

If you have lost your password once you can request it again.


So far the tutorial...


If you are running your IRC and have some problems there is help for you:


First you should try to solve the problem on your own...

Try /MSG Q COMMANDS to show all availabale commands.

Try /MSG Q HELP commandname to show the help of an specific command.


Look at QuakeNet FAQ


and if that doesnt help you can google your problem :-D

and if that doesnt help you can join #help on Quakenet...

There are nice guys, who help you, if your question is not that stupid.


That was my tutorial for you.

Now there will follow the command alphabeth...

If you have your own channel you should hava a look at

CHANLEV, CHANFLAGS and CHANMODE.


COMMAND ALPHABET:


The following Q commands are available for you.


Usage of every command is:


/MSG Q …..


ADDUSER - Adds one or more users to a channel.

Usage: ADDUSER [...]

Adds the named user(s) to the channel, where:

channel - the channel to use

flags - the list of flags to add for each user, introduced by + (for example +gv).

See CHANLEV for valid flags.

If no flags are specified, +aot is used.

This command cannot be used to add masters (+m) or owners (+n).

user - either a user's current nickname on the network or #accountname.

Up to 18 Users can be specified.


ADDUSER requires master (+m) access on the named channel.


AUTHHISTORY - View auth history for an account.

Usage: AUTHHISTORY

Displays details of the last 10 logins with your account.

Details include hostmask, login time, disconnect time and reason.


AUTOLIMIT - Shows or changes the autolimit threshold on a channel.

Usage: AUTOLIMIT []

The autolimit feature maintains a user limit (+l) on the channel which is

regularly updated to keep a fixed number of spaces free on the channel for

people to join. This is useful since it prevents a large number of "clones"

joining at the same time. However, if the number of free spaces is too small

it's possible that legitimate users won't be able to join. This command allows

you to adjust the number of free spaces to maintain when autolimit is enabled.

To actually turn the autolimit feature on or off, see CHANFLAGS.

Where:

channel - the channel to use.

threshold - specifies the new threshold.

If not specified, the current threshold is displayed.

Viewing the current threshold requires operator (+o) access on the named channel.

Updating the threshold requires master (+m) access on the named channel.



BANCLEAR - Removes all bans from a channel including persistent bans.

Usage: BANCLEAR

Removes all temporary and persistent bans from a channel, where:

channel - the channel to use.

BANCLEAR requires master (+m) access on the named channel.


BANDEL - Removes a single ban from a channel.

Usage: BANDEL

Removes the specified persistent or channel ban, where:

channel - the channel to use

ban - either a ban mask (nick!user@host), or #number (see BANLIST)

Removing channel bans requires operator (+o) access on the named channel.

Removing persistent bans requires master (+m) access on the named channel.


BANLIST - Displays all persistent bans on a channel.

Usage: BANLIST

Displays a list of persistent and channel bans on the named channel. Each ban

is identified by a number which can be passed to a subsequent BANDEL command.

Note that the numbers can change if bans are added to or removed from the

channel. Where:

channel - the channel to use

BANLIST requires operator (+o) access on the named channel.


BANTIMER - Shows or changes the time after which bans are removed.

Usage: BANTIMER

To help keep channels clear of the clutter of too many bans, Q can automatically

remove channel bans after a specified time. This command is used to alter that

time period, disable the feature, or show the current setting, where:

channel - the channel to use

duration - how long to remove channel bans after. If duration is 0 then channel

bans will not be automatically removed.

If duration is not specified, the current setting will be displayed. Suffixes can m (minutes), h (hours), d (days), w (weeks), M (months) and y (years) can be used to specify the duration, for example 3d, 1w, 1h30m.

Viewing the current setting requires operator (+o) access on the named channel.

Changing the setting requires master (+m) access on the named channel.


CHANFLAGS - Shows or changes the flags on a channel.

Usage: CHANFLAGS []

Shows or changes the status of channel flags, where:

channel - channel to use

changes - changes to apply to the channel flags in the usual +/- format, e.g. +c

to set +c and -c to remove it.

Viewing the current flags requires operator (+o) access on the named channel.

Changing the flags requires master (+m) access on the named channel.

Valid channel flags are:

+a AUTOOP Automatically ops any user who has op access when they join the

channel. Same effect as giving all ops the +a chanlev flag.

+b BITCH Prevents users who don't have operator access on the channel from being opped (automatically deops them)

+c AUTOLIMIT Enables automatic limit feature - updates the channel limit at

regular intervals to keep a certain number of free spaces. This can mitigate the effect of join floods. See AUTOLIMIT.

+e ENFORCE Enforces bans on the channel. Any user who is banned will be kicked automatically.

+f FORCETOPIC Prevents channel ops from changing the topic. The SETTOPIC

command must be used instead.

+g AUTOVOICE Automatically voices any user who has voice access when they join the channel. Same effect as giving all voices the +g chanlev flag.

+h ACH'MENTS Display achievement announcements in channel.

+j JOINED Causes Q to remain on the channel. Cannot be removed.

+k KNOWNONLY Any user who joins the channel who is not known (+k) will be kicked. Unless channel mode +i is set they will be banned as well.

+p PROTECT Any user with voice (+v) or operator (+o) access will have that

status enforced on the channel at all times. Same effect as giving all ops and voices the +p chanlev flag.

+t TOPICSAVE Saves the topic when it changes. Such saved topics can be restored

via settopic, or when the bot rejoins when a channel has been left empty.

+v VOICEALL Automatically grants voice (+v) on the channel to any user who enters, unless they have quiet (+q) chanlev flag.

+w WELCOME Sends the welcome message to users joining the channel. See WELCOME.

Note: Previous versions of Q included the facility to enforce limits and keys using +k and +l chanflags. This functionality is now available via the CHANMODE command.


CHANLEV - Shows or modifies user access on a channel.

Usage: CHANLEV

Displays or alters the access of known users on a channel, where:

channel - the channel to use

user - the user to list or modify. user can be specified as either an active nickname on the network or #accountname. If user is not specified then all known users are listed.

change - lists the flags to add or remove, with + to add or - to remove.

For example, +ao to add a and o flags, or -gv to remove g and v flags. This can be used to add or remove users from the channel. If change is not specified then the current access of the named user is displayed. Displaying known user information requires you to be known (+k) on the named channel. Adjusting flags for other users requires master (+m) access on the named channel. Adding or removing the +m flag for other users requires owner (+n) access on thenamed channel.You may always remove your own flags, except +qdb flags (which are not visible to you). Adding or removing personal flags requires you to be known (+k) on the named channel. Note that channel owners (+n) can grant +n to channel masters but they must use

the GIVEOWNER command for this. The access level flags determine which commands a user is allowed to use on a channel.

Holding an access flag also grants access to any action requiring a lesser flag (e.g.

+m users can perform actions requiring operator (+o) status even if they do not

actually have +o set). The access flags are listed in descending order.

Valid flags are:

Access level flags - these control the user's overall privilege level on the channel:

+n OWNER Can add or remove masters and all other flags (except personal flags)

+m MASTER Can add or remove all access except master or owner

+o OP Can get ops on the channel

+v VOICE Can get voice on the channel

+k KNOWN Known on the channel - can get invites to the channel via INVITE

Punishment flags - these restrict the user on the channel in some way:

+q DEVOICE Not allowed to be voiced on the channel

+d DEOP Not allowed to be opped on the channel

+b BANNED Banned from the channel

Extra flags - these control specific behaviour on the channel:

+a AUTOOP Ops the user automatically when they join the channel (the user

must also hold +o in order to have this flag)

+g AUTOVOICE Voices the user automatically when they join the channel (the

user must also hold +v in order to have this flag)

+p PROTECT If the user has +o or +v, this makes sure they will always have

that status, they will be reopped/voiced if deopped/voiced

+t TOPIC Can use SETTOPIC to alter the topic on the channel

Personal flags - these control user personal preferences and can only be changed

by the user concerned. They are not visible to other users.

+w NOWELCOME Prevents the welcome message being sent when you join the channel.

+j AUTOINV Invites you to the channel automatically when you authenticate.

Note that non-sensible combinations of flags are not allowed. After making a

change the current status of the named user on the channel will be confirmed.


CHANMODE - Shows which modes are forced or denied on a channel.

Usage: CHANMODE

Shows or changes the list of channel modes being enforced on the channel, where:

channel - the channel to use modes - the list of modes to allow or deny. Modes specified with + will be enforced on the channel at all times, those specified with - will not be allowed on the channel. If modes are not specified the current setting will be displayed. If +k or +l modes are included, the actual key or limit to be enforced must also be specified, for example "-il+ntk mykey", or "+nstl-Cc 20". If you do not want any modes enforced, "CHANMODE none" will clear the list.

Viewing the enforced modes requires operator (+o) access on the named channel.

Updating the enforced modes requires master (+m) access on the named channel.

Note: unlike similar commands that work on flags, specifying modes REPLACES

the list of modes to be enforced rather than changing the existing list. This

is because - modes are valid as well as + modes. Thus whenever you specify

the modes argument you must provide the complete list of desired modes each

time.

Note: if autolimit is enabled (see CHANFLAGS) it will cause a +l limit mode

to be enforced, with the value updating periodically as users join and leave.

This +l forcing cannot be changed or overridden without disabling the autolimit

function using the CHANFLAGS command.



What channel modes are available on QuakeNet?


The commands /MODE #channel …. are only active if there is one in the channel.

If you want to set them permanently use /MSG Q CHANMODE …..


Channel mode +b

Channel ban

Bans an address from a channel. Any user with a host mask matching this address will be denied entry to the channel. If the user is already in the channel and does not have op/voice status, the user will not be able to speak.

Usage: /MODE #channel +b nick!ident@host

Note: When a new QuakeNet fake host is banned (i.e. *!*@authname.users.quakenet.org) that authname is banned regardless of the user's host.


Channel mode +c

No control codes

Prohibits mIRC & ANSI control codes (colours/bold/underline/italics/reverse) from being sent to a channel.

Usage: /MODE #channel +c


Channel mode +C

No channel CTCPs

Prohibits channel wide CTCPs.

Usage: /MODE #channel +C


Channel mode +D

Delayed join mode

Joining users will not be shown until they are opped/voiced, change the topic or speak.

Usage: /MODE #channel +D

Note that hidden users will not be revealed when the mode is cleared. Hidden users can be seen with /NAMES -d #channel.


Channel mode +d

Hidden users present

This mode is set automatically by a server when channel mode +D is cleared and there are still users hidden in the channel. It can only be set or cleared by the server and is removed automatically when all users become visible. Hidden users can be seen with /NAMES -d #channel.


Channel mode +i

Invite only

This prevents users from joining a channel until they are invited by a channel op, L, or Q

Usage: /MODE #channel +i

You may invite users by typing /INVITE nickname #channel. Note that inviting a user bypasses possible bans set on him.


Channel mode +k

Key'ed (Passworded) Channel

Sets a key/password on a channel, without which people will be unable to join the channel.

Usage: /MODE #channel +k key

To join a channel which has a key set, do /JOIN #channel key

To remove channel mode +k, use /MODE #channel -k key


Channel mode +l

Limit

Only allows a certain number of people to join the channel.

Usage: /MODE #channel +l limit


Channel mode +m

Moderated

This mode moderates the channel, i.e. prevents users without voice or op status from sending messages to a channel.

Usage: /MODE #channel +m


Channel mode +M

Moderate for non-authed user

Non-authed users cannot speak in channels having +M set as long as they are not voiced nor opped.

Usage: /MODE #channel +M


Channel mode +n

No external messages

This prevents users from externally messaging a channel. The users must be on the channel to message it.

Usage: /MODE #channel +n


Channel mode +N

No channel notices

Prohibits the sending of channel notices.

Usage: /MODE #channel +N


Channel mode +o

Operator

Gives operator status to a user on a channel, allowing them to set or remove channel modes, kick/ban users, set the topic when channel mode +t is set and invite users into the channel.

Usage: /MODE #channel +o nickname


Channel mode +p

Private

This prevents the users in the channel being viewed externally. The channel also does not appear in a /LIST or /WHOIS, however the topic can be viewed using the /TOPIC command. Also see channel mode +s. +p cannot be set at the same time as +s.

Usage: /MODE #channel +p


Channel mode +r

Authed users only

This mode only allows users authed with Q to join the channel. They will receive the message "You must be authed to join this channel (+r)" when they attempt to join your channel when not authed. Once they have authed they will be able to join the channel normally. +r is a useful mode to set during flood attacks rather than +i (invite only).

Usage: /MODE #channel +r


Channel mode +s

Secret

This prevents the users in the channel or the topic being viewed externally using /TOPIC. The channel also does not appear in a /LIST or /WHOIS. Also see channel mode +p. +s cannot be set at the same time as +p.

Usage: /MODE #channel +s


Channel mode +t

Topic Lock

Only channel operators may set the topic.

Usage: /MODE #channel +t


Channel mode +T

Deny multiple channel messages

Messages with multiple channel targets (for example /amsg) cannot be sent to channels having +T set. A multiple channel target message is defined by more than one channel given as parameter.

Usage: /MODE #channel +T


Channel mode +u

No Part/Quit reasons

If a user is in any channel with channel mode +u set their quit and part messages are stripped, e.g. Quit (User definable quit message) would appear as Quit (Signed off).

Usage: /MODE #channel +u


Channel mode +v

Voice

Gives voice status to a user on a channel, thus allowing them to speak when the channel is moderated.

Usage: /MODE #channel +v nickname


By default, channels are created with the flags +tCNn

…................................................................

If u went to set them automatically by Q use

/MSG Q CHANMODE #channel mode like mentioned at CHANMODE

(mode can be +tnCNu for example)

…........................................................


CHANOPHISTORY - Displays a list of who has been opped on a channel recently with account names.

Usage: CHANOPHISTORY

Displays a list of users who have recently been opped on a channel by the service, along with the account name responsible for the opping. Usually this is the account the user being opped was using, but in the case of the OP command being used to op other users, the account used by the user issuing the OP command will be shown.

Where:

channel - the channel to use

CHANOPHISTORY requires operator (+o) access on the named channel.


CHANSTAT - Displays channel activity statistics.

Usage: CHANSTAT [RESET]

Shows some statistics about a channel, including total number of joins and maximum channel size. Two sets of statistics are displayed, a lifetime counter, and a trip meter counter which can be reset.

Where:

channel - channel to display statistics for.

CHANSTAT requires master (+m) access on the named channel.


CLEARCHAN - Removes all modes from a channel.

Usage: CLEARCHAN

Removes all channel modes (such as keys, limits, invite only, etc.) from the named channel. Modes being enfored (see CHANMODE) will not be removed.

Where:

channel - channel to remove modes from

CLEARCHAN requires master (+m) access on the named channel.


CLEARTOPIC - Clears the topic on a channel.

Usage: CLEARTOPIC

Clears the topic on a channel, where:

channel - channel to use

CLEARTOPIC requires topic (+t) or master (+m) access on the named channel.


DEOPALL - Deops all users on channel.

Usage: DEOPALL

Deops every user in the channel. Registered channel operators (+o on CHANLEV) who are protected (via the +p flag in CHANLEV or CHANFLAGS) will not be deopped.

Where:

channel - channel to use

DEOPALL requires master (+m) access on the named channel.


DEVOICEALL - Devoices all users on a channel.

Usage: DEVOICEALL

Devoices all users in the channel. Registered voices (+v on CHANLEV) who are

protected (+p flag set in CHANLEV or CHANFLAGS) will not be devoiced.

DEVOICEALL requires master (+m) access on the named channel.



EMAIL - Change your email address.

Usage: EMAIL

Changes your register email address. Confirmation of the change will be sent both old and new addresses.

Where:

password - your password

email - new email address.

Must be entered exactly the same way twice to avoid mistakes.

Note: due to the sensitive nature of this command, you must send the message to Q@CServe.quakenet.org when using it.

.

GIVEOWNER - Gives total control over a channel to another user.

Usage: GIVEOWNER

Gives complete control (+n flag) to the named user on the channel. The new owner will have full control over the channel, including the ability to remove the

existing owner(s). As a precaution the named user must already have master (+m)

access on the channel. Use this command with extreme caution. Where:

channel - channel to use

user - user to give owner to, either a nickname on the necode - a unique code used to authorize the operation. If the code is not

supplied, the appropriate code will be provided together with a

warning about the dangers of this command. If the wrong code is

entered owner access will not be granted.

GIVEOWNER requires owner (+n) access on the named channel.



HELP - Displays help on a specific command.

Usage: HELP

Shows help for a command, where:

command - the command to show help for.

For a list of available commands, see SHOWCOMMANDS.


INVITE - Invites you to a channel or channels.

Usage: INVITE []

Invites you to one or more channels, where:

channel - channel to be invited to.

If no channel is specified, you will be invited to all channels where you have appropriate access and are not already joined.

INVITE requires you to be known (+k) on the named channel


NEWPASS - Change your password.

Usage: NEWPASS

Changes your account password. Your new password must be at least 6 characters

long, contain at least one number and one letter, and may not contain sequences

of letters or numbers. Your new password will be sent to your registered email

address.

Where:

oldpassword - your existing account password

newpassword - your desired new password.

Must be entered the same both times.

Note: due to the sensitive nature of this command, you must send the message to

Q@CServe.quakenet.org when using it.


OP - Ops you or other users on channel(s).

Usage: OP [...]

Ops you on one or more channels, or ops other named users on a given channel.

This command cannot be used to op users who are otherwise prevented from getting ops, e.g. via the +d chanlev flag (see CHANLEV) or bitch mode (see CHANFLAGS).

Where:

channel - channel to use. If no channel is specified, you will be given ops on

every channel where you have appropriate access and are not already opped.

user - user(s) to op instead of yourself. Each user must be specified as the

current nickname of a user on the named channel.

OP requires operator access (+o) on the named channel. If this command is used

to op other users, a notice will be sent to other channel operators on the channel identifying you, unless you have master (+m) access.


PERMBAN - Permanently bans a hostmask on a channel.

Usage: PERMBAN []

Permanently bans the provided hostmask on the channel. If the ban is

removed from the channel e.g. by a channel op or the BANTIMER feature, the

ban will be reapplied if a matching user joins the channel. Bans

set with the PERMBAN command can be removed with BANCLEAR or BANDEL.

Any users matching the hostmask will be kicked from the channel.

Where:

channel - channel to set a ban on

hostmask - hostmask (nick!user@host) to ban.

reason - reason for the ban. This will be used in kick messages when kicking

users matching the ban. If this is not provided the generic message "Banned." will be used.

PERMBAN requires master (+m) access on the named channel.


RECOVER - Recovers a channel (same as deopall, unbanall, clearchan).

Usage: RECOVER

This command resets the named channel if undesired modes, bans or ops have been set. This has the same effect as DEOPALL followed by UNBANALL followed by

CLEARCHAN on the channel, where:

channel - channel to recover

RECOVER requires master (+m) access on the named channel.


REMOVEUSER - Removes one or more users from a channel.

Usage: REMOVEUSER [...]

Removes any flags the named user(s) have on the channel. This command

cannot be used to remove owners (+n) from the channel, and cannot be used

to remove masters (+m) unless the user issuing the command is an owner.

Where:

channel - channel to use

user - a user to remove. Can either be a nickname on the network

or #authname. Up to 18 users can be specified.

REMOVEUSER requires master (+m) access on the named channel.


REQUESTOWNER - Requests ownership of a channel on which there are no owners.

Usage: requestowner

Requests owner (+n) access to the named channel. In order to use this command,

there must be no owners left on the channel, and you must have the highest

access level of the remaining users.

Where:

channel - the channel to request ownership of


SETTOPIC - Changes the topic on a channel.

Usage: SETTOPIC

Changes the topic on the channel, where:

channel - channel to use

topic - new topic. If no topic is set, the stored topic will be reset (this

feature is useful if some users can no longer see the topic due to a

netsplit).

SETTOPIC requires topic (+t) or master (+m) access on the named channel.


SHOWCOMMANDS - Lists available commands.

Usage: SHOWCOMMANDS

Prints a list of commands currently available to you, where:

mask - Mask of commands to list (* or ? are wildcards). If no mask is specified,

all available commands are displayed.



TEMPBAN - Bans a hostmask on a channel for a specified time period.

Usage: TEMPBAN

Temporarily bans the provided hostmask on the channel. If the ban is

removed from the channel e.g. by a channel op or the BANTIMER feature, the

ban will be reapplied if a matching user joins the channel. When the time

expires the ban will be removed automatically. Bans set with the TEMPBAN

command can be removed before they expire with BANCLEAR or BANDEL. Any users matching the hostmask will be kicked from the channel.

Where:

channel - channel to set a ban on

hostmask - hostmask (nick!user@host) to ban.

duration - length of time to apply the ban for. Suffixes m (minutes), h (hours),

d (days), w (weeks), M (months) and y (years) can be used to specify the duration, for example 3d, 5h, 1h30m, 1M.

reason - reason for the ban. This will be used in kick messages when kicking

users matching the ban.

If this is not provided the generic message "Banned." will be used.

TEMPBAN requires master (+m) access on the named channel.


UNBANALL - Removes all bans from a channel.

Usage: UNBANALL

Removes all the channel bans set on the named channel. This does not affect

persistent bans set via the TEMPBAN and PER BANDEL for more information on removing those bans.

Where:

channel - channel to use

UNBANALL requires master (+m) access on the named channel.


UNBANMASK - Removes bans matching a particular mask from a channel.

Usage: UNBANMASK

Removes any bans on the channel which are overlapped by the named mask. Can

remove both channel bans and registered bans.

Where:

channel - channel to use

mask - mask to remove. Any ban subsumed by this mask will be removed. For

example, UNBANMASK *!*@*.isp.net would remove *!*@host1.isp.net and

*!*@host2.isp.net and *!user@*.isp.net.

UNBANMASK requires operator (+o) access on the named channel.

Removing registered bans requires master (+m) access on the named channel.


UNBANME - Removes any bans affecting you from a channel.

Usage: UNBANME

This command removes any channel bans which affect you from a channel.

It does not affect persistent bans set by PERMBAN and TEMPBAN.

Where:

channel - channel to use

UNBANME requires operator (+o) access on the named channel. Usage:


USERFLAGS - Shows or changes user flags.

USERFLAGS

Changes your current user flags, where:

flags - changes to apply, in the usual flag letters preceded by +/- format.

Valid user flags are:

+c ACH'MENTS - enables achievements system - allows use of achievement commands and sends achievement messages.

+n NOTICE - causes the bot to sent you NOTICEs.

If this flag is not set the bot will communicate using PRIVMSG


USERS - Displays a list of users on the channel.

Usage: USERS

Displays a list of users on the named channel along with their usernames and flags

on the channel, where:

channel - channel to list

USERS requires you to be known (+k) on the named channel. You must also be on the channel yourself.


VERSION - Show Version.

Usage: VERSION

Shows the version number of the running bot.


VOICE - Voices you or other users on channel(s).

Usage: VOICE [...]

Grants voice to you on one or more channels, or grants voice to one or more

other users on a particular channel. This command cannot be used to grant

voice to users who would otherwise be prevented from obtaining voice, e.g.

the quiet (+q) chanlev flag.

Where:

channel - channel to use. If no channel is specified, you will be granted voice

on every channel where you have appropriate access and are not already

voiced.

user - other users to grant voice to. Must be specified as the nickname

of users who are on the named channel.

Voicing yourself requires voice (+v) access on the relevant channels.

Voicing other users requires operator (+o) access on the named channel. If this

command is used to voice other users, a notice will be sent to channel operators

on the channel identifying you, unless you have master (+m) access.


WELCOME - Shows or changes the welcome message on a channel.

Usage: WELCOME

This shows the current welcome message set on a channel and allows it to be

changed. In order to be displayed to users, the feature must be enabled

by the +w chanflag (see CHANFLAGS).

Where:

message - welcome message to set. If this is not provided the existing welcome

message is displayed.

Displaying the message requires operator (+o) access on the named channel.

Changing the message requires master (+m) access on the named channel.


WHOAMI Displays information about you


Usage: WHOAMI

Displays various information about your account.


WHOIS Displays information about a user.

Usage: WHOIS

Displays information about a user, where:

user - user to request information for, either the nickname of an active user on

the network or #accountname.