@database TeaBot guide
@$VER: TeaBot Guide (20-02-98)
@WORDWRAP


@NODE Main "TeaBot 0.96e © 1998 Stephen P Evans"


     @{b}TeaBot version 0.96d Aminet release.@{ub}
              (c) 1998 Stephen Evans
     

     @{" Liability            " LINK LIABILITY}
     @{" What is TeaBot ?     " LINK Introduction}
     @{" Installation         " LINK Installation}
     @{" Usage                " LINK Usage}
     @{" About the author     " LINK Author}
     @{" Cast and Crew        " LINK Thanks}
     @{" Program History      " LINK History}
     @{" Known Bugs/To Do     " LINK Bugs}

@endnode

@node "Liability" "LIABILITY"
@{b}Liability:@{ub}


With the usage of TeaBot you agree to the following announcement-declaration:

    THERE IS NO LIABILITY TO THIS PROGRAM-PACKAGE,IN REFERENCE TO THE
    ASSERTED LAWS. THE COPYRIGHT OWNERS, AND/OR A  THIRD PARTY, PLACE
    THIS PROGRAM PACKAGE AT YOUR DISPOSAL "AS  IS" (EXCEPT WHERE THIS
    IS FIXED ANYWHERE ELSE IN A WRITTEN WAY) WITHOUT ANY GUARANTEE IN
    ANY  FORM (INDIRECT OR DIRECT FORM). THE FULL RISK OF QUALITY AND
    FUNCTIONALITY  OF THIS PROGRAM IS AT YOUR OWN. IF THE PROGRAM HAS
    A BUG, YOU HAVE TO PAY  ALL COSTS  OF THE NECESSARY SERVICE-WORKS
    AND REPAIRS FOR YOURSELF.

    UNDER  NO  CIRCUMSTANCES,  THE  COPYRIGHT OWNERS OR A THIRD PARTY 
    DISTRIBUTING THIS PROGRAM PACKAGE, AS ALLOWED, JUST  BEFORE,  CAN
    NOT  BE  HELD  RESPONSIBLE  FOR  ANY  DAMAGE CAUSED IN ANY USUAL,
    SPECIAL, OR ACCIDENTAL WAY OR BY THE PROGRAM PACKAGE (SURROUNDING
    BUT NOT RESTRICTED ARE THE LOSS OF DATA OR NOTCORRECTLY DISPLAYED
    DATA OR LOSSES CAUSED BY YOU OR A THIRD PARTY OR BY A FAULTY WORK
    OF THIS PROGRAM PACKAGE  WITH  OTHER PROGRAMS), ALSO IF THE OWNER
    OR A THIRD PARTY HAS BEEN POINTED AT SUCH POSSIBILITIES OF DAMAGE.

@{" Back to Index " LINK Main}
@endnode


@node Introduction "What is TeaBot."

@{b}What is TeaBot.@{ub}

An Amiga irc Bot program written in Arexx.
Please don't shudder when you hear the word Arexx, TeaBot tries his best to NOT 
look like a Arexx based bot, in fact I ran this bot for 6 Months (While in 
development on #Amigacafe) and nobody noticed it was written in Arexx :)

Please have faith ;)

@{" Back to Index " LINK Main}

@endnode




@node Installation "TeaBot Installation."

@{b}So how do I install TeaBot ?@{ub}

Copy c-codes.txt, faqlist, fish, Hangtemp, Hangwords, JLog, MCP.gurudat all to S:
Copy Fserv.amirx (If you wish to use it remember you MUST assign FServ: to you 
file serv dir, 
otherwise people may get access to parts of you hd that you may not wish them to 
!) to Amirc/rexx dir.

     
a) Load TeaBot his own copy of AmIRC.

a) Ensure Arexx is running. 

b) Load into AmIRC my provided Amirc config file, add any irc servers that you use.
   @{b}IMPORTANT@{ub} copy TeaBot.arexx to Ram: !! Don't even think of running it from HD.

c) Thats it TeaBot should make you instantly level 6 (More info on level later in this 
guide). If for some reason it doesn't edit by hand the ram:jlog file and change your level to 6.
  
d) If you wish to use TeaBots File Serve, make sure that you Assign FSERV: YourDir:
   @{b}OtherWise DON'T install the fserv.amirx file otherwise people may beable to steal your files ! I have warned you ! :)@{ub}


Have fun ! :)

@{" Back to Index " LINK Main}
@ENDNODE

@NODE Usage "How to use TeaBot"

@{b}How to use TeaBot@{ub}

Probably the easiest bot to use !

TeaBot responds to @{"Commands" LINK Commands} issued in the channel or by 
private message e.g.,

^Showcommand

/Msg Tea Showcommand

The ^ prefix isn't required when issuing commands via private messages.

TeaBot has a built-in wealth of @{"Commands" LINK Commands}  which are all 
available to the Level 6 operators.

@{" Back to Index " LINK Main}
@ENDNODE

@NODE Commands "TeaBots Commands"

INFO

Shows current TeaBot version and local time.

SLAP

A fun command, Slap a user with a random fish
usage Slap <Nick> 

PUNCH

A fun command, Punch a user in the face
usage Punch <Nick>

NACHOS

A fun command, buy Nachos for all on the current channel and send the bill to 
<nick>
usage Punch <Nick>

COUNTRY

Convert Internet country codes to there real country name
usage Country [Country-Code]
E.g. ^Country CZ

TeaBot will respond with 

TeaBot:  cz is Czech Republic

URL 

TeaBot grabs and stores URLs off the current channel, this command privately 
messages you all the URLs

SAY

Make TeaBot Talk,
usage ^Say [Message]

Eg ^Say Hello peeps


ME

Make TeaBot send a action to the channel
usage ^Me [Message]


FISH

Another Fun command just try it :)

usage ^Fish [Nick]


GURU

Makes TeaBot convert Guru Numbers

usage ^Guru [Guru number]

Thanks to AlienDesign for the GuruList.


NUT

Another Fun command just try it :)

usage ^Nut [Nick]


SVIEW

Shows users Status on TeaBot, shows netmasks and their levels.

usage ^Sview <Nick>

Level 4+ is required to specify a nick.


QUIT

Quit TeaBot off irc, this MUST be used to ensure the latest userlist is saved to Hard 
Disk.


NICK

Change TeaBots Nick

usage ^Nick <Nick>


HUG

Have TeaBot hug a IRC user :)

usage ^Hug [Nick]


FART

Guess ;-)


TRYME

This command only works if TeaBot has Operator status on the current channel.
You can play a game like Russian Roulette, if you lose instead of a bullet you get 
kicked off the channel :)

usage ^tryme


OP

OP yourself or another user,

usage ^op <nick>

Specify no nick and TeaBot will OP you.


DEOP

DEOP yourself or another user,

usage ^deop <nick>

Specify no nick and TeaBot will DEOP you.


TOPIC

Change the current channels topic if TeaBot has Operator Status,

usage ^Topic <what you want the topic to be>


SETGREET

TeaBot can greet user joins 

usage ^SetGreet [Nick] [Greet]


VIEWGREET

Show the greet for the specified user

usage ^ViewGreet [Nick]


DELGREET

Delete the greet for the specified user

usage ^DelGreet [Nick]


HANGR

This is short for Hangman Reset, TeaBot can play a one player game of Hangman, 
but it must be rest first

usage ^HangR <Nick>

Specify no nick and the game is setup for you.


HANG

Play hangman ! If you don't know the rules ... :)

usage ^Hang <letter or complete guess>

The game must be setup with the HangR command.

FSERVASSIGN

Change the FSERV assign, can only be changed localy and requires Level 6 access.

@{" Back to Index " LINK Main}



@ENDNODE

@NODE Author "About the Author"

@{b}About the Author@{ub}

After months of work (well on and off :)) TeaBot is here, if you read the code you'll 
see that I'm a greater spotted newbie when it comes to arexx (TeaBot is my first 
Arexx project).

If you want to get in touch, perhaps to tell me how bad I am at Arexx or perhaps 
even to thank me, Just drop me a Email to;

Ste@Inorbit.Com

or perhaps if you feel like a one to one chat try to find me on irc on #AmigaCafe 
on the undernet, I hang about as MrQ :)



See ya peeps !

@{" Back to Index " LINK Main}
@ENDNODE

@node Thanks "Cast and Crew"
@TOC Main

Who made this ?

Stephen 'MrQue' EVANS - Me ! The guy who made TeaBot. Mail me at 
Ste@Inorbit.com
David 'Dibbs' HANDSAKER - The one and only Beta tester, he also came up with a few 
good ideas which is quite strange for him :)
Michael 'Skeletor' RUSHTON - Wrote the File Serve script that TeaBot can launch :)
Nicholas 'Nich' PIPER - Got me into Arexx, also supplied me with some very cool Arexx guides.
Dave 'Hedgie' CUSICK - For the kind words in @{b}Amiga Format@{ub}. And for also liking Kebabs ;)
Tom 'Fosters' BAMTON - For loads of testing and ideas on his Undernet channel #Liberty.
Pascal 'Logix' GLOOR - For writing Espresso (Another bot) which I nicked ideas from.
Tristan 'Merc' GREAVES - Found a little bug that I never saw :)
Jan 'Mamlason' HLAVATY - For fixing my HD and making Blizzmagic for my 040.
ALIENDESIGN - For letting me included the MCP.Gurudat file.

All on #AmigaCafe for testing and stuff :)

@{" Back to Index " LINK Main}
@endnode




@node History "So how many versions of TeaBot ? :)"

History :


Version 0.96 First Aminet release. 
(05-02-98)

Version 0.96a/b  Removed DCC chat launch of FServ, whoops it doesn't work ! :)
(06-02-98)

Version 0.96c  Added pointer for FServ: to a Env varible, to save people doing assigns =)
(07-02-98)     TeaBot pops up a requester if Fserv assign isn't there. Use ^FservAssign to
               Change the assign after its already set (localy only).

Version 0.96d  Rewrote level code, now requires the user to be on channel or
(19-02-98)     a user supplied usermask, should be _MUCH_ safer :)
               Added Error messages to FServassign and help messages to FServ/FServassign.
               Made TeaBot see more invalid CTCP messages (Just for fun).
               Made TeaBots DCC resume work with different setups (I hope).

Version 0.96e  Added Basic OPS protection to TeaBot, Default setting is OFF, can be toggled on/off
(20-02-98)     with ^OpsProtect command. Hows it works, ok if a op with a level less than 4
               deops another Op (any level) Teabot Reops the op and deops the -4 op :)
               Is that clear I think not :^)


@{" Back to Index " LINK Main}
@endnode


@node Bugs "What bugs ! :)"

Known Bugs.

a) Faq is a little buggy in places.

b) Hangman can't handle flooding, I'm lame ! :)

-To do

Basic Ops protection sometime.


@{" Back to Index " LINK Main}
@endnode
 
