CKS Juggernaut
Bot Tutorial
Bot Making Tutorial™
By Tyler Hutchinson, CKS Admin.

So, you've decided to make a "bot."
First, Lets go over the requirements.

You will need:
ActivePerl 5.8
A Bot Template
A bit of knowledge of how a bot works.
Winzip

Chapter 1. Perl.

Before we go anywhere with the bot, we're going to need ActivePerl. ActivePerl is what the bot runs on. To get it, go to www.activestate.com and look around. You'll Find it.

When you come to a page with a big table, you want Perl for Windows. Click the "MSI" Button and Download the File. When its done downloading to the directory you chose, go there and click the program to install ActivePerl. Install it to: C:\Perl (which is the default on most computers.) Thats all for Perl.. Well, Thats all I did. NOTE: CKS Juggernaut requires Perl 5.8 or higher.

If your copy of Juggernaut DID NOT come with a local lib (a "lib" folder), you need 3 Files you can download from www.bot-depot.com:

mshttps.pm - This goes in: C:\Perl\site\lib\lwp\Protocol
Protocol.pm - This goes in: C:\Perl\site\lib\lwp\ (Replaces older Protocol.pm)
MSN.pm - This goes in: C:\Perl\lib\

All Three Providing you did what I told you to and put Perl in C:\Perl

Chapter 2. Template.

Ok, So we have perl installed. now your ready to download your Bot Template, well almost ready. First your going to need a directory to put your template in. Anywhere seems to be ok.. Its Simplest to put your Template in C:\Bot, So go to the Windows Explorer program (Accessed in: Start->Programs->Windows Explorer) and open the C:\ Directory on the left. Once there, right click and Choose New... and create a folder. Name it "Bot" And C:\Bot is Created.

Now You need your Bot Template. Your Best Bet is to go with... CKS Juggeranut Available on the Downloads page of this website.

When the file downloads opens, Click Open, when it finishes, Winzip will open (Providing the Fact that you DO have winzip, Right?) and you choose unzip and choose the directory C:\Bot. And your done. You have your Bot Template.

Chapter 3. Configuring your CKS Juggeranut Bot.

Ok, Since I don't run on Aim, I'm going to Configure a CKS Juggernaut Bot for MSN (Its Relatively the same with aim)

To Configure your Bot go to: C:\Bot\Juggernaut\bots and click:
A - The First one if your MSN
B - The Second one if your AIM

You get a Notepad Document, Similar to this (Not Exactly this for AIM.. Maybe Someday I'll Make an AIM Tutorial):

(1)ScreenName: E@mail.com
(2)Password: abigsecretpassword
(3)Client: MSN
(4)Brain: Juggernaut
(5)Reply: ./replies/cml/standard
(6)Nick: CKS Juggernaut bot
(7)WelcomeMsg: ./data/msn/welcome/Sample.txt
(8)DisplayPic: ./data/msn/dp/bob.png
(9)Emoticons: ./data/msn/emo/Sample.txt
(10)Data: ./data/profiles/Sample.txt
(11)Font: ./data/msn/fonts/Sample.txt

1 - This is your Bots E-Mail. You can setup an Account at www.passport.com. But check and make sure it works. (Example: MyBot@hotmail.com For aim you need to set up a screen name I guess.. I don't use AIM, I dunno.)

2 - This is your Bots Password. Its the Same Password you use to log into the passport account.

3 - This is your Client, MSN or AIM (Whichever your Bot Runs on)

4 - Don't Change this (See my Settings Tutorial)

5 - Don't Change this (See my Settings Tutorial)

6 - Your Bots Name (Only Applies to MSN)

7 - Don't Change this (See my Settings Tutorial)

8 - Don't Change this (See my Settings Tutorial)

9- Don't Change this (See my Settings Tutorial)

10 - Don't Change this (See my Settings Tutorial)

11 - Don't Change this (See my Settings Tutorial)


Settings Tutorial™
By Tyler Hutchinson, CKS Admin

Ok, If you haven't read my Bot Making Tutorial™ You probably Should.

In the Bot Making Tutorial™ you read about:

(1)Brain: Juggernaut
(2)Reply: ./replies/cml/standard
(3)WelcomeMsg: ./data/msn/welcome/Sample.txt
(4)DisplayPic: ./data/msn/dp/bob.png
(5)Emoticons: ./data/msn/emo/Sample.txt
(6)Data: ./data/profiles/Sample.txt
(7)Font: ./data/msn/fonts/Sample.txt

In this Tutorial, I'm going to cover each of the above, and some other settings for your CKS Juggeranut Bot.

Firstly, As Far as I know, Some of the Above do not appear in the Configuration for AIM. Anyways.

1. Your Bots Brain - The value for this can be Nexus or Juggernaut only.

2. Reply - Is either set as ./replies/nexus/sample.txt or ./replies/cml/standard ./replies/cml/standard is the Default, Which is Better than Nexus, and is split up into several smaller reply files.. which is also easier to read and edit. Nexus brains keep all their reply data in a single TXT file, which is created automatically--you just specify the path to the file.

3. Welcome Message - C:\Bot\Juggernaut\data\msn\welcome\sample (As long as you followed my Instructions in my Bot Making Tutorial™ it will be there) Just go there and edit the .txt file to whatever you want your Bots Welcome Message to be.

4. Display Picture - Your Collection of DP's will be in C:\Bot\Juggernaut\data\msn\dp (If you followed my Instrctions in my Bot Making Tutorial™) To add a Display Picture, Add the Picture File (.png) to the ./data/msn/dp Directory and to set it, in ./bots/textfile.txt, Under DisplayPic change ./data/msn/dp/cks.png (which is default) to: ./data/msn/dp/[Name of Picture].png

5. Emoticons - I'm not even Getting into these... Well I guess I do.. You have a default emoticon in ./data/msn/emo/icons/cks.png. cks.png is your Filename. Emoticon files are a TEXT file that contains the list of emoticon settings, in the format:
emoticon code->./data/msn/emo/icons/smiley.png

So. If you want a upload an emoticon, put the .png in ./data/msn/emo/icons/

Then go back to ./data/msn/emo/sample.txt and add: (EMO)->.data/msn/emo/icons/filename.png

(EMO) is what you type into the Bots Files to make the Emoticon Appear.

6. Data - This is your Bot Profile. It looks like this:

name=Bob Server
age= 16
sex=male
location=Tyler's Computer / Cerone's Server
color=Lime Green and Black
book=Azulian World: Genesis
band= The Ranch
job=Robot for Tyler
spouse=none
sexuality=heterosexual
friends=Cerone Kirsle, Michael McDonald, Danield da Silva, and William Hutchinson.
website=http://www.aichaos.com/

Everything in this .txt file you can edit to your liking. I'm not going into what each one means.. Maybe if I get an E-mail from a real BIG N00B, I'll make a "profiles tutorial"

7. Fonts - This is where you edit what the font you're bot "Types" with. It looks like this:

Font Face=Times New Roman
Color=0000ff
Style=

Font Face - Your Font type (i.e.Verdana, Arial)
Color - Hex Code for your bots text Color
Style - Italics, Bold, Underlined, Strikeout, Etc..

Primary Color Hex Codes:

FF0000 - Red
00FF00 - Green
0000FF - Blue


Chapter 2. Becoming the Bots Master.

The Bots Master Gets his Own Special Commands. There should only be one master, and that is the person who configures the Bot and runs the Juggeranut.pl Program on their Computer.

To Add a Master (you):
Go to:

C:\Bot\Juggernaut\data\authority And open the Master.txt File.

A- If you use MSN, Type: "MSN-YourEmail@Address.com"
B- If you use AIM, Type: "AIM-YourScreenName"
I think I got that right for AIM..

Chapter 3. Making Admins.

Same Deal.
Go to:
C:\Bot\Juggernaut\data\authority and open the Admin.txt and use the same Formula in A and B above to add an Admin (An Admin is not you, An Admin is a person who "Controls" the Bot and Helps out Users)


And thats my Settings Tutorial.

Check out my Commands Tutorial for a List of Commands, Descriptions, and Usage.

Until Next Time.
Chaio.
Silvere, CKS Administrator.

Chaos AI Technology