joaddons.tcl Component Documentation

# joaddons.tcl for netbots.tcl v3.35
# designed to work with eggdrop 1.5.2 or higher
# Johoho's Eggdrop Page - http://johoho.tuts.net/eggdrop/
# joaddons.tcl copyright (c) 1999,2000 by Johoho <johoho@hojo-net.de>
# netbots.tcl copyright (c) 1998-2000 by slennox <slennox@egghelp.org>

## joaddons.tcl component script v2.33.5, 09.02.2002 ##

# History:
# v1.00.0, 27.12.1999 - initial release, not public
# v2.00.0, 03.02.2000 - added lots of stuff and put it on homepage
# v2.00.1, 19.03.2000 - change header and readme :)
# v2.00.2, 26.03.2000 - cosmetic bug fix - discovered by abraham
# v2.10.0, 01.05.2000 - extended checkpass command
# v2.11.0, 05.05.2000 - fixed a bug with checkpass
# v2.12.0, 11.05.2000 - fixed the same bug in checkpass again *shrug*
# v2.20.0, 16.06.2000 - added new command, whereami (Abraham)
# v2.21.0, 14.02.2001 - added new command, relink (Abraham)
# v2.22.0, 15.02.2001 - added new command, switchhub (Abraham)
# v2.23.0, 17.02.2001 - added new command, whoami (Abraham)
# v2.24.0, 18.02.2001 - added new commands, makeslaves, freeslaves (Abraham)
# v2.25.0, 19.02.2001 - fixed nethelp for: makeslaves, freeslaves (Abraham)
# v2.26.0, 09.04.2001 - fixed minor bug in: makeslaves, freeslaves (Abraham)
# v2.27.0, 03.05.2001 - added support for upcomming change in eggdrop
# v2.27.0, 03.05.2001 - added "local" ping command (Abraham)
# v2.28.0, 06.05.2001 - recoded "local" ping (Abraham)
# v2.29.0, 07.05.2001 - added checks to rrestart and rdie commands (Abraham)
# v2.30.0, 14.06.2001 - cleaned variables usage, fixed some cosmetig bugs, added whereami@irc (Abraham)
# v2.30.1, 17.06.2001 - cleaned(futher) code (Abraham)
# v2.31.0, 28.06.2001 - added: isbotonline and fixed minor bug in: makeslaves, freeslaves (Abraham)
# v2.32.0, 29.06.2001 - added new commands: cleanchrec, netsetflag (Abraham)
# v2.32.1, 29.06.2001 - fixed both commands and changed name of 2nd command to netbotchattr (Abraham)
# v2.33.0, 01.07.2001 - added commands: cycle, netcycle, improved cleanchrec, fixed some cosmetic bugs (Abraham)
# v2.33.1, 02.07.2001 - improved: cleanchrec, checkpass (Abraham)
# v2.33.2, 06.07.2001 - improved: checkpass (again) and switchhub (Abraham)
# v2.33.3, 07.07.2001 - improved: relink, ping, fixed: switchhub[bug/typo] (Abraham)
# v2.33.4, 11.07.2001 - fixed: cycle, ping, improved: freeslaves (Abraham)
# v2.33.5, 09.02.2002 - fixed and improved: relink (Abraham)

# thanks slennox for netbots.tcl

Please note that this component is fully compatible with netbots.tcl v3.15 - 3.35 by slennox



This components adds serveral commands to your bot to make local user and remote bot administration much easier.
This component contains two command blocks, local and remote.

Commands MSG/DCC

DCC Commands

local block

.copyflags (n|-) - copy all user flags from one channel to another.
.mchattr (n|-) - chattr people by matching flags.
.checkhosts (m|-) - list all users who haven't got a password set.
.checkpass (m|-) - list all users with or with more then count hosts.
.whereami (p|-) - This command displays the current bot's botnet name.
.whereami@irc (p|-) - This command displays the current botname at irc network.
.whoami (p|-) - This command displays your current handle on bot.
.relink (m|-) - This command is doing .unlink and .link in sequence.
.switchhub (n|-) - This command is unlinking hub, changing hub flags to oposite.
.freeslaves (n|-) - This command works in oposite way to makeslaves :)
.makeslaves (n|-) - This command lets you to make all non-hub(+h), non-althub (+a) non-uplink(+p) bots flagged +gs by .botattr automagicly.
.ping (n|-) - This command (yes, that's right) pings somebody on irc network
isbotonline (t|-) This command tells you that specified bot is linked/online or not.
cleanchrec (n|-) This commands removes empty channel records on users from userfile.
netsetflag (n|-) This commands sets specified flag(s) on bot(s) 'pointed' by .control command.

remote block

.+bot (n|-) - add a bot on remote bot
.-bot (n|-) - remove a bot on remote bot
.+host (n|-) - add a host on remote bot
.-host (n|-) - remove a host on remote bot
.+user (n|-) - add a user on remote bot
.-user (n|-) - remove a user on remote bot
.chattr (n|-) - chattr a user on remote bot
.botattr (n|-) - botattr a bot on remote bot
.restart (n|-) - restart remote bot
.die (n|-) - kill remote bot

Further help is available via the netbots help system. Use .nethelp



To install this component properly you have to copy it to your netbots directory and add these lines to your netset.tcl conf:

# joaddons.tcl
set nb_component(joaddons) 1
set ja_local 1
set ja_remote 1
set ja_rcommandstcriticalgroup "yournbgroup"

Settings Documentation

ja_local (default: 1)
Should the bot load local joaddons commands?
Valid settings: 1 to enable, 0 to disable.
ja_remote (default: 1)
Should the bot load remote joaddons commands?
Valid settings: 1 to enable, 0 to disable.
ja_rcommandstcriticalgroup (default: "*")
That variable should be set to the name of your nb_group(name) which can contains all names of netbots or (for example) names of bots wich are watching specific channel.
This setting is designed to avoid accidental suicide of whole botnet / losing op status on channel / etc.
Valid settings: valid netbots group
WARNING: This setting is MANDATORY!


Q:  I have a question, but it's not listed here.
A:  Feel free to contact the author at johoho@hojo-net.de!


You can contact me via E-Mail at johoho@hojo-net.de, at ICQ 2499577 (tell me who you are and what you want or I'll ignore you) or catch me on irc usually around 18-24 UTC+1 in #eggdrop. (IrcNET)


joaddons.tcl is provided 'as is' and without warranty of any kind. You may use it own will as long as the author is NOT held responsible for ANY damage caused by the usage of this script, neither direct or indirect.
You may modify the script and all belonging files as long as you keep this copyright-text, include a short description of all changes, and send a copy to the author (e-mail: johoho@hojo-net.de).

©2000 by Johoho@IrcNET, 09 February 2002. CONTACT