Guide to TCL scripting for Eggdrop 1.6

This Guide is optimized for Eggdrop 1.6.
With a few minor adjustments you can also use this Guide to write scripts for Eggdrop 1.3 and 1.4.
If you want to write scripts for older Eggdrops like 1.1.5, then you should try an other Guide (see here), because too much has changed since those versions.

If you are linking or bookmarking this Guide please use http://www.suninet.nl/tclguide/.
That link will always redirect you to the proper site, but my CGI scripts can change and
I don't want to have to make "backwards compatibility" in my CGI scripts all the time.

Last updated on February 27th, 2002 - Current release is v1.10

[ Previous ] [ Index ] [ Next ]
[ Text version ]

1. Introduction

• 1.1 Contributors
• 1.2 Acknowledgments
• 1.3 Revision History
• 1.4 New versions of this guide
• 1.5 Feedback
• 1.6 Distribution Policy

2. IRC and Eggdrops

• 2.1 IRC
• 2.2 The IRC protocol (RFC1459)
• 2.3 Bots
• 2.4 Eggdrop

3. The TCL Language

• 3.1 Open Source
• 3.2 The build-up of a TCL script
• 3.3 Interpretations
• 3.4 Different TCL and Eggdrop commands

4. Binding events and creating procedures

• 4.1 Binding events
• 4.2 Calling upon procedures
• 4.3 Creating a procedure
• 4.4 Ending a procedure

5. Variables

• 5.1 What variables are
• 5.2 Setting strings
• 5.3 Using arrays
• 5.4 Retrieving an array list
• 5.5 Local and global strings
• 5.6 Adding up and substracting

6. Outputting information

• 6.1 Logging
• 6.2 Sending output to a user
• 6.3 Sending commands to the IRC server
• 6.4 Sending commands to other bots
• 6.5 Changing channel modes
• 6.6 Kicking users from channels
• 6.7 Writing your own script

7. Running commands under certain conditions

• 7.1 Matching two items against each other
• 7.2 Looking if something is true or false
• 7.3 Matching more than two items
• 7.4 Executing when it's something else
• 7.5 Executing when it's none of the above
• 7.6 Writing your own script

8. Working with lists

• 8.1 What lists are
• 8.2 Creating lists
• 8.3 Retrieving an object from a list
• 8.4 Retrieving multiple objects from a list
• 8.5 Determining how many objects a list has
• 8.6 Replacing objects in a list
• 8.7 Converting strings into lists
• 8.8 Writing your own script

9. Working with strings

• 9.1 Retrieving a character from a string
• 9.2 Retrieving multiple characters from a string
• 9.3 Determining how many characters a string has
• 9.4 Matchting strings against each other
• 9.5 Changing the string case
• 9.6 Converting lists into strings

10. Looping

• 10.1 Looping under conditions
• 10.2 Looping for every value
• 10.3 Looping for a number of times
• 10.4 Writing your own script

11. Working with files

• 11.1 Opening files
• 11.2 Closing files
• 11.3 Reading from files
• 11.4 Writing to files
• 11.5 The end of the file
• 11.6 Checking if a file exists
• 11.7 Writing your own script

12. Miscellaneous

• 12.1 Timers
• 12.2 Random numbers
• 12.3 Checking for strings
• 12.4 Advanced math
• 12.5 Text decoration
• 12.6 Checking user flags
• 12.7 Catching errors

A. IRC server commands

• A.1 Messages and notices
• A.2 CTCP's
• A.3 Inviting
• A.4 Joining channels
• A.5 Parting channels

[ Text version ]
[ Previous ] [ Index ] [ Next ]