DragonBot Version 1.2 April 18 2002
DragonBot Version 1.4 June 26 2004

Fixed: Settings information is now saved to a file for ease of importing old settings when the bot is upgraded. Please keep a copy of stp.ini in a safe spot so you do not lose your settings.

This is my first attempt at a bot. I have tried to include as many as the features that people have asked for, but being as I am new to this I hope people will be patient with me. It has taken many hours of work, some pulling my hair out to come up with this bot, but in the end I had a lot of fun making it. I would like to take a moment to thank FireDale, who has spent a lot of time helping me with the debugging and error checking.

kethra2004-bot@yahoo.com
http://www.geocities.com/irc_dragonbot/

To load the bot use /load -rs scripts/dragonbot.ini
set yourself and the bot as owner. press Alt and R keys together
click on user and add your name to the list:
640:yourname

For exmaple:
640:trista

***Mirc Pulldown Menu***

When you load the dragonbot.ini (either manually or onstartup) there has been some cases where a toggle was accidently released "on" that prevented startup of the bot. Dragonbot.ini would load but the bot would not. To prevent this problem from happening again. I have added a pull down menu under commands in the mirc window. 

If you find the bot is not loading click on: "Dragon Bot/Clear Bot Setup" then click on "Load All Bot Scripts" 

You may also call the setup gui from the pulldown menu now as well as with /setup. 

Setting the Bot Master. Please be careful when using this command. anyone set with this command will have full and complete control of the bot. You must type in the nickname completely and correctly.


~~~PERSONAL INFORMATION COMMANDS~~~

***These commands are done in PM***

!quote <pass> <quote> 
-This command allows you to to add/change a channel entrance message 

!qread 
-This command allows you to view your present quote 

!pass <your password> 
-This command sets a password in the bot, do not use a regular password and do not forget it

!changepass <old> <new> 
-This command changes a password to a new one 

!set email <pass> <email> 
-This command sets sets your email address

!set icq <pass> <email> 
-This command sets sets your icq number 

!set aim <pass> <email> 
-This command sets sets your aim id 

!set msn <pass> <email> 
-This command sets sets your msn id 

!set yahoo <pass> <email> 
-This command sets sets your yahoo id 

!daim <pass> yes/no 
-This command sets toggles others access your aim id   

!dmsn <pass> yes/no 
-This command sets toggles others access your msn id

!dicq <pass> yes/no 
-This command sets toggles others access your ICQ number

!dyahoo <pass> yes/no 
-This command sets toggles others access your yahoo id 

!demail <pass> yes/no 
-This command sets toggles others access your email address 

!dstatus <password>
-This command sets sisplays your present toggle settings 

!status <name> 
-This command sets displays the public settings of the named peron

~~~NOTE SYSTEM COMMANDS~~~

***These commands are done in PM.***

!Note List <yourpassword>  
-This command will list all notes you have

!Note Send <yourpassword> <name to send to> <message> 
-This command sends a note to another registered user.

!Note delete <yourpassword> <message number to delete> 
-This command deletes a message. find the message number with the !note list command

!Note read <yourpassword> <message number to read> 
-This command reads a message. Find the message number with the !note list command

NOTE:
The message system allows you to have only 5 messages please delete your message after you have read them. You also may not recieve or send notes unless you have a password set. Use the !pass command to set that.

~~~BASIC LEVEL USER~~~

!list all
-This command gives you a very long list of all gorean dictionary commands. This command can be given in Pm or in channel.

!gor help 
 -This command gives a list of the gorean dictionary commands (lists submenus for each one, shorter and easier to read list then the !list all command. This command can be given in Pm or in channel.

!ping To get a ping from the bot
-This command will get the bot to ping you and respond with the results. This command can be given in Pm or in channel.

!seen <nick>
-This command allows users to check if a nick has been in channel recently. This command can be given in Pm or in channel.

!rules 
-This command lists the channel rules if any. This command can be given in Pm or in channel.

!advanced help 
-This command gives you a sub menu of personal information you can set in the bot. This command can be given in Pm or in channel.

!board help 
-This command gives you a sub menu with message board commands. This command can be given in Pm or in channel.

!guestbook help 
-This command gives you a sub menu with guest book commands. This command can be given in Pm or in channel.

!note help 
-This is a botmail system allowing users to leave personal message for another user (must be in channel to be notified of the message waiting). This command can be given in Pm or in channel.


~~~LEVEL 500 USER~~~

***Note: If a command is given in the channel DO NOT inculde the channel name***

!kick <channel> <nick> <reason>
-This command forces the bot to kick a given nick. This command can be given in Pm or in channel.

!ban  <channel> <nick>
-This command forces the bot to ban a given nick. This command can be given in Pm or in channel.

!unban  <channel> <nick>
-This bot forces the bot to unban a given nick. This command can be given in Pm or in channel.

!kb  <channel> <nick> <reason>
-This command will make the bot kick and ban a given user. This command can be given in Pm or in channel.

!akick <channel> <host> 
-this adds an auto kick or akick to chanserv for a given host. This command can be given in Pm or in channel.

!rakick <channel> <host> 
-This command removes an auto kick placed on a user, must be done exactly as the auto kick was placed. This command can be given in Pm or in channel.

!op me <channel>
-This command ops the the person performing it, if the correct level. This command can be given in Pm or in channel.

!deop me <channel>
-This command removes the +op from the person performing it, if the correct level. This command can be given in Pm or in channel.

!op <channel> <nick>
-This command ops the named person. This command can be given in Pm or in channel.

!deop <channel> <nick>
-This command removes ops of the named person. This command can be given in Pm or in channel.

!vop me  <channel> 
-This command adds the +voice from the person performing it, if the correct level. This command can be given in Pm or in channel.

!devop me  <channel> 
-This command removes the +voice from the person performing it, if the correct level. This command can be given in Pm or in channel.

!vop <channel> <nick>
-This command gives the +voice to the named user. This command can be given in Pm or in channel.

!devop <channel> <nick>
-This command removes the +voice on the named user. This command can be given in Pm or in channel.

!say <channel> <words>  
-This commands the bot to say something in the named channel. This command can be given only in Pm.

!act <channel> <words> 
-This commands the bot to do or act something in the named channel (same as /me). This command can be given only in Pm.

!nick <newnick>
-This command change's the bot's name. This command can be given in Pm or in channel.


~~~LEVEL 640 USER~~~

!join <channel> 
-This command forces the bot to join a channel. This command can be given in Pm or in channel. the channel name is always needed

!part <channel> 
-This command forces the bot to part a channel. This command can be given in Pm or in channel. The channel name is always needed

!kill bot
-This command forces the bot to quit irc completely. This command can be given in Pm or in channel. This command can be given in Pm or in channel.

!Identify <password>
-This command allows you to force the bot to identify to nickserv

!oplevel <name> 
-This command sets a user to op level or level 500 in the bot. This command can be given only in Pm.

!ownerlevel <name> 
This command sets a user to owner level or level 640 in the bot, use this with care. This command can be given only in Pm.

/afb 
-This command brings up a setup menu for an anti-flood protection I am including with the bot. It is not written by me nor do I promise it will work or not. It does as it indicates protects the bot and channel from floods. This add on is used at your own risk. This command is done in any window.

/setup setsup the bot
-This command brings up the bot setup window (Consol only command). This command is done in any window.

/blacklist
-This command will make a list of users who will be kicked as they enter channel. syntax is as follows
/blacklist -This gives a list of the blacklisted users
/blacklist <nick> <reason>  -This adds a user to the blacklist
~~~SETUP MENU~~~

Auto close Query
-This option allows you to toggle of you want queries sent to the bot to remain open or 
close automatically

User Tracking
-This option allows you to toggle people as they enter the channel and noting similar nicks. Please note the bot will find very close matches on the nicks, it is not saying that the two nicks are the same person. This is your discreation to decide if they are or not. Also the bot will not find nicks if the ident of the person changes ie it will not see brat@*.myisp.com and brat_@*.myisp.com as the same person. This information is displayed in a dedicated @watch window. It only triggers if a user has more then one name listed.

Join Counter
-This option allows you to toggle if the bot displays the # of people to have joined the channel, this is done in a dedicated @join window for each channel and is not displayed to the channel.  If you wish to reset the join counter, make sure you are set to bot owner (right click on your name in any channel window and use: Botcommands->ownerlevel) then type  !reset joincount in a query to the bot. Also this is an add on I did not write although I did update it. I do not know its author.

Revolving Door
-This option allows you to set the ability to place a temp ban on a user for entering and leaving channel too quickly. You may use the default 120 second/2 min ban or set your own ban time length.

Gor Dictionary
-This options toggles the ability to view the gorean dictionary in the bot

Guest Book
-This option toggles the channels guest book on and off. There is a minor problem with this command in that if a user decides to spam your system and post 30,000 notes, the bot will allow it. This command is used at your own risk. Beyond name no different fropm message board.

Message Board
-This option toggles the channels message board on and off. There is a minor problem with this command in that if a user decides to spam your system and post 30,000 notes, the bot will allow it. This command is used at your own risk. Beyond name no different from guest book.

Bot Mail
-This option toggles the channels private mail system on and off. Users can receive up to 5 private messages from users.

Seen
-This option toggles the ability to use the !seen command in channel or in PM. The seen files can be viewed in a text editor in the "seen" directory under the main bot directory.

Taglines
-This option toggles the ability to set and display entrance messages in channel when a user first enters.

Personal Info
-This option toggles the ability to set and display personal information in channel such as email, icq, aim, msn, yahoo contacts.

Home Channels
-This option allows you to set the channels the bot will be in

Join channels on connect
-This toggles the auto join command in the bot. If on the bot will join the channels in the "Home Channels" list.

Auto Msg On Join
-This toggles the message if any that is sent to users when they join your channel. You can have it send a message the first time they enter or no message at all. You may use $chan or $nick in the message. $nick is the name of the user entering the channel, $chan is the name of the channel. It is suggested you put the rules names in here so people will know what to type.

RULES
-This allows you to setup 3 sets of rules. You can dictact the the triggers for 2 of the lists. Please remember to avoid accidental triggering of the command in channel to use a special character such as ! or ~ before the command. The general rules will always be triggered by "!rules"the 2 alternate lists will be triggered by "<your word> rules" When making rules please keep the lists brief, you can always point the user to a webpage for more indepth information if needed. If you use $chan in the rules make sure you realise anyone not on channel accessesing your rules list will not see the channel name. $nick is the nick of the person requesting the rules.

