Difference between revisions of "Irc setup"

From The Powder Toy
Jump to: navigation, search
m (1 revision)
(talk)
Line 1: Line 1:
<h3> =Introduction </h4>
+
<h3> =Introduction </h3>
 
This guide will show you how to set up an Internet Relay Chat Client (IRC Client).
 
This guide will show you how to set up an Internet Relay Chat Client (IRC Client).
 
IRC clients allow you to access IRC, which is a protocol that allows you to connect to servers which host multiple channels, which are like chat rooms. It's a very powerful protocol that is extensible and can be used in a variety of ways.
 
IRC clients allow you to access IRC, which is a protocol that allows you to connect to servers which host multiple channels, which are like chat rooms. It's a very powerful protocol that is extensible and can be used in a variety of ways.
Line 14: Line 14:
 
This should be common knowledge, but read it anyway. Don't accept any files over DCC (IRC's file sharing protocol) from someone you don't know.
 
This should be common knowledge, but read it anyway. Don't accept any files over DCC (IRC's file sharing protocol) from someone you don't know.
  
<h2> Setup </h3>
+
<h2> Setup </h2>
 
For the purposes of this guide, we will be using IceChat. There are other IRC clients that are suitable for other purposes, for example, mIRC has powerful scripting support (shareware), XChat and XChat 2.0 employ a minimal interface, and irssi and BitchX are text-only (CLI), extensible, and have powerful scripting support.  
 
For the purposes of this guide, we will be using IceChat. There are other IRC clients that are suitable for other purposes, for example, mIRC has powerful scripting support (shareware), XChat and XChat 2.0 employ a minimal interface, and irssi and BitchX are text-only (CLI), extensible, and have powerful scripting support.  
  
Line 46: Line 46:
  
  
<h2> IRC Netiquette </h3>
+
<h2> IRC Netiquette </h2>
 
'''1.''' It is common courtesy to address a message to a specific user (thats not in a private message (also known as a query - more on that later)) with their nick, a colon, and then the message, because this highlights them (more on highlighting later). For example, ''raj-k: You are the most awesomest person that ever existed.''
 
'''1.''' It is common courtesy to address a message to a specific user (thats not in a private message (also known as a query - more on that later)) with their nick, a colon, and then the message, because this highlights them (more on highlighting later). For example, ''raj-k: You are the most awesomest person that ever existed.''
  
 
'''2.''' Try not to spam up the channel with anything - either nick changes, repeated disconnections and connections, or regular spam. If you want to talk to a specific group of friends, create a channel for yourself (see the /join command below, on the Commands subsection).
 
'''2.''' Try not to spam up the channel with anything - either nick changes, repeated disconnections and connections, or regular spam. If you want to talk to a specific group of friends, create a channel for yourself (see the /join command below, on the Commands subsection).
  
<h2> Our Channels </h3>
+
<h2> Our Channels </h2>
 
^Channel^Description^
 
^Channel^Description^
 
|#powder | The main channel|
 
|#powder | The main channel|
Line 62: Line 62:
  
  
<h2> Commands </h3>
+
<h2> Commands </h2>
 
[[http://www.ircbeginner.com/ircinfo/ircc-commands.html]] has some more basic commands along with descriptions and examples.
 
[[http://www.ircbeginner.com/ircinfo/ircc-commands.html]] has some more basic commands along with descriptions and examples.
  
<h3> /msg </h4>
+
<h3> /msg </h3>
 
''/msg nickserv help'' for help with your nick and nick registration (more on that later)
 
''/msg nickserv help'' for help with your nick and nick registration (more on that later)
 
''/msg chanserv help'' for help with the channel you are currently in and commands to perform on it
 
''/msg chanserv help'' for help with the channel you are currently in and commands to perform on it
 
''/msg memoserv help'' for help on sending messages to users who are not online
 
''/msg memoserv help'' for help on sending messages to users who are not online
  
<h3> /connect </h4>
+
<h3> /connect </h3>
 
''/connect [server]:[port]'' to connect to a server. If your IRC client does not support multiple-server connections, this will disconnect your previous server.
 
''/connect [server]:[port]'' to connect to a server. If your IRC client does not support multiple-server connections, this will disconnect your previous server.
  
<h4> =/away </h5>
+
<h4> =/away </h4>
 
''/away [reason]''to leave temporarily.
 
''/away [reason]''to leave temporarily.
  
<h3> /server </h4>
+
<h3> /server </h3>
 
''/server [server]:[port]'' to connect to a server. This will disconnect all previous servers regardless of IRC client.
 
''/server [server]:[port]'' to connect to a server. This will disconnect all previous servers regardless of IRC client.
  
<h3> /join </h4>
+
<h3> /join </h3>
 
''/join [channel]'' to join a channel. Remember, all channels are prefixed with a #. If you join a channel that does not exist (e.g., /join #rewriewrnoefwfwef), the server (irc.freenode.net) will create the channel for you and you will be named the operator of that channel by default. You can register channels to preserve your operator position (more on that later).
 
''/join [channel]'' to join a channel. Remember, all channels are prefixed with a #. If you join a channel that does not exist (e.g., /join #rewriewrnoefwfwef), the server (irc.freenode.net) will create the channel for you and you will be named the operator of that channel by default. You can register channels to preserve your operator position (more on that later).
  
<h3> /part </h4>
+
<h3> /part </h3>
 
''/part [message]'' to leave a channel.
 
''/part [message]'' to leave a channel.
  
<h3> /quit </h4>
+
<h3> /quit </h3>
 
''/quit [message]'' to disconnect from the server. [message] is optional. By default, it will be "Quit.".
 
''/quit [message]'' to disconnect from the server. [message] is optional. By default, it will be "Quit.".
  
<h3> /nick </h4>
+
<h3> /nick </h3>
 
''/nick [newnick]'' to change your nick.
 
''/nick [newnick]'' to change your nick.
  
<h3> /names </h4>
+
<h3> /names </h3>
 
''/names'' for a list of the people on the channel.
 
''/names'' for a list of the people on the channel.
  
<h3> /me </h4>
+
<h3> /me </h3>
 
''/me [message]'' or ''/action [message]'' to say something in third person. For example, the message "Hello, World" would show up as:  
 
''/me [message]'' or ''/action [message]'' to say something in third person. For example, the message "Hello, World" would show up as:  
 
<code>
 
<code>
Line 115: Line 115:
 
</code>
 
</code>
  
<h3> /cycle </h4>
+
<h3> /cycle </h3>
 
''/cycle [channel(s)]'' /part's you then /join's you to the chosen channels.  
 
''/cycle [channel(s)]'' /part's you then /join's you to the chosen channels.  
  
<h3> /query <nick> </h4>
+
<h3> /query <nick> </h3>
 
Opens a private messaging window between you and <nick>. This takes place outside any channel you may be in.
 
Opens a private messaging window between you and <nick>. This takes place outside any channel you may be in.
  
<h2> Operator commands </h3>
+
<h2> Operator commands </h2>
 
(only usable if you are an operator)
 
(only usable if you are an operator)
  
<h3> /kick </h4>
+
<h3> /kick </h3>
 
''/k [nick]'' to kick a user (takes them off the channel). The user can still rejoin, however..
 
''/k [nick]'' to kick a user (takes them off the channel). The user can still rejoin, however..
  
<h3> /ban </h4>
+
<h3> /ban </h3>
 
''/b [nick]'' to ban a user. This bans their hostname too, so changing their nick won't allow them access. However, this does not kick a user off the channel. If a user is not on the channel, they won't be able to join.
 
''/b [nick]'' to ban a user. This bans their hostname too, so changing their nick won't allow them access. However, this does not kick a user off the channel. If a user is not on the channel, they won't be able to join.
  
<h3> /kickban </h4>
+
<h3> /kickban </h3>
 
''/kb [nick]'' to kick and ban a user.
 
''/kb [nick]'' to kick and ban a user.
  
<h3> /topic </h4>
+
<h3> /topic </h3>
 
''/topic [topic]'' to change the topic.
 
''/topic [topic]'' to change the topic.
  
<h2> Other </h3>
+
<h2> Other </h2>
<h3> Nick Registration </h4>
+
<h3> Nick Registration </h3>
 
On server(or channel) type  
 
On server(or channel) type  
 
<code>
 
<code>
Line 159: Line 159:
 
</code>
 
</code>
  
<h2> Bot commands </h3>
+
<h2> Bot commands </h2>
 
StewieGriffin and PowderBanBot are the resident bots in the powder channels.
 
StewieGriffin and PowderBanBot are the resident bots in the powder channels.
 
PowderBanBot helps us controls bans across our channels.
 
PowderBanBot helps us controls bans across our channels.
Line 165: Line 165:
 
These are some of the basic commands for the bot. If you need to use a lot of them, please use a query.
 
These are some of the basic commands for the bot. If you need to use a lot of them, please use a query.
  
<h3> $seen "Player" </h4>
+
<h3> $seen "Player" </h3>
 
The bot will find the last message made by "Player" and the time it was sent.
 
The bot will find the last message made by "Player" and the time it was sent.
  
<h3> $randomsave </h4>
+
<h3> $randomsave </h3>
 
Displays a random TPT save.
 
Displays a random TPT save.
  
<h3> $profile <user> </h4>
+
<h3> $profile <user> </h3>
 
Returns some basic information from a users profile.
 
Returns some basic information from a users profile.
  
<h3> URLS </h4>
+
<h3> URLS </h3>
 
YouTube and Powder Toy save URLs will automatically display a description. For example, https://powdertoy.co.uk/Browse/View.html?ID=2198 will be followed by:
 
YouTube and Powder Toy save URLs will automatically display a description. For example, https://powdertoy.co.uk/Browse/View.html?ID=2198 will be followed by:
  
 
''Save is "Destroyable city 5 (wth metro)" by "dima-gord"''
 
''Save is "Destroyable city 5 (wth metro)" by "dima-gord"''
  
<h4> =Other Commands </h5>
+
<h4> =Other Commands </h4>
 
The help for these commands is taken straight for the bot. If the command is marked with an asterix (*) then please use a query for it, as it can be quite verbose.
 
The help for these commands is taken straight for the bot. If the command is marked with an asterix (*) then please use a query for it, as it can be quite verbose.
  
<h4> $ls* </h5>
+
<h4> $ls* </h4>
 
(list [<plugin>]) -- Lists the commands available in the given plugin. If no plugin is given, lists the public plugins available.
 
(list [<plugin>]) -- Lists the commands available in the given plugin. If no plugin is given, lists the public plugins available.
  
<h4> $google </h5>
+
<h4> $google </h4>
 
(google <search> [--{filter,language} <value>]) -- Searches google.com for the given string. As many results as can fit are included. --language accepts a language abbreviation; --filter accepts a filtering level ('active', 'moderate', 'off')
 
(google <search> [--{filter,language} <value>]) -- Searches google.com for the given string. As many results as can fit are included. --language accepts a language abbreviation; --filter accepts a filtering level ('active', 'moderate', 'off')
  
<h4> $calc </h5>
+
<h4> $calc </h4>
 
(calc <math expression>) -- Returns the value of the evaluated <math expression>. The syntax is Python syntax; the type of arithmetic is floating point. Floating point arithmetic is used in order to prevent a user from being able to crash to the bot with something like '<nowiki>10'''10'''10'''10'. One consequence is that large values such as '10'''24'</nowiki> might not be exact.
 
(calc <math expression>) -- Returns the value of the evaluated <math expression>. The syntax is Python syntax; the type of arithmetic is floating point. Floating point arithmetic is used in order to prevent a user from being able to crash to the bot with something like '<nowiki>10'''10'''10'''10'. One consequence is that large values such as '10'''24'</nowiki> might not be exact.
  
<h2> IRC Help </h3>
+
<h2> IRC Help </h2>
 
If you ever need help dealing specifically with the Freenode server and channels, and an operator cannot help you, just join '''#freenode''' and ask for a staff member. They can help you.
 
If you ever need help dealing specifically with the Freenode server and channels, and an operator cannot help you, just join '''#freenode''' and ask for a staff member. They can help you.
  
Line 202: Line 202:
 
See, the query is open with me and dikzak (a.k.a. lieuwe and doxin)
 
See, the query is open with me and dikzak (a.k.a. lieuwe and doxin)
  
<h2> Registering and maintaining a channel </h3>
+
<h2> Registering and maintaining a channel </h2>
 
'''You must be registered with NickServ to register a channel.'''
 
'''You must be registered with NickServ to register a channel.'''
 
To registered a channel, first join the channel you want using /join. '''Remember, all channels must have a ## not just a # at the beginning of the name.''' The letters/numbers after the ## can be anything you want. However, the channel you want may already be registered.
 
To registered a channel, first join the channel you want using /join. '''Remember, all channels must have a ## not just a # at the beginning of the name.''' The letters/numbers after the ## can be anything you want. However, the channel you want may already be registered.
Line 241: Line 241:
 
to be added
 
to be added
  
<h2> Operators </h3>
+
<h2> Operators </h2>
 
Channel operators have full control over the channel and can kick, ban, and conduct other administrative activities. Channel ops on #powder are usually moderators/administrators on the website, though there are moderators that are not operators (ops for short), and vice-versa. You can identify an op by looking at their nick on the list of nicks. If their nick is prefixed by a "@", they are an operator.
 
Channel operators have full control over the channel and can kick, ban, and conduct other administrative activities. Channel ops on #powder are usually moderators/administrators on the website, though there are moderators that are not operators (ops for short), and vice-versa. You can identify an op by looking at their nick on the list of nicks. If their nick is prefixed by a "@", they are an operator.
  

Revision as of 19:28, 28 September 2011

=Introduction

This guide will show you how to set up an Internet Relay Chat Client (IRC Client). IRC clients allow you to access IRC, which is a protocol that allows you to connect to servers which host multiple channels, which are like chat rooms. It's a very powerful protocol that is extensible and can be used in a variety of ways.

For the purposes of this guide, though, we'll focus on joining The Powder Toy's primary channel.

For those of you who know how to use an IRC client, it is #powder on irc.freenode.net:6667 and #powder-social for socializing and off topic banter..

If you can't be bothered setting up an IRC client, or are on a computer where you can't install or download a program, go here: Freenode Webchat\\ This has been removed due to people abusing it :(

Read this page to learn about IRC safety: Internet Relay Chat Safety

This should be common knowledge, but read it anyway. Don't accept any files over DCC (IRC's file sharing protocol) from someone you don't know.

Setup

For the purposes of this guide, we will be using IceChat. There are other IRC clients that are suitable for other purposes, for example, mIRC has powerful scripting support (shareware), XChat and XChat 2.0 employ a minimal interface, and irssi and BitchX are text-only (CLI), extensible, and have powerful scripting support.

Most IRC clients, with the exception of irssi and BitchX will be easy to use for most users will be similar to IceChat, so the instructions provided below will be of help to users of any client.

1. ^Program^Homepage^Platforms^Cost^ | IceChat | http://www.icechat.net/site/ | Windows | Free | | mIRC | http://www.mirc.com/ | Windows | 30Day Trial - 20.00 USD | | XChat | http://xchat.org/ | *NIX | Free | | XChat 2.0 | http://www.silverex.org/news/ | Windows | Free | | irssi | http://irssi.org/ | Windows - Mac - *NIX | Free | | BitchX | http://www.bitchx.com/ | Windows - *NIX | Free | | Colloquy | http://colloquy.info/ | Mac | Free | | KVIrc: | http://www.kvirc.net/ | Windows - Mac - *NIX | Free | Linux clients are usually available for you to install via your package manager.

2. Run the installer and follow the prompts. irssi does not require installation.

3. Start your client.

4. Enter a nick (nickname) to use. This will be your "username", though others may use it too unless you register it (registering will be discussed later). If you wish to change your nick later, just type in "/nick [yournewnick]" and press enter. Most commands on IRC are executed commencing with the / key. There is a brief list of commands below.

5. When your IRC client prompts you for a server, enter "irc.freenode.net". If it asks for a port, type in 6667. If it asks for both in one textbox, type in "irc.freenode.net:6667".

6. Type in "/connect irc.freenode.net" into the text box and press enter. You might need to enter "/connect irc.freenode.net:6667". Your IRC client might have a GUI shortcut for this server. If so, you can use that.

{{http://i1220.photobucket.com/albums/dd454/jjc-ipod/TPT%20wiki/Connect.png?800x431}}

You have now connected to a server. In this server, there are many channels (chat rooms) you can join. The Powder Toy's official channel is #powder (all channels are prefixed by a #). To join #powder-social or #powder, simply type in "/join #powder" or "/join #powder-social" in the text box and press enter. You may see a list of the users at the right (View > Window > Userlist or similar for some IRC clients). Type in /names if you cannot find the userlist, or simply /n on irssi.


IRC Netiquette

1. It is common courtesy to address a message to a specific user (thats not in a private message (also known as a query - more on that later)) with their nick, a colon, and then the message, because this highlights them (more on highlighting later). For example, raj-k: You are the most awesomest person that ever existed.

2. Try not to spam up the channel with anything - either nick changes, repeated disconnections and connections, or regular spam. If you want to talk to a specific group of friends, create a channel for yourself (see the /join command below, on the Commands subsection).

Our Channels

^Channel^Description^ |#powder | The main channel| |#powder-social | Off topic banter| |#powder-nl | For our Dutch users| |#powder-deutch | For our German users| |#powder-info | Watch new users register| |##subpowder | This is where you'll find yourself if you aren't registered with Freenode or using a webchat client.| |#tptgames | A few games provided by Stewie are available here, There will also be a Mafia bot at some time in the future.|


Commands

[[1]] has some more basic commands along with descriptions and examples.

/msg

/msg nickserv help for help with your nick and nick registration (more on that later) /msg chanserv help for help with the channel you are currently in and commands to perform on it /msg memoserv help for help on sending messages to users who are not online

/connect

/connect [server]:[port] to connect to a server. If your IRC client does not support multiple-server connections, this will disconnect your previous server.

=/away

/away [reason]to leave temporarily.

/server

/server [server]:[port] to connect to a server. This will disconnect all previous servers regardless of IRC client.

/join

/join [channel] to join a channel. Remember, all channels are prefixed with a #. If you join a channel that does not exist (e.g., /join #rewriewrnoefwfwef), the server (irc.freenode.net) will create the channel for you and you will be named the operator of that channel by default. You can register channels to preserve your operator position (more on that later).

/part

/part [message] to leave a channel.

/quit

/quit [message] to disconnect from the server. [message] is optional. By default, it will be "Quit.".

/nick

/nick [newnick] to change your nick.

/names

/names for a list of the people on the channel.

/me

/me [message] or /action [message] to say something in third person. For example, the message "Hello, World" would show up as: <raj-k> Hello, World!

But prefixed by /me or /action, it would be

  • raj-k Hello, World!

You can see that doesn't make much sense, so you'd alter the text to make sense in third person, e.g., typing in "/me says Hello, World!". This results in

  • raj-k says Hello, World!

or

  • raj-k is drinking the blood of people who change their nick constantly.

/cycle

/cycle [channel(s)] /part's you then /join's you to the chosen channels.

/query <nick>

Opens a private messaging window between you and <nick>. This takes place outside any channel you may be in.

Operator commands

(only usable if you are an operator)

/kick

/k [nick] to kick a user (takes them off the channel). The user can still rejoin, however..

/ban

/b [nick] to ban a user. This bans their hostname too, so changing their nick won't allow them access. However, this does not kick a user off the channel. If a user is not on the channel, they won't be able to join.

/kickban

/kb [nick] to kick and ban a user.

/topic

/topic [topic] to change the topic.

Other

Nick Registration

On server(or channel) type /msg NickServ register [password] [e-mail] Remember to before registering change your nick(using /nick command) to nick that you want to register! Either another nick will be registered.

To login change your nick(using /nick command) to nick that you registered and type: /msg NickServ identify [password_that_you_registered]

Or you can login using a nick that is not registered to your account by using: /msg NickServ identify [nick_that_you_registered] [password_that_you_registered]

You can also group other nicks to your account by using /nick to get to the nick you want to group, then typing: /msg NickServ group

Bot commands

StewieGriffin and PowderBanBot are the resident bots in the powder channels. PowderBanBot helps us controls bans across our channels. StewieGriffin is there to help us and provide some functionality making our channels and the site easy to use. All of his commands can be accessed in a query with him. These are some of the basic commands for the bot. If you need to use a lot of them, please use a query.

$seen "Player"

The bot will find the last message made by "Player" and the time it was sent.

$randomsave

Displays a random TPT save.

$profile <user>

Returns some basic information from a users profile.

URLS

YouTube and Powder Toy save URLs will automatically display a description. For example, https://powdertoy.co.uk/Browse/View.html?ID=2198 will be followed by:

Save is "Destroyable city 5 (wth metro)" by "dima-gord"

=Other Commands

The help for these commands is taken straight for the bot. If the command is marked with an asterix (*) then please use a query for it, as it can be quite verbose.

$ls*

(list [<plugin>]) -- Lists the commands available in the given plugin. If no plugin is given, lists the public plugins available.

$google

(google <search> [--{filter,language} <value>]) -- Searches google.com for the given string. As many results as can fit are included. --language accepts a language abbreviation; --filter accepts a filtering level ('active', 'moderate', 'off')

$calc

(calc <math expression>) -- Returns the value of the evaluated <math expression>. The syntax is Python syntax; the type of arithmetic is floating point. Floating point arithmetic is used in order to prevent a user from being able to crash to the bot with something like '10'''10'''10'''10'. One consequence is that large values such as '10'''24' might not be exact.

IRC Help

If you ever need help dealing specifically with the Freenode server and channels, and an operator cannot help you, just join #freenode and ask for a staff member. They can help you.

Queries

A query is basically a private chat with somebody on the channel you are on. This is usually done by double-clicking on a nick, or by writing /query [user nick].

Template:Http://img9.imageshack.us/img9/6703/1110f.jpg

See, the query is open with me and dikzak (a.k.a. lieuwe and doxin)

Registering and maintaining a channel

You must be registered with NickServ to register a channel. To registered a channel, first join the channel you want using /join. Remember, all channels must have a ## not just a # at the beginning of the name. The letters/numbers after the ## can be anything you want. However, the channel you want may already be registered. For now, lets say you want to register ##PT-cctv. Once in the channel, type: /msg ChanServ register ##PT-cctv

Some things will change once this is done. If you want to make yourself an operator every time you join the channel, you can use flags. The flag for making someone automatically an operator when they join is +O. To set this flag, type: /msg ChanServ flags ##PT-cctv [nickname] +O For a user to have flags set on them, they must be registered with NickServ. For a list of flags, type: /msg ChanServ help flags This lists flags that you can add.

If you get stuck at any time, type: /msg ChanServ help This lists ChanServ commands.

I also advise that you type: /msg ChanServ set ##PT-cctv guard on This makes sure you don't lose the topic and makes sure there is always 1 person in the channel (ChanServ).

Bots and Scripts to be added

irssi to be added

Operators

Channel operators have full control over the channel and can kick, ban, and conduct other administrative activities. Channel ops on #powder are usually moderators/administrators on the website, though there are moderators that are not operators (ops for short), and vice-versa. You can identify an op by looking at their nick on the list of nicks. If their nick is prefixed by a "@", they are an operator.

This is a list of all the operators on #powder:

  • frankbro
  • ief015 - RainbowDash - pief015
  • Skylark
  • \Simon\ - FacialTurd - iSimon - \S\
  • Catelite
  • devast8a
  • AntB - Xenocide - XenoB
  • Lockheedmartin
  • Triclops200

>A note to editors: > * Try to be client-ambiguous. Not everyone uses the same IRC client. > * Pictures are appreciated when adding new sections. But don't make them too large. You should only include the relevent sections.

In case you'd like a detailed mIRC first use tutorial, check out the MerbosMagic website for the tutorial.