Shegg:HOWTO

In other languages: English | Afrikaans | Albanian | Arabic | Brazilian | Bulgarian | Catalan | Chinese | Croatian | Czech | Danish | Dutch | Esperanto | Estonian | Filipino | Finnish | Flemish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Latvian | Lithuanian | Macedonian | Malay | Malayalam | Norwegian (Bokmål) | Norwegian (Nynorsk) | Persian | Polish | Portuguese | Romanian | Russian | Serbian | Slovak | Slovenian | Spanish | Swedish | Turkish | Ukrainian | Urdu

Please Remember!

Remember to run the 'myports' command when using any process requiring ports. This command will show you your two (2) assigned ports, and if you are running any ports that do not belong to you. Running any port or ports other than the two assigned to you will lock your account.

Please be aware that running a statistics or 'stats' script on your bot may call open other non-assigned ports, and earn you a 'bad ports' mention. Check your scripts carefully and use the myports command.

Shegg HOWTO

Introduction

When you have finally earned your shell, and you want to run an Eggdrop on your shell, you should know that you don't need to install the Eggdrop from scratch and download all source files. It's allready installed and ready to use.

The only thing you need to do is run the "shegg" command and it will guide you to making a Eggdrop config file with everything you need.

I'm not going explain everything about Eggdrop, you can read it in another article here on the shellium wiki.

So let's get started.

Getting started Making an eggdrop.conf using "shegg"

First login to your shell with your Username and password , and type shegg.

03:23:28 Username:~$ shegg

When using the shegg command, you should get into the menu:

        This program assumes you will be using the SHellium.org eggdrop.

                Welcome to the Eggdrop Configuration Setup Script.
                You will now be prompted for your eggdrop settings.
                ACCEPT THE DEFAULTS UNLESS YOU KNOW WHAT YOUR DOING!!!

Now lets get started , making our config file:

---

Now we got to answer some questions to set up our Eggdrop config file properly. Make sure you you are using the right settings, if you don't, just use the defaults. You can change the config later on to correct these if you want.

First question asked:

Directory where your eggdrop will be created [/home/s/Username/sheggdrop...JUST PRESS ENTER]:

I'm going to be nice to the program and just use the default by pressing ENTER

Next question is to set your bots nickname that its going to use when connecting to irc. This is also going to be the botnick.config filename

Botnick this is the nick by which your bot will join and will become the name of the conf file as well: Eggdrop (press '''ENTER''')

Now that we have set the bots nickname , it will ask whats the admins nickname

This setting defines which contact person should be shown in .status,
/msg help, and other places. You really should include this information.

What is the Admins Name/Nick?: Admin (press '''ENTER'''

Setting your admin email will be making it useful to contact you when needed

What is the Admins e-mail?: Admin@email.org (example Email adress)

Next step is to set the owners nickname off the bot. if its the same as the admins nickname [ Admin ] then just hit enter, if not, change it.

Who is the owner of the bot? [ Admin ]:

Just hit enter on the next step, you can change it at a later time.

This setting is used only to share information with others on your botnet.
Set this to the IRC network your bot is connected to .JUST PRESS ENTER.

What is the network the bot will reside on: this can be anything you want, if you don't know, it doesn't matter, just hit enter. [ botnetshellium ]?:

Set your timezone for the bot.

This setting defines the timezone your bot is in. It's used for internal
routines as well as for logfile timestamping and scripting purposes.
The timezone string specifies the name of the timezone and must be three
or more alphabetic characters. For example, Central European Time(UTC+1)
should be CET.

What is the timezone the bot lives in? i.e.. PST CST EST [ EST ]:

is the timezone offset setting. change this or just hit enter.

The offset setting specifies the time value to be added to the local
time to get Coordinated Universal Time (UTC aka GMT). The offset is
positive if the local timezone is west of the Prime Meridian and
negative if it is east. The value (in hours) must be between -23 and
23. For example, if the timezone is UTC+1, the offset is -1.

What is the timezone offset?:

Next step is to set your bots vhost. you can choose from several others by typing vhosts into your shell. I like the one setting there so i'm just gonna hit enter.

Would you like to set your host, JUST HIT ENTER TO SET free.psybnc.and.eggdrop.at.shellium.org  as a vhost[ y/N ]:

This is the alternative nickname your bot would use when his nick is already used on irc. Like mine is called Eggdrop, ill name mine Edrop (just an example).

Set the alternative nick which the bot uses on IRC if Edrop is unavailable.
All '?' characters will be replaced by random numbers.
Not setting this will result in the default being used i.e. Edrop?.
And no entry will be made in the conf file. If you want it there even as default for
later use type (y)and then just hit Enter.

Would you like to set your bots altnick? [ y/N ]: Edrop?

This is for making the bot identify to nickserv (when there is any). I didnt set one at this time and hit enter.

The password for the bot needs to be set before for it to work.
To do that you need to register it with nickserv, otherwise this is useless.

What did you set the bots password to with nickserv?: password

Setting a username that the bot will use on irc.

This setting defines the username the bot uses on IRC. This setting has
no effect if an ident daemon is running on your bot's machine.
This is the UID in the host on joins/parts and in whois i.e. username@network.org

What is the username?: Username

Setting real name will show it when someone msgs the bot or whoises it. I have set Eggdrop. (nothing special)

Set what should be displayed in the real-name field for the bot on IRC.

What realname would you like? Recommended you change this [ /msg SHelliumBot hello ]: Eggdrop

If you want to make this bot the main bot for a botnet, then you should give it a name. This is used to set all the other bots what the main bot is. when adding them to the botnet. I'm not using a botnet so i pressed ENTER

##### BOTNET/DCC/TELNET #####

# Settings in this section should be unimportant for you until you deal
# with botnets (multiple eggdrops connected together to maximize efficiency).
# You should read doc/BOTNET before modifying these settings.

 If you wish this line in the conf for later use but not now
you need to hit yes and then enter for default, or no entry will be made.

Would you like enter a botnet nick? [ y/N ]:

of course you would want your bot to join a channel so, type your channel name in here.

This is the channel the bot will join by default, it will join #shellium if you don't answer anything here.

What channel would you like the bot to join?: #shellium

What network is the bot going to connect to? Make your choice setting the number 0 for Efnet to 5 For others,

# What is your network?
If you don't know what it is I would leave the default (it seems to work with most)
#   0 = EFnet (non +e/+I hybrid)
#   1 = IRCnet
#   2 = Undernet
#   3 = DALnet
#   4 = EFnet +e/+I hybrid
#   5 = Others
What type of network would you like to set? [ 5 ]: 5

Setting a server for your bot to connect to. i will leave it at freenode.net because thats the net where i am at. (Sambali)

This is the bot's server list. The bot will start at the first server listed,
and cycle through them whenever it gets disconnected. You need to change these
servers to YOUR network's servers.
#
#   The format is:
#   server[:port[:password]]
#   i.e.. irc.ifreenode.net:6667:lamers
#   or  10.10.10.10:6667:lamers
#
# Both the port and password fields are optional; however, if you want to set a
# password you must also set a port. If a port isn't specified it will default to
# your default-port setting.


Would you like to Enter the server? If you don't put anything the bot will join irc.freenode.net by default (y/N):

Last step, if you want to add some scripts then provide the scriptname.tcl here but, I'll say don't. You can edit the bot.conf file later on and set the scripts in there.

Are there any scripts which you would like to add? (y/N):

Done.

Start the sheggdrop for the first time, by typing

eggdrop -m eggdrop.conf

in the shegg directory, there after the command

eggdrop eggdrop.conf

will start the eggdrop. If all went well, your eggdrop should of joined the server and channel you set in the wizard. Do not msg the eggdrop hello from irc, instead telnet into the eggdrop to introduce yourself as owner and set password.

Use the vhost you set up during the configuration for host to telnet to, and use the port you used for the listen port during configuration for port to telnet to. When the eggdrop asks you for nickname for the first time, enter NEW. It will then prompt you to set irc nick and password. Once set it will let you on the partyline.

Next you need to add your host from irc to your eggdrop. Whois yourself in the irc network you and the eggdrop are connected to, to make sure you have the right host. Once you have the host, go back to telnet, and type

.+host *!your@irc.host.com. 

Go back to the irc channel you are on with the eggdrop, and try to dccchat with eggdrop. you can use /dccchat (eggdrops nick), or /ctcp (eggdrop nick) chat and enter the password you setup when prompted for it. If you get no access msg, go to the telnet window and check the host the eggdrop is seeing for you and make sure it matches the one you added with the .+host command.

If you get a negative houston, that means that the password you entered was wrong.

If you type ls in your shell you will notice there is a folder named sheggdrop. This is the folder that holds all your config files and script files, so now when you get errors (which can happen) you can edit the config file.

I hope it all works well, if not you can get to us on irc.freenode.net channel #shellium (you should be there).

UDP ports

If you type 'myports' after setting the bot, you might most likely notice some line about a UDP port which is not in the allowed ports range, like this:

                      Your Ports: 63469-63470

               To see your ports again type "myports".

You use following ports:

1.      Port: 63469
        Protocol: tcp
        IP: 207.192.71.108
        Program: eggdrop (PID 31888)

2.      Port: 34157
        Protocol: udp
        IP: 0.0.0.0
        Program: eggdrop (PID 31888)

This one is used for DCC chat and doesn't count, your account would not be locked.