EggWiki - User contributions [en]

EggWiki

2026-01-02T14:23:28Z

Geo: /* Setting Up Eggdrop */

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/tutorials/setup.html Installation Tutorial]

[[Do I have Tcl installed?]]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

[[Cert Val Failed| certificate validation failed: unable to get local issuer certificate ]]

[[Docker| Common Docker issues]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Connect To Partyline with TLS| How do I connect to the partyline using TLS?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

[[Inline| When compiling ancient versions of Eggdrop, I get "undefined reference to `cron_matchfld'" and other similar errors]]

== Tcl Examples ==
[[Setudef| Writing Tcl scripts that work only on selected channels]]

[[MinutelyWho| Writing a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl script that can access https websites]]

[[Http_async| Writing a Tcl script that can access http websites asynchronous and gets the title of it]]

[[SelfJoin| Writing a Tcl script that performs an action when the bot joins a channel]]

== Python ==

[[Python]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]

[[EggModules|What is the difference between the IRC, Server, and Channel modules?]]

Config Changes

2025-09-06T19:59:26Z

Geo:

== Config changes made in 1.9.0 ==
* Added additional net-types for freenode, Quakenet, and Rizon (net-type)
<pre>
## What is your network?
## Options are:
## EFnet
## IRCnet
## Undernet
## DALnet
## freenode
## QuakeNet
## Rizon
## Twitch (This requires twitch.mod to be loaded as well)
## Other (This is a good, sane default option to use if your network/ircd is
## not listed here. Additional configuration options for this setting
## can be found further down in the IRC MODULE section)
set net-type "EFnet"
</pre>
* Added SASL configuration settings
<pre>
#### CAP Features ####
# This section controls IRCv3 capabilities supported natively by Eggdrop. You
# can enable individual settings here to be requested as part of the
# registration process with the IRC server. Not all servers support all CAP
# features. https://ircv3.net/support/networks.html maintains a list of some
# popular servers, and you can also use '.tcl cap available' from the partyline
# to list capabilities available on that server.
# SASL is a method that allows Eggdrop to authenticate with a NickServ service
# as part of the connection process to a server, eliminating the need to later
# authenticate via a /msg command.
#
# To request SASL authentication via CAP, set this to 1
#set sasl 0
# Set SASL mechanism to authenticate with.
# Options are:
# 0 = PLAIN (normal user/pass exchange, only encrypted
# if connected to the IRC server with a
# SSL/TLS connection)
#
# 1 = ECDSA-NIST256P-CHALLENGE (Uses a certificate; usually requires a
# public key to be registered with NickServ
# or other similar service. Set certificate
# to use in sasl-ecdsa-key setting below)
#
# 2 = EXTERNAL (Some other method you set up. Certificates
# used are defined in ssl-certificate and
# ssl-privatekey settings in SSL section)
#
#set sasl-mechanism 0
# Set username to authenticate to IRC NickServ with
#set sasl-username "llamabot"
# Set password to authenticate to IRC NickServ with
#set sasl-password "password"
# Specify the location of certificate to use for the SASL
# ecdsa-nist256p-challenge. An ECDSA certificate can be generated with the
# command:
# openssl ecparam -genkey -name prime256v1 -out eggdrop-ecdsa.pem
#set sasl-ecdsa-key "eggdrop-ecdsa.pem"
# Set SASL failure action
# If SASL authentication fails, do you want to connect to the server anyway?
# Set to this to 0 to disconnect and retry until success, or 1 to continue
# connecting to the server without SASL authentication.
#set sasl-continue 1
#
# Timeout (in seconds) before giving up SASL authentication
#set sasl-timeout 15
</pre>
* Added ability to choose specific SSL/TLS protocols to use (ssl-protocols)
<pre>
# Specify the list of protocols allowed for use with ssl. The protocol list is
# one or more protocol strings separated by spaces. Available protocols are
# SSLv2, SSLv3, TLSv1, TLSv1.1, TLSv1.2, TLSv1.3.
# set ssl-protocols "TLSv1 TLSv1.1 TLSv1.2 TLSv1.3"
</pre>
* Added ability to allow bots to remain linked if userfile sharing fails (sharefail-unlink)
<pre>
# By default, Eggdrop will abort the linking process if userfile sharing is
# enabled but the userfile transfer fails. Set this to 0 to keep the bots
# linked if the userfile transfer fails and retry every minute (both bots must
# be v1.9.0 or higher).
#set sharefail-unlink 1
</pre>
* Changed the method Eggdrop uses to add servers from a {} list to the new addserver command
<pre>
# This is the bot's server list. The bot will start at the first server listed,
# and cycle through them whenever it gets disconnected. You need to change these
# servers to YOUR network's servers.
#
# The format is:
# server add <server> [port [password]]
# Prefix the port with a plus sign to attempt a SSL connection:
# server add <server> +port [password]
#
# This format is new as of version 1.9.0. The previous method using
# set servers {} will still work for now, but is deprecated and will be removed
# in a future release.
server add you.need.to.change.this 6667
server add another.example.com 6669 password
server add 2001:db8:618:5c0:263:: 6669 password
server add ssl.example.net +7000
</pre>
* Added CAP settings
<pre>
# To request the account-notify feature via CAP, set this to 1
#set account-notify 0
# To request the invite-notify feature via CAP, set this to 1
#set invite-notify 0
# To request the message-tags feature via CAP, set this to 1. NOTE: Enabling
# this feature may interfere with RAW binds in scripts.
#set message-tags 0
# If you have any additional CAP features you would like to request at
# registration but are not listed above, set them here as space separated
# strings. Setting features here does not guarantee Eggdrop's ability to support
# these them.
#set cap-request "feature1 feature2 feature3"
</pre>
* Removed the listen-addr command. The listen command now accepts an optional IP argument in lieu of using listen-addr
<pre>
# To bind the listening port to a specific IP instead of all available, insert
# a valid IP assigned to the host Eggdrop is running on infront of the port
# (this replaces the listen-addr setting used prior to Eggdrop v1.9)
#
# listen 1.2.3.4 3333 all
</pre>
* Added the show-uname setting, which allows you to disable the display of uname info for the host system in things like .status
<pre>
# Disable this setting if you do not want to show name and release level of the
# operating system. You'll probably also want to edit the default motd (in
# text/motd) and remove its display from there.
set show-uname 1
</pre>

== Config changes made in 1.9.1 ==
* Added Libera to accepted server types

== Config changes made in 1.9.2 ==
* Added the 'extended-join' setting, to enable the extended-join CAP capability
<pre>
# To request the account-notify feature via CAP, set this to 1
#set extended-join 0
</pre>
* Moved DNS-related settings out of the modules section and into the core config area
* No longer load the (now-deprecated) DNS module by default

== Config changes made in 1.9.3 ==
* None.

== Config changes made in 1.9.4 ==
* 'account-notify' default is changed to 1
<pre>
# To request the account-notify feature via CAP, set this to 1
set account-notify 1
</pre>
* 'extended-join' default is changed to 1
<pre>
# To request the extended-join feature via CAP, set this to 1
#set extended-join 0
set extended-join 1
</pre>
* 'account-tag' setting is added with the default value 0
<pre>
# To request the account-tag feature via CAP, set this to 1
# This can be enabled if necessary for imperfect account tracking if you don't
# have the WHOX (use_354), account-notify and extended-join features available
# see doc/ACCOUNTS for details
#set account-tag 0
</pre>

== Config changes made in 1.9.5 ==
* None.

== Config changes made in 1.10.0 ==
* The copy-to-tmp setting was removed
* The quick-logs setting was removed
* Settings for the removed DNS module were removed:
** loadmodue dns
** set dns-servers
** set dns-cache
** set dns-negcache
** set dns-maxsends
** set dns-retrydelay
* Added 'loadmodule python' to load the new Python module
<pre>
# This module gives Eggdrop the ability to run python scripts. if loaded,
# Python scripts can be loaded at the end of the config file using the pysouce
# command to tell Eggdrop where the file is loaded. The module requires Python
# version 3.8 or higher to run. To load the python module, uncomment it below.
#loadmodule python
</pre>
* The autoscripts Tcl script was added and loaded by default, to allow scripts to be loaded and managed from the partyline
<pre>
##### AUTOSCRIPTS #####

# Load this script to enable the autoscripts functionality for Eggdrop.
# Autoscripts are scripts that can be downloaded, installed and configured via
# the partyline. For more information, read doc/AUTOSCRIPTS
source scripts/autoscripts.tcl
</pre>

== Config changes made in 1.10.0 ==
* Added SCRAM-SHA-256 and SCRAM-SHA-512 as SASL authentication methods for sasl-mechanism
<pre>
# 3 = SCRAM-SHA-256
#
# 4 = SCRAM-SHA-512
</pre>
* Removed quotepong.tcl script, as no networks use it anymore

Config Changes

2025-09-06T19:58:40Z

Geo: /* Config changes made in 1.9.0 */

Config Changes

2025-09-06T19:58:09Z

Geo: Added 1.10.1 settings

== Config changes made in 1.9.0 ==
* Added additional net-types for freenode, Quakenet, and Rizon (net-type)
<pre>
## What is your network?
## Options are:
## EFnet
## IRCnet
## Undernet
## DALnet
## Libera
## freenode
## QuakeNet
## Rizon
## Twitch (This requires twitch.mod to be loaded as well)
## Other (This is a good, sane default option to use if your network/ircd is
## not listed here. Additional configuration options for this setting
## can be found further down in the IRC MODULE section)
set net-type "EFnet"
</pre>
* Added SASL configuration settings
<pre>
#### CAP Features ####
# This section controls IRCv3 capabilities supported natively by Eggdrop. You
# can enable individual settings here to be requested as part of the
# registration process with the IRC server. Not all servers support all CAP
# features. https://ircv3.net/support/networks.html maintains a list of some
# popular servers, and you can also use '.tcl cap available' from the partyline
# to list capabilities available on that server.
# SASL is a method that allows Eggdrop to authenticate with a NickServ service
# as part of the connection process to a server, eliminating the need to later
# authenticate via a /msg command.
#
# To request SASL authentication via CAP, set this to 1
#set sasl 0
# Set SASL mechanism to authenticate with.
# Options are:
# 0 = PLAIN (normal user/pass exchange, only encrypted
# if connected to the IRC server with a
# SSL/TLS connection)
#
# 1 = ECDSA-NIST256P-CHALLENGE (Uses a certificate; usually requires a
# public key to be registered with NickServ
# or other similar service. Set certificate
# to use in sasl-ecdsa-key setting below)
#
# 2 = EXTERNAL (Some other method you set up. Certificates
# used are defined in ssl-certificate and
# ssl-privatekey settings in SSL section)
#
#set sasl-mechanism 0
# Set username to authenticate to IRC NickServ with
#set sasl-username "llamabot"
# Set password to authenticate to IRC NickServ with
#set sasl-password "password"
# Specify the location of certificate to use for the SASL
# ecdsa-nist256p-challenge. An ECDSA certificate can be generated with the
# command:
# openssl ecparam -genkey -name prime256v1 -out eggdrop-ecdsa.pem
#set sasl-ecdsa-key "eggdrop-ecdsa.pem"
# Set SASL failure action
# If SASL authentication fails, do you want to connect to the server anyway?
# Set to this to 0 to disconnect and retry until success, or 1 to continue
# connecting to the server without SASL authentication.
#set sasl-continue 1
#
# Timeout (in seconds) before giving up SASL authentication
#set sasl-timeout 15
</pre>
* Added ability to choose specific SSL/TLS protocols to use (ssl-protocols)
<pre>
# Specify the list of protocols allowed for use with ssl. The protocol list is
# one or more protocol strings separated by spaces. Available protocols are
# SSLv2, SSLv3, TLSv1, TLSv1.1, TLSv1.2, TLSv1.3.
# set ssl-protocols "TLSv1 TLSv1.1 TLSv1.2 TLSv1.3"
</pre>
* Added ability to allow bots to remain linked if userfile sharing fails (sharefail-unlink)
<pre>
# By default, Eggdrop will abort the linking process if userfile sharing is
# enabled but the userfile transfer fails. Set this to 0 to keep the bots
# linked if the userfile transfer fails and retry every minute (both bots must
# be v1.9.0 or higher).
#set sharefail-unlink 1
</pre>
* Changed the method Eggdrop uses to add servers from a {} list to the new addserver command
<pre>
# This is the bot's server list. The bot will start at the first server listed,
# and cycle through them whenever it gets disconnected. You need to change these
# servers to YOUR network's servers.
#
# The format is:
# server add <server> [port [password]]
# Prefix the port with a plus sign to attempt a SSL connection:
# server add <server> +port [password]
#
# This format is new as of version 1.9.0. The previous method using
# set servers {} will still work for now, but is deprecated and will be removed
# in a future release.
server add you.need.to.change.this 6667
server add another.example.com 6669 password
server add 2001:db8:618:5c0:263:: 6669 password
server add ssl.example.net +7000
</pre>
* Added CAP settings
<pre>
# To request the account-notify feature via CAP, set this to 1
#set account-notify 0
# To request the invite-notify feature via CAP, set this to 1
#set invite-notify 0
# To request the message-tags feature via CAP, set this to 1. NOTE: Enabling
# this feature may interfere with RAW binds in scripts.
#set message-tags 0
# If you have any additional CAP features you would like to request at
# registration but are not listed above, set them here as space separated
# strings. Setting features here does not guarantee Eggdrop's ability to support
# these them.
#set cap-request "feature1 feature2 feature3"
</pre>
* Removed the listen-addr command. The listen command now accepts an optional IP argument in lieu of using listen-addr
<pre>
# To bind the listening port to a specific IP instead of all available, insert
# a valid IP assigned to the host Eggdrop is running on infront of the port
# (this replaces the listen-addr setting used prior to Eggdrop v1.9)
#
# listen 1.2.3.4 3333 all
</pre>
* Added the show-uname setting, which allows you to disable the display of uname info for the host system in things like .status
<pre>
# Disable this setting if you do not want to show name and release level of the
# operating system. You'll probably also want to edit the default motd (in
# text/motd) and remove its display from there.
set show-uname 1
</pre>

== Config changes made in 1.9.1 ==
* Added Libera to accepted server types

== Config changes made in 1.9.2 ==
* Added the 'extended-join' setting, to enable the extended-join CAP capability
<pre>
# To request the account-notify feature via CAP, set this to 1
#set extended-join 0
</pre>
* Moved DNS-related settings out of the modules section and into the core config area
* No longer load the (now-deprecated) DNS module by default

== Config changes made in 1.9.3 ==
* None.

== Config changes made in 1.9.4 ==
* 'account-notify' default is changed to 1
<pre>
# To request the account-notify feature via CAP, set this to 1
set account-notify 1
</pre>
* 'extended-join' default is changed to 1
<pre>
# To request the extended-join feature via CAP, set this to 1
#set extended-join 0
set extended-join 1
</pre>
* 'account-tag' setting is added with the default value 0
<pre>
# To request the account-tag feature via CAP, set this to 1
# This can be enabled if necessary for imperfect account tracking if you don't
# have the WHOX (use_354), account-notify and extended-join features available
# see doc/ACCOUNTS for details
#set account-tag 0
</pre>

== Config changes made in 1.9.5 ==
* None.

== Config changes made in 1.10.0 ==
* The copy-to-tmp setting was removed
* The quick-logs setting was removed
* Settings for the removed DNS module were removed:
** loadmodue dns
** set dns-servers
** set dns-cache
** set dns-negcache
** set dns-maxsends
** set dns-retrydelay
* Added 'loadmodule python' to load the new Python module
<pre>
# This module gives Eggdrop the ability to run python scripts. if loaded,
# Python scripts can be loaded at the end of the config file using the pysouce
# command to tell Eggdrop where the file is loaded. The module requires Python
# version 3.8 or higher to run. To load the python module, uncomment it below.
#loadmodule python
</pre>
* The autoscripts Tcl script was added and loaded by default, to allow scripts to be loaded and managed from the partyline
<pre>
##### AUTOSCRIPTS #####

# Load this script to enable the autoscripts functionality for Eggdrop.
# Autoscripts are scripts that can be downloaded, installed and configured via
# the partyline. For more information, read doc/AUTOSCRIPTS
source scripts/autoscripts.tcl
</pre>

== Config changes made in 1.10.0 ==
* Added SCRAM-SHA-256 and SCRAM-SHA-512 as SASL authentication methods for sasl-mechanism
<pre>
# 3 = SCRAM-SHA-256
#
# 4 = SCRAM-SHA-512
</pre>

SelfJoin

2025-07-28T12:42:13Z

Geo:

A common question from users is, "Why isn't my Eggdrop triggering a JOIN bind when it joins a channel?" The answer is it doesn't know it joined the channel- the IRCD server only sends the 'JOIN' message to clients that are already on that channel, not to the client that joined.

Another common question is "Why doesn't my Eggdrop do X as soon as it joins a channel?" The answer here is that there is a small gap between when the Eggdrop joins a channel and when the IRCD sends information about the channel to the Eggdrop, like the user list, modes, etc.

To deal with these scenarios, Eggdrop has the EVNT bind type "got-chanlist", which will trigger once all the channel information is received from the server. At this point, Eggdrop has all the information it needs to properly administer the channel.

<pre>
# Bind to the 'got-chanlist' event
bind evnt * got-chanlist do_action

# Say hello once we have received a channel list
proc do_action {type chan} {
putserv "PRIVMSG $chan :Channel list received. Hi!"
# <Do more stuff here>
}
</pre>

EggWiki

2025-07-27T15:11:17Z

Geo: /* Tcl Examples */

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/setup Installation Tutorial]

[[Do I have Tcl installed?]]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

[[Cert Val Failed| certificate validation failed: unable to get local issuer certificate ]]

[[Docker| Common Docker issues]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Connect To Partyline with TLS| How do I connect to the partyline using TLS?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

[[Inline| When compiling ancient versions of Eggdrop, I get "undefined reference to `cron_matchfld'" and other similar errors]]

== Tcl Examples ==
[[Setudef| Writing Tcl scripts that work only on selected channels]]

[[MinutelyWho| Writing a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl script that can access https websites]]

[[Http_async| Writing a Tcl script that can access http websites asynchronous and gets the title of it]]

[[SelfJoin| Writing a Tcl script that performs an action when the bot joins a channel]]

== Python ==

[[Python]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]

[[EggModules|What is the difference between the IRC, Server, and Channel modules?]]

EggWiki

2025-07-27T15:10:33Z

Geo: /* Tcl Examples */

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/setup Installation Tutorial]

[[Do I have Tcl installed?]]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

[[Cert Val Failed| certificate validation failed: unable to get local issuer certificate ]]

[[Docker| Common Docker issues]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Connect To Partyline with TLS| How do I connect to the partyline using TLS?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

[[Inline| When compiling ancient versions of Eggdrop, I get "undefined reference to `cron_matchfld'" and other similar errors]]

== Tcl Examples ==
[[Setudef| Writing scripts that work only on selected channels]]

[[MinutelyWho| Write a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl that can access https websites]]

[[Http_async| Writing a Tcl that can access http websites asynchronous and gets the title of it]]

[[SelfJoin| Write a script that performs an action when the bot joins a channel]]

== Python ==

[[Python]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]

[[EggModules|What is the difference between the IRC, Server, and Channel modules?]]

SelfJoin

2025-07-27T15:10:02Z

Geo: Created page with "A common question from users is, "Why isn't my Eggdrop triggering a JOIN bind when it joins a channel?" The answer is it doesn't know it joined the channel- the IRCD server only sends the 'JOIN' message to clients that are already on that channel, not to the client that joined. Another common question is "Why doesn't my Eggdrop do X as soon as it joins a channel?" The answer here is that there is a small gap between when the Eggdrop joins a channel and when the IRCD se..."

A common question from users is, "Why isn't my Eggdrop triggering a JOIN bind when it joins a channel?" The answer is it doesn't know it joined the channel- the IRCD server only sends the 'JOIN' message to clients that are already on that channel, not to the client that joined.

Another common question is "Why doesn't my Eggdrop do X as soon as it joins a channel?" The answer here is that there is a small gap between when the Eggdrop joins a channel and when the IRCD sends information about the channel to the Eggdrop, like the user list, modes, etc.

To deal with these scenarios, Eggdrop has the EVNT bind type "got-chanmode", which will trigger once all the channel information is received from the server. At this point, Eggdrop has all the information it needs to properly administer the channel.

<pre>
# Bind to the 'got-chanlist' event
bind evnt * got-chanlist do_action

# Say hello once we have received a channel list
proc do_action {type chan} {
putserv "PRIVMSG $chan :Channel list received. Hi!"
# <Do more stuff here>
}
</pre>

EggWiki

2025-07-27T14:36:04Z

Geo: /* Tcl Examples */

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/setup Installation Tutorial]

[[Do I have Tcl installed?]]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

[[Cert Val Failed| certificate validation failed: unable to get local issuer certificate ]]

[[Docker| Common Docker issues]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Connect To Partyline with TLS| How do I connect to the partyline using TLS?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

[[Inline| When compiling ancient versions of Eggdrop, I get "undefined reference to `cron_matchfld'" and other similar errors]]

== Tcl Examples ==
[[Setudef| Writing scripts that work only on selected channels]]

[[MinutelyWho| Write a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl that can access https websites]]

[[Http_async| Writing a Tcl that can access http websites asynchronous and gets the title of it]]

[[SelfJoin| Write a script that performs an action when the bot joins a channel]]

[[DoOnOp]]| Write a script that performs an action when the bot joins a that requires +o]]

== Python ==

[[Python]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]

[[EggModules|What is the difference between the IRC, Server, and Channel modules?]]

Python

2024-10-14T02:42:03Z

Geo:

== Known Issues ==

=== Eggdrop's Python module duplicates bindings after a rehash ===
Eggdrop currently has trouble tracking python binds through a rehash. This results in multiple binds being set for the same trigger in some cases. Example code on how to get around this issue is below- basically, have the python script track its binds and, upon load, check that variable. If there are binds in it- remove them!
<pre>
# Check for previously-existing binds when the script is loaded and delete them if they exist
if 'GREET_BINDS' in globals():
for greetbind in GREET_BINDS:
greetbind.unbind()
del GREET_BINDS

# Continuing from the above section of code, the GREET_BINDS list is created to track the binds
# created by this script, and then the binds are added to it.
GREET_BINDS = list()
# Append the bind to the list you just made
GREET_BINDS.append(bind("join", "*", "*", joinGreetUser))
</pre>

== The python print() function doesn't do anything ==

The print() function in python only prints to stdout, it won't write to IRC or the partyline (unless you started Eggdrop in terminal mode with the -t flag). In order to print something to a channel, you'd need to import the putserv or putmsg Tcl command, or the putlog command to write to the partyline.
<pre>
from eggdrop.tcl import putmsg, putlog

putlog("This sends to the partyline!")
putmsg(chan, "This sends to a channel!")
</pre>

Python

2024-10-06T14:39:52Z

Geo: Created page with "== The python print() function doesn't do anything == The print() function in python only prints to stdout, it won't write to IRC or the partyline (unless you started Eggdrop in terminal mode with the -t flag). In order to print something to a channel, you'd need to import the putserv or putmsg Tcl command, or the putlog command to write to the partyline. <pre> from eggdrop.tcl import putmsg, putlog putlog("This sends to the partyline!") putmsg(chan, "This sends to a c..."

== The python print() function doesn't do anything ==

The print() function in python only prints to stdout, it won't write to IRC or the partyline (unless you started Eggdrop in terminal mode with the -t flag). In order to print something to a channel, you'd need to import the putserv or putmsg Tcl command, or the putlog command to write to the partyline.
<pre>
from eggdrop.tcl import putmsg, putlog

putlog("This sends to the partyline!")
putmsg(chan, "This sends to a channel!")
</pre>

EggWiki

2024-10-06T14:35:01Z

Geo:

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/setup Installation Tutorial]

[[Do I have Tcl installed?]]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

[[Cert Val Failed| certificate validation failed: unable to get local issuer certificate ]]

[[Docker| Common Docker issues]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Connect To Partyline with TLS| How do I connect to the partyline using TLS?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

[[Inline| When compiling ancient versions of Eggdrop, I get "undefined reference to `cron_matchfld'" and other similar errors]]

== Tcl Examples ==
[[Setudef| Writing scripts that work only on selected channels]]

[[MinutelyWho| Write a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl that can access https websites]]

[[Http_async| Writing a Tcl that can access http websites asynchronous and gets the title of it]]

== Python ==

[[Python]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]

[[EggModules|What is the difference between the IRC, Server, and Channel modules?]]

UTF-8

2024-09-11T17:47:06Z

Geo:

<pre style="color: red">IMPORTANT!! As of Eggdrop 1.9.4, Eggdrop was able to successfully workaround the default UTF handling issues with Tcl 8.x versions. That means if you're using a recent version, you probably don't need to do these steps! Tcl 9 and above should not have an issue with UTF-8.
HOWEVER
Eggdrop's ability to handle UTF does not mean Tcl scripts running on Eggdrop were written to handle UTF. For that reason, if you're using a script that isn't displaying Emoji's properly, check out that section below FIRST
</pre>

There are four common issues users encounter when dealing with UTF-8 encoding issues.

== HTTP scripts output "funny" characters ==

If a script that pulls information from an HTTP source isn't outputting characters properly (letters with accents, etc, are being displayed as other incorrect characters), take a look at https://tcl.tk/man/tcl8.6/TclCmd/http.htm#M61 for an explanation, then try adding set ::http::defaultCharset utf-8 before the http request in the script.

== Emojis don't appear in various other ways ==

Prior to Eggdrop versiom 1.9.4, perhaps the most common problem was people attempting to use Unicode emojis (Thumbs up, skull and crossbones, party hats, etc), and incorrectly thinking their Eggdrop does not support any UTF-8 encoding at all. The inability to use Emojis is a result of an issue with Tcl currently (by default) not being able to support Unicode characters with control codes over 3 bytes, which means Tcl cannot handle control codes higher than U+FFFF (More information on this can be found at https://wiki.tcl-lang.org/page/Unicode+and+UTF-8). The remedy for this issue requires you to download a current version of the Tcl source from https://www.tcl.tk/software/tcltk/download.html and manually compile it (this cannot be done by intalling Tcl via a package manager such as apt or yum).

'''Step 1'''

Open the generic/tcl.h file in your editor.

Search for

<code>#define TCL_UTF_MAX 3</code>

and replace it with

<code>#define TCL_UTF_MAX 6</code>

'''Step 2'''

Follow the instructions included with the download to compile and install Tcl.

'''Step 3'''

You'll need to recompile Eggdrop, and may need to specify --with-tcllib and --with-tclinc to point to the new location you installed Tcl to. A correct ./configure command may look similar to this:

<code>
./configure --with-tclinc=/usr/local/include/tcl.h --with-tcllib=/usr/local/lib/libtcl8.6.so
</code>

== Locale issues ==

If you're still having issues with UTF-8, on your host machine, type locale. If it looks similar to this, congrats! you have UTF-8 support and Eggdrop should be able to handle non-Emoji unicode characters.

<pre>
LANG=en_US.UTF-8
LANGUAGE=
LC_CTYPE="en_US.UTF-8"
LC_NUMERIC="en_US.UTF-8"
LC_TIME="en_US.UTF-8"
LC_COLLATE="en_US.UTF-8"
LC_MONETARY="en_US.UTF-8"
LC_MESSAGES="en_US.UTF-8"
LC_PAPER="en_US.UTF-8"
LC_NAME="en_US.UTF-8"
LC_ADDRESS="en_US.UTF-8"
LC_TELEPHONE="en_US.UTF-8"
LC_MEASUREMENT="en_US.UTF-8"
LC_IDENTIFICATION="en_US.UTF-8"
LC_ALL=
</pre>

If it does *not* look like that (specifically, the LANG variable does not end in UTF-8, then you can change your locale to one that supports UTF-8, and Eggdrop will pick up on that change. To do this:

'''Step 1'''

Visit https://help.ubuntu.com/community/Locale (or a similar page for the OS flavor of your choice). In short, you'll want to view the locales available on your system by running

<code>
locale -a
</code>

and find the UTF-8 setting that matches your preferred language. Open the /etc/default/locale file in your editor.

Search for

<code>
LANG=<something>
</code>

and replace it with

<code>
LANG=de_EN.UTF-8
</code>

or, obviously, whichever language makes sense to use for you.

'''Step 2'''

Recompile Eggdrop.

If you are still having issues after making these changes, re-read the Emojis section.

== UTF-8 not found on system ==

If the locale trick does not work, or you are on a system that does not have a UTF locale pack (or you are unable to install one), you can try to force UTF-8 by doing the following.

'''Step 1'''

Open the eggdrop1.9.2/src/tcl.c file in your editor.

Search for (around line 650)

<pre>
if (encoding == NULL) {
encoding = "iso8859-1";
}
</pre>

and insert the following right after it

<code>
encoding = "utf-8";
</code>

'''Step 2'''

Recompile Eggdrop.

== How can I check what encoding is set? ==
* If you have the .tcl command enabled, you can run
<pre>
.tcl encoding system
</pre> to check what encoding Tcl is trying to use

EggWiki

2024-09-09T15:30:58Z

Geo: Add docker to main page

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/setup Installation Tutorial]

[[Do I have Tcl installed?]]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

[[Cert Val Failed| certificate validation failed: unable to get local issuer certificate ]]

[[Docker| Common Docker issues]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Connect To Partyline with TLS| How do I connect to the partyline using TLS?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

[[Inline| When compiling ancient versions of Eggdrop, I get "undefined reference to `cron_matchfld'" and other similar errors]]

== Tcl Examples ==
[[Setudef| Writing scripts that work only on selected channels]]

[[MinutelyWho| Write a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl that can access https websites]]

[[Http_async| Writing a Tcl that can access http websites asynchronous and gets the title of it]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]

[[EggModules|What is the difference between the IRC, Server, and Channel modules?]]

Docker

2024-09-09T15:30:02Z

Geo: Add Tcl error msgs

Eggdrop has an official Docker image! While most things work the same, there are a few new errors that pop up, and ways to implement it. A docker-compose.yml example is hosted at https://github.com/eggheads/eggdrop-docker/blob/master/docker-compose.yml⁠

== Loading Tcl Packages ==
Many scripts require extra OS packages to be installed in order to function, such as tcl-tls, tcl-lib and libsqlite3-tcl. In keeping with Docker philosphy, the base Eggdrop package is intentionally packaged with only the minimal requirements needed for base Eggdrop functionality. However, users may easily add add packages when starting a container from the command line like this:
<pre>
docker run -i eggdrop sh -c 'apk add tcl-lib tcl-tls && exec /home/eggdrop/eggdrop/entrypoint.sh eggdrop.conf'
</pre>
For a docker-compose file, you can add the following line in the build section:
<pre>
build:
context: .
dockerfile_inline: |
FROM eggdrop:latest
RUN apk add tcl-lib tcl-tls
</pre>

== Commonly Seen Errors ==
* When using a docker-compose file started from scratch, you may see the error message <code>"END OF FILE ON TERMINAL"</code> at startup. To fix this, add
<pre>
stdin_open: true
</pre>
to the docker-compose.yml file.
* In docker images for 1.9.3, 1.9.4, and 1.9.5, even after installing packages like tcl-lib and tcl-tls, Eggdrop still can't use them. This is because the install location for Tcl packages in alpine 3.18 and 3.19 do not match the install location of the version compiled by the Eggdrop image, causing errors similar to <code>can't find package </code> or similar when running <code>package require tls</code> or similar. To tell Eggdrop where to look for Tcl packages installed by the apk package manager, pass the environmental flag via docker command line <code>-e TCLLIBPATH=/usr/lib</code> or via the partyline if the .tcl command is enabled by <code>.tcl set env(TCLLIBPATH) /usr/lib</code>. If using compose, you can also edit the doker-compose.yml file and add:
<pre>
environment:
TCLLIB: /usr/lib
</pre>

Docker

2024-09-09T15:18:50Z

Geo: Created page with "Eggdrop has an official Docker image! While most things work the same, there are a few new errors that pop up, and ways to implement it. A docker-compose.yml example is hosted at https://github.com/eggheads/eggdrop-docker/blob/master/docker-compose.yml⁠ == Loading Tcl Packages == Many scripts require extra OS packages to be installed in order to function, such as tcl-tls, tcl-lib and libsqlite3-tcl. In keeping with Docker philosphy, the base Eggdrop package is intenti..."

Config Changes

2024-09-08T17:23:08Z

Geo: Add config codeblocks to 1.10.0

== Config changes made in 1.9.0 ==
* Added additional net-types for freenode, Quakenet, and Rizon (net-type)
<pre>
## What is your network?
## Options are:
## EFnet
## IRCnet
## Undernet
## DALnet
## Libera
## freenode
## QuakeNet
## Rizon
## Twitch (This requires twitch.mod to be loaded as well)
## Other (This is a good, sane default option to use if your network/ircd is
## not listed here. Additional configuration options for this setting
## can be found further down in the IRC MODULE section)
set net-type "EFnet"
</pre>
* Added SASL configuration settings
<pre>
#### CAP Features ####
# This section controls IRCv3 capabilities supported natively by Eggdrop. You
# can enable individual settings here to be requested as part of the
# registration process with the IRC server. Not all servers support all CAP
# features. https://ircv3.net/support/networks.html maintains a list of some
# popular servers, and you can also use '.tcl cap available' from the partyline
# to list capabilities available on that server.
# SASL is a method that allows Eggdrop to authenticate with a NickServ service
# as part of the connection process to a server, eliminating the need to later
# authenticate via a /msg command.
#
# To request SASL authentication via CAP, set this to 1
#set sasl 0
# Set SASL mechanism to authenticate with.
# Options are:
# 0 = PLAIN (normal user/pass exchange, only encrypted
# if connected to the IRC server with a
# SSL/TLS connection)
#
# 1 = ECDSA-NIST256P-CHALLENGE (Uses a certificate; usually requires a
# public key to be registered with NickServ
# or other similar service. Set certificate
# to use in sasl-ecdsa-key setting below)
#
# 2 = EXTERNAL (Some other method you set up. Certificates
# used are defined in ssl-certificate and
# ssl-privatekey settings in SSL section)
#
#set sasl-mechanism 0
# Set username to authenticate to IRC NickServ with
#set sasl-username "llamabot"
# Set password to authenticate to IRC NickServ with
#set sasl-password "password"
# Specify the location of certificate to use for the SASL
# ecdsa-nist256p-challenge. An ECDSA certificate can be generated with the
# command:
# openssl ecparam -genkey -name prime256v1 -out eggdrop-ecdsa.pem
#set sasl-ecdsa-key "eggdrop-ecdsa.pem"
# Set SASL failure action
# If SASL authentication fails, do you want to connect to the server anyway?
# Set to this to 0 to disconnect and retry until success, or 1 to continue
# connecting to the server without SASL authentication.
#set sasl-continue 1
#
# Timeout (in seconds) before giving up SASL authentication
#set sasl-timeout 15
</pre>
* Added ability to choose specific SSL/TLS protocols to use (ssl-protocols)
<pre>
# Specify the list of protocols allowed for use with ssl. The protocol list is
# one or more protocol strings separated by spaces. Available protocols are
# SSLv2, SSLv3, TLSv1, TLSv1.1, TLSv1.2, TLSv1.3.
# set ssl-protocols "TLSv1 TLSv1.1 TLSv1.2 TLSv1.3"
</pre>
* Added ability to allow bots to remain linked if userfile sharing fails (sharefail-unlink)
<pre>
# By default, Eggdrop will abort the linking process if userfile sharing is
# enabled but the userfile transfer fails. Set this to 0 to keep the bots
# linked if the userfile transfer fails and retry every minute (both bots must
# be v1.9.0 or higher).
#set sharefail-unlink 1
</pre>
* Changed the method Eggdrop uses to add servers from a {} list to the new addserver command
<pre>
# This is the bot's server list. The bot will start at the first server listed,
# and cycle through them whenever it gets disconnected. You need to change these
# servers to YOUR network's servers.
#
# The format is:
# server add <server> [port [password]]
# Prefix the port with a plus sign to attempt a SSL connection:
# server add <server> +port [password]
#
# This format is new as of version 1.9.0. The previous method using
# set servers {} will still work for now, but is deprecated and will be removed
# in a future release.
server add you.need.to.change.this 6667
server add another.example.com 6669 password
server add 2001:db8:618:5c0:263:: 6669 password
server add ssl.example.net +7000
</pre>
* Added CAP settings
<pre>
# To request the account-notify feature via CAP, set this to 1
#set account-notify 0
# To request the invite-notify feature via CAP, set this to 1
#set invite-notify 0
# To request the message-tags feature via CAP, set this to 1. NOTE: Enabling
# this feature may interfere with RAW binds in scripts.
#set message-tags 0
# If you have any additional CAP features you would like to request at
# registration but are not listed above, set them here as space separated
# strings. Setting features here does not guarantee Eggdrop's ability to support
# these them.
#set cap-request "feature1 feature2 feature3"
</pre>
* Removed the listen-addr command. The listen command now accepts an optional IP argument in lieu of using listen-addr
<pre>
# To bind the listening port to a specific IP instead of all available, insert
# a valid IP assigned to the host Eggdrop is running on infront of the port
# (this replaces the listen-addr setting used prior to Eggdrop v1.9)
#
# listen 1.2.3.4 3333 all
</pre>
* Added the show-uname setting, which allows you to disable the display of uname info for the host system in things like .status
<pre>
# Disable this setting if you do not want to show name and release level of the
# operating system. You'll probably also want to edit the default motd (in
# text/motd) and remove its display from there.
set show-uname 1
</pre>

== Config changes made in 1.9.1 ==
* Added Libera to accepted server types

== Config changes made in 1.9.2 ==
* Added the 'extended-join' setting, to enable the extended-join CAP capability
<pre>
# To request the account-notify feature via CAP, set this to 1
#set extended-join 0
</pre>
* Moved DNS-related settings out of the modules section and into the core config area
* No longer load the (now-deprecated) DNS module by default

== Config changes made in 1.9.3 ==
* None.

== Config changes made in 1.9.4 ==
* 'account-notify' default is changed to 1
<pre>
# To request the account-notify feature via CAP, set this to 1
set account-notify 1
</pre>
* 'extended-join' default is changed to 1
<pre>
# To request the extended-join feature via CAP, set this to 1
#set extended-join 0
set extended-join 1
</pre>
* 'account-tag' setting is added with the default value 0
<pre>
# To request the account-tag feature via CAP, set this to 1
# This can be enabled if necessary for imperfect account tracking if you don't
# have the WHOX (use_354), account-notify and extended-join features available
# see doc/ACCOUNTS for details
#set account-tag 0
</pre>

== Config changes made in 1.9.5 ==
* None.

== Config changes made in 1.10.0 ==
* The copy-to-tmp setting was removed
* The quick-logs setting was removed
* Settings for the removed DNS module were removed:
** loadmodue dns
** set dns-servers
** set dns-cache
** set dns-negcache
** set dns-maxsends
** set dns-retrydelay
* Added 'loadmodule python' to load the new Python module
<pre>
# This module gives Eggdrop the ability to run python scripts. if loaded,
# Python scripts can be loaded at the end of the config file using the pysouce
# command to tell Eggdrop where the file is loaded. The module requires Python
# version 3.8 or higher to run. To load the python module, uncomment it below.
#loadmodule python
</pre>
* The autoscripts Tcl script was added and loaded by default, to allow scripts to be loaded and managed from the partyline
<pre>
##### AUTOSCRIPTS #####

# Load this script to enable the autoscripts functionality for Eggdrop.
# Autoscripts are scripts that can be downloaded, installed and configured via
# the partyline. For more information, read doc/AUTOSCRIPTS
source scripts/autoscripts.tcl
</pre>

Config Changes

2024-09-08T17:21:39Z

Geo: Add config codeblocks to 1.9.4

== Config changes made in 1.9.0 ==
* Added additional net-types for freenode, Quakenet, and Rizon (net-type)
<pre>
## What is your network?
## Options are:
## EFnet
## IRCnet
## Undernet
## DALnet
## Libera
## freenode
## QuakeNet
## Rizon
## Twitch (This requires twitch.mod to be loaded as well)
## Other (This is a good, sane default option to use if your network/ircd is
## not listed here. Additional configuration options for this setting
## can be found further down in the IRC MODULE section)
set net-type "EFnet"
</pre>
* Added SASL configuration settings
<pre>
#### CAP Features ####
# This section controls IRCv3 capabilities supported natively by Eggdrop. You
# can enable individual settings here to be requested as part of the
# registration process with the IRC server. Not all servers support all CAP
# features. https://ircv3.net/support/networks.html maintains a list of some
# popular servers, and you can also use '.tcl cap available' from the partyline
# to list capabilities available on that server.
# SASL is a method that allows Eggdrop to authenticate with a NickServ service
# as part of the connection process to a server, eliminating the need to later
# authenticate via a /msg command.
#
# To request SASL authentication via CAP, set this to 1
#set sasl 0
# Set SASL mechanism to authenticate with.
# Options are:
# 0 = PLAIN (normal user/pass exchange, only encrypted
# if connected to the IRC server with a
# SSL/TLS connection)
#
# 1 = ECDSA-NIST256P-CHALLENGE (Uses a certificate; usually requires a
# public key to be registered with NickServ
# or other similar service. Set certificate
# to use in sasl-ecdsa-key setting below)
#
# 2 = EXTERNAL (Some other method you set up. Certificates
# used are defined in ssl-certificate and
# ssl-privatekey settings in SSL section)
#
#set sasl-mechanism 0
# Set username to authenticate to IRC NickServ with
#set sasl-username "llamabot"
# Set password to authenticate to IRC NickServ with
#set sasl-password "password"
# Specify the location of certificate to use for the SASL
# ecdsa-nist256p-challenge. An ECDSA certificate can be generated with the
# command:
# openssl ecparam -genkey -name prime256v1 -out eggdrop-ecdsa.pem
#set sasl-ecdsa-key "eggdrop-ecdsa.pem"
# Set SASL failure action
# If SASL authentication fails, do you want to connect to the server anyway?
# Set to this to 0 to disconnect and retry until success, or 1 to continue
# connecting to the server without SASL authentication.
#set sasl-continue 1
#
# Timeout (in seconds) before giving up SASL authentication
#set sasl-timeout 15
</pre>
* Added ability to choose specific SSL/TLS protocols to use (ssl-protocols)
<pre>
# Specify the list of protocols allowed for use with ssl. The protocol list is
# one or more protocol strings separated by spaces. Available protocols are
# SSLv2, SSLv3, TLSv1, TLSv1.1, TLSv1.2, TLSv1.3.
# set ssl-protocols "TLSv1 TLSv1.1 TLSv1.2 TLSv1.3"
</pre>
* Added ability to allow bots to remain linked if userfile sharing fails (sharefail-unlink)
<pre>
# By default, Eggdrop will abort the linking process if userfile sharing is
# enabled but the userfile transfer fails. Set this to 0 to keep the bots
# linked if the userfile transfer fails and retry every minute (both bots must
# be v1.9.0 or higher).
#set sharefail-unlink 1
</pre>
* Changed the method Eggdrop uses to add servers from a {} list to the new addserver command
<pre>
# This is the bot's server list. The bot will start at the first server listed,
# and cycle through them whenever it gets disconnected. You need to change these
# servers to YOUR network's servers.
#
# The format is:
# server add <server> [port [password]]
# Prefix the port with a plus sign to attempt a SSL connection:
# server add <server> +port [password]
#
# This format is new as of version 1.9.0. The previous method using
# set servers {} will still work for now, but is deprecated and will be removed
# in a future release.
server add you.need.to.change.this 6667
server add another.example.com 6669 password
server add 2001:db8:618:5c0:263:: 6669 password
server add ssl.example.net +7000
</pre>
* Added CAP settings
<pre>
# To request the account-notify feature via CAP, set this to 1
#set account-notify 0
# To request the invite-notify feature via CAP, set this to 1
#set invite-notify 0
# To request the message-tags feature via CAP, set this to 1. NOTE: Enabling
# this feature may interfere with RAW binds in scripts.
#set message-tags 0
# If you have any additional CAP features you would like to request at
# registration but are not listed above, set them here as space separated
# strings. Setting features here does not guarantee Eggdrop's ability to support
# these them.
#set cap-request "feature1 feature2 feature3"
</pre>
* Removed the listen-addr command. The listen command now accepts an optional IP argument in lieu of using listen-addr
<pre>
# To bind the listening port to a specific IP instead of all available, insert
# a valid IP assigned to the host Eggdrop is running on infront of the port
# (this replaces the listen-addr setting used prior to Eggdrop v1.9)
#
# listen 1.2.3.4 3333 all
</pre>
* Added the show-uname setting, which allows you to disable the display of uname info for the host system in things like .status
<pre>
# Disable this setting if you do not want to show name and release level of the
# operating system. You'll probably also want to edit the default motd (in
# text/motd) and remove its display from there.
set show-uname 1
</pre>

== Config changes made in 1.9.1 ==
* Added Libera to accepted server types

== Config changes made in 1.9.2 ==
* Added the 'extended-join' setting, to enable the extended-join CAP capability
<pre>
# To request the account-notify feature via CAP, set this to 1
#set extended-join 0
</pre>
* Moved DNS-related settings out of the modules section and into the core config area
* No longer load the (now-deprecated) DNS module by default

== Config changes made in 1.9.3 ==
* None.

== Config changes made in 1.9.4 ==
* 'account-notify' default is changed to 1
<pre>
# To request the account-notify feature via CAP, set this to 1
set account-notify 1
</pre>
* 'extended-join' default is changed to 1
<pre>
# To request the extended-join feature via CAP, set this to 1
#set extended-join 0
set extended-join 1
</pre>
* 'account-tag' setting is added with the default value 0
<pre>
# To request the account-tag feature via CAP, set this to 1
# This can be enabled if necessary for imperfect account tracking if you don't
# have the WHOX (use_354), account-notify and extended-join features available
# see doc/ACCOUNTS for details
#set account-tag 0
</pre>

== Config changes made in 1.9.5 ==
* None.

== Config changes made in 1.10.0 ==
* The copy-to-tmp setting was removed
* The quick-logs setting was removed
* Settings for the removed DNS module were removed:
** loadmodue dns
** set dns-servers
** set dns-cache
** set dns-negcache
** set dns-maxsends
** set dns-retrydelay
* Added 'loadmodule python' to load the new Python module
* The autoscripts Tcl script was added and loaded by default, to allow scripts to be loaded and managed from the partyline

Config Changes

2024-09-08T17:12:55Z

Geo: Corrected config setting versions

== Config changes made in 1.9.0 ==
* Added additional net-types for freenode, Quakenet, and Rizon (net-type)
<pre>
## What is your network?
## Options are:
## EFnet
## IRCnet
## Undernet
## DALnet
## Libera
## freenode
## QuakeNet
## Rizon
## Twitch (This requires twitch.mod to be loaded as well)
## Other (This is a good, sane default option to use if your network/ircd is
## not listed here. Additional configuration options for this setting
## can be found further down in the IRC MODULE section)
set net-type "EFnet"
</pre>
* Added SASL configuration settings
<pre>
#### CAP Features ####
# This section controls IRCv3 capabilities supported natively by Eggdrop. You
# can enable individual settings here to be requested as part of the
# registration process with the IRC server. Not all servers support all CAP
# features. https://ircv3.net/support/networks.html maintains a list of some
# popular servers, and you can also use '.tcl cap available' from the partyline
# to list capabilities available on that server.
# SASL is a method that allows Eggdrop to authenticate with a NickServ service
# as part of the connection process to a server, eliminating the need to later
# authenticate via a /msg command.
#
# To request SASL authentication via CAP, set this to 1
#set sasl 0
# Set SASL mechanism to authenticate with.
# Options are:
# 0 = PLAIN (normal user/pass exchange, only encrypted
# if connected to the IRC server with a
# SSL/TLS connection)
#
# 1 = ECDSA-NIST256P-CHALLENGE (Uses a certificate; usually requires a
# public key to be registered with NickServ
# or other similar service. Set certificate
# to use in sasl-ecdsa-key setting below)
#
# 2 = EXTERNAL (Some other method you set up. Certificates
# used are defined in ssl-certificate and
# ssl-privatekey settings in SSL section)
#
#set sasl-mechanism 0
# Set username to authenticate to IRC NickServ with
#set sasl-username "llamabot"
# Set password to authenticate to IRC NickServ with
#set sasl-password "password"
# Specify the location of certificate to use for the SASL
# ecdsa-nist256p-challenge. An ECDSA certificate can be generated with the
# command:
# openssl ecparam -genkey -name prime256v1 -out eggdrop-ecdsa.pem
#set sasl-ecdsa-key "eggdrop-ecdsa.pem"
# Set SASL failure action
# If SASL authentication fails, do you want to connect to the server anyway?
# Set to this to 0 to disconnect and retry until success, or 1 to continue
# connecting to the server without SASL authentication.
#set sasl-continue 1
#
# Timeout (in seconds) before giving up SASL authentication
#set sasl-timeout 15
</pre>
* Added ability to choose specific SSL/TLS protocols to use (ssl-protocols)
<pre>
# Specify the list of protocols allowed for use with ssl. The protocol list is
# one or more protocol strings separated by spaces. Available protocols are
# SSLv2, SSLv3, TLSv1, TLSv1.1, TLSv1.2, TLSv1.3.
# set ssl-protocols "TLSv1 TLSv1.1 TLSv1.2 TLSv1.3"
</pre>
* Added ability to allow bots to remain linked if userfile sharing fails (sharefail-unlink)
<pre>
# By default, Eggdrop will abort the linking process if userfile sharing is
# enabled but the userfile transfer fails. Set this to 0 to keep the bots
# linked if the userfile transfer fails and retry every minute (both bots must
# be v1.9.0 or higher).
#set sharefail-unlink 1
</pre>
* Changed the method Eggdrop uses to add servers from a {} list to the new addserver command
<pre>
# This is the bot's server list. The bot will start at the first server listed,
# and cycle through them whenever it gets disconnected. You need to change these
# servers to YOUR network's servers.
#
# The format is:
# server add <server> [port [password]]
# Prefix the port with a plus sign to attempt a SSL connection:
# server add <server> +port [password]
#
# This format is new as of version 1.9.0. The previous method using
# set servers {} will still work for now, but is deprecated and will be removed
# in a future release.
server add you.need.to.change.this 6667
server add another.example.com 6669 password
server add 2001:db8:618:5c0:263:: 6669 password
server add ssl.example.net +7000
</pre>
* Added CAP settings
<pre>
# To request the account-notify feature via CAP, set this to 1
#set account-notify 0
# To request the invite-notify feature via CAP, set this to 1
#set invite-notify 0
# To request the message-tags feature via CAP, set this to 1. NOTE: Enabling
# this feature may interfere with RAW binds in scripts.
#set message-tags 0
# If you have any additional CAP features you would like to request at
# registration but are not listed above, set them here as space separated
# strings. Setting features here does not guarantee Eggdrop's ability to support
# these them.
#set cap-request "feature1 feature2 feature3"
</pre>
* Removed the listen-addr command. The listen command now accepts an optional IP argument in lieu of using listen-addr
<pre>
# To bind the listening port to a specific IP instead of all available, insert
# a valid IP assigned to the host Eggdrop is running on infront of the port
# (this replaces the listen-addr setting used prior to Eggdrop v1.9)
#
# listen 1.2.3.4 3333 all
</pre>
* Added the show-uname setting, which allows you to disable the display of uname info for the host system in things like .status
<pre>
# Disable this setting if you do not want to show name and release level of the
# operating system. You'll probably also want to edit the default motd (in
# text/motd) and remove its display from there.
set show-uname 1
</pre>

== Config changes made in 1.9.1 ==
* Added Libera to accepted server types

== Config changes made in 1.9.2 ==
* Added the 'extended-join' setting, to enable the extended-join CAP capability
<pre>
# To request the account-notify feature via CAP, set this to 1
#set extended-join 0
</pre>
* Moved DNS-related settings out of the modules section and into the core config area
* No longer load the (now-deprecated) DNS module by default

== Config changes made in 1.9.3 ==
* None.

== Config changes made in 1.9.4 ==
* 'account-notify' default is changed to 1
* 'extended-join' default is changed to 1
* 'account-tag' setting is added with the default value 0

== Config changes made in 1.9.5 ==
* None.

== Config changes made in 1.10.0 ==
* The copy-to-tmp setting was removed
* The quick-logs setting was removed
* Settings for the removed DNS module were removed:
** loadmodue dns
** set dns-servers
** set dns-cache
** set dns-negcache
** set dns-maxsends
** set dns-retrydelay
* Added 'loadmodule python' to load the new Python module
* The autoscripts Tcl script was added and loaded by default, to allow scripts to be loaded and managed from the partyline

Config Changes

2024-09-08T17:06:38Z

Geo: Add 1.10 config changes

== Config changes made in 1.9.0 ==
* Added additional net-types for freenode, Quakenet, and Rizon (net-type)
<pre>
## What is your network?
## Options are:
## EFnet
## IRCnet
## Undernet
## DALnet
## Libera
## freenode
## QuakeNet
## Rizon
## Twitch (This requires twitch.mod to be loaded as well)
## Other (This is a good, sane default option to use if your network/ircd is
## not listed here. Additional configuration options for this setting
## can be found further down in the IRC MODULE section)
set net-type "EFnet"
</pre>
* Added SASL configuration settings
<pre>
#### CAP Features ####
# This section controls IRCv3 capabilities supported natively by Eggdrop. You
# can enable individual settings here to be requested as part of the
# registration process with the IRC server. Not all servers support all CAP
# features. https://ircv3.net/support/networks.html maintains a list of some
# popular servers, and you can also use '.tcl cap available' from the partyline
# to list capabilities available on that server.
# SASL is a method that allows Eggdrop to authenticate with a NickServ service
# as part of the connection process to a server, eliminating the need to later
# authenticate via a /msg command.
#
# To request SASL authentication via CAP, set this to 1
#set sasl 0
# Set SASL mechanism to authenticate with.
# Options are:
# 0 = PLAIN (normal user/pass exchange, only encrypted
# if connected to the IRC server with a
# SSL/TLS connection)
#
# 1 = ECDSA-NIST256P-CHALLENGE (Uses a certificate; usually requires a
# public key to be registered with NickServ
# or other similar service. Set certificate
# to use in sasl-ecdsa-key setting below)
#
# 2 = EXTERNAL (Some other method you set up. Certificates
# used are defined in ssl-certificate and
# ssl-privatekey settings in SSL section)
#
#set sasl-mechanism 0
# Set username to authenticate to IRC NickServ with
#set sasl-username "llamabot"
# Set password to authenticate to IRC NickServ with
#set sasl-password "password"
# Specify the location of certificate to use for the SASL
# ecdsa-nist256p-challenge. An ECDSA certificate can be generated with the
# command:
# openssl ecparam -genkey -name prime256v1 -out eggdrop-ecdsa.pem
#set sasl-ecdsa-key "eggdrop-ecdsa.pem"
# Set SASL failure action
# If SASL authentication fails, do you want to connect to the server anyway?
# Set to this to 0 to disconnect and retry until success, or 1 to continue
# connecting to the server without SASL authentication.
#set sasl-continue 1
#
# Timeout (in seconds) before giving up SASL authentication
#set sasl-timeout 15
</pre>
* Added ability to choose specific SSL/TLS protocols to use (ssl-protocols)
<pre>
# Specify the list of protocols allowed for use with ssl. The protocol list is
# one or more protocol strings separated by spaces. Available protocols are
# SSLv2, SSLv3, TLSv1, TLSv1.1, TLSv1.2, TLSv1.3.
# set ssl-protocols "TLSv1 TLSv1.1 TLSv1.2 TLSv1.3"
</pre>
* Added ability to allow bots to remain linked if userfile sharing fails (sharefail-unlink)
<pre>
# By default, Eggdrop will abort the linking process if userfile sharing is
# enabled but the userfile transfer fails. Set this to 0 to keep the bots
# linked if the userfile transfer fails and retry every minute (both bots must
# be v1.9.0 or higher).
#set sharefail-unlink 1
</pre>
* Changed the method Eggdrop uses to add servers from a {} list to the new addserver command
<pre>
# This is the bot's server list. The bot will start at the first server listed,
# and cycle through them whenever it gets disconnected. You need to change these
# servers to YOUR network's servers.
#
# The format is:
# server add <server> [port [password]]
# Prefix the port with a plus sign to attempt a SSL connection:
# server add <server> +port [password]
#
# This format is new as of version 1.9.0. The previous method using
# set servers {} will still work for now, but is deprecated and will be removed
# in a future release.
server add you.need.to.change.this 6667
server add another.example.com 6669 password
server add 2001:db8:618:5c0:263:: 6669 password
server add ssl.example.net +7000
</pre>
* Added CAP settings
<pre>
# To request the account-notify feature via CAP, set this to 1
#set account-notify 0
# To request the invite-notify feature via CAP, set this to 1
#set invite-notify 0
# To request the message-tags feature via CAP, set this to 1. NOTE: Enabling
# this feature may interfere with RAW binds in scripts.
#set message-tags 0
# If you have any additional CAP features you would like to request at
# registration but are not listed above, set them here as space separated
# strings. Setting features here does not guarantee Eggdrop's ability to support
# these them.
#set cap-request "feature1 feature2 feature3"
</pre>
* Removed the listen-addr command. The listen command now accepts an optional IP argument in lieu of using listen-addr
<pre>
# To bind the listening port to a specific IP instead of all available, insert
# a valid IP assigned to the host Eggdrop is running on infront of the port
# (this replaces the listen-addr setting used prior to Eggdrop v1.9)
#
# listen 1.2.3.4 3333 all
</pre>
* Added the show-uname setting, which allows you to disable the display of uname info for the host system in things like .status
<pre>
# Disable this setting if you do not want to show name and release level of the
# operating system. You'll probably also want to edit the default motd (in
# text/motd) and remove its display from there.
set show-uname 1
</pre>

== Config changes made in 1.9.1 ==
* Added Libera to accepted server types

== Config changes made in 1.9.2 ==
* Added the 'extended-join' setting, to enable the extended-join CAP capability
<pre>
# To request the account-notify feature via CAP, set this to 1
#set extended-join 0
</pre>
* Moved DNS-related settings out of the modules section and into the core config area
* No longer load the (now-deprecated) DNS module by default

== Config changes made in 1.9.3 ==
* None.

== Config changes made in 1.9.4 ==
* None.

== Config changes made in 1.9.5 ==
* None.

== Config changes made in 1.10.0 ==
* The copy-to-tmp setting was removed
* The quick-log setting was removed
* Settings for the removed DNS module were removed:
** loadmodue dns
** set dns-servers
** set dns-cache
** set dns-negcache
** set dns-maxsends
** set dns-retrydelay
* Added 'loadmodule python' to load the new Python module
* The 'account-notify' setting default was changed to '1'
* The 'account-tag' setting was added, and defaults to 0. This is helpful to enable for account tracking purposes
* The autoscripts Tcl script was added and loaded by default, to allow scripts to be loaded and managed from the partyline

UTF-8

2024-08-02T19:48:35Z

Geo: Update 1.9.4 UTF changes

<pre style="color: red">IMPORTANT!! As of Eggdrop 1.9.4, Eggdrop was able to successfully workaround the default UTF handling issues with Tcl. That means if you're using a recent version, you probably don't need to do these steps!
HOWEVER
Eggdrop's ability to handle UTF does not mean Tcl scripts running on Eggdrop were written to handle UTF. For that reason, if you're using a script that isn't displaying Emoji's properly, check out that section below FIRST
</pre>

There are four common issues users encounter when dealing with UTF-8 encoding issues.

== HTTP scripts output "funny" characters ==

If a script that pulls information from an HTTP source isn't outputting characters properly (letters with accents, etc, are being displayed as other incorrect characters), take a look at https://tcl.tk/man/tcl8.6/TclCmd/http.htm#M61 for an explanation, then try adding set ::http::defaultCharset utf-8 before the http request in the script.

== Emojis don't appear in various other ways ==

Prior to Eggdrop versiom 1.9.4, perhaps the most common problem was people attempting to use Unicode emojis (Thumbs up, skull and crossbones, party hats, etc), and incorrectly thinking their Eggdrop does not support any UTF-8 encoding at all. The inability to use Emojis is a result of an issue with Tcl currently (by default) not being able to support Unicode characters with control codes over 3 bytes, which means Tcl cannot handle control codes higher than U+FFFF (More information on this can be found at https://wiki.tcl-lang.org/page/Unicode+and+UTF-8). The remedy for this issue requires you to download a current version of the Tcl source from https://www.tcl.tk/software/tcltk/download.html and manually compile it (this cannot be done by intalling Tcl via a package manager such as apt or yum).

'''Step 1'''

Open the generic/tcl.h file in your editor.

Search for

<code>#define TCL_UTF_MAX 3</code>

and replace it with

<code>#define TCL_UTF_MAX 6</code>

'''Step 2'''

Follow the instructions included with the download to compile and install Tcl.

'''Step 3'''

You'll need to recompile Eggdrop, and may need to specify --with-tcllib and --with-tclinc to point to the new location you installed Tcl to. A correct ./configure command may look similar to this:

<code>
./configure --with-tclinc=/usr/local/include/tcl.h --with-tcllib=/usr/local/lib/libtcl8.6.so
</code>

== Locale issues ==

If you're still having issues with UTF-8, on your host machine, type locale. If it looks similar to this, congrats! you have UTF-8 support and Eggdrop should be able to handle non-Emoji unicode characters.

<pre>
LANG=en_US.UTF-8
LANGUAGE=
LC_CTYPE="en_US.UTF-8"
LC_NUMERIC="en_US.UTF-8"
LC_TIME="en_US.UTF-8"
LC_COLLATE="en_US.UTF-8"
LC_MONETARY="en_US.UTF-8"
LC_MESSAGES="en_US.UTF-8"
LC_PAPER="en_US.UTF-8"
LC_NAME="en_US.UTF-8"
LC_ADDRESS="en_US.UTF-8"
LC_TELEPHONE="en_US.UTF-8"
LC_MEASUREMENT="en_US.UTF-8"
LC_IDENTIFICATION="en_US.UTF-8"
LC_ALL=
</pre>

If it does *not* look like that (specifically, the LANG variable does not end in UTF-8, then you can change your locale to one that supports UTF-8, and Eggdrop will pick up on that change. To do this:

'''Step 1'''

Visit https://help.ubuntu.com/community/Locale (or a similar page for the OS flavor of your choice). In short, you'll want to view the locales available on your system by running

<code>
locale -a
</code>

and find the UTF-8 setting that matches your preferred language. Open the /etc/default/locale file in your editor.

Search for

<code>
LANG=<something>
</code>

and replace it with

<code>
LANG=de_EN.UTF-8
</code>

or, obviously, whichever language makes sense to use for you.

'''Step 2'''

Recompile Eggdrop.

If you are still having issues after making these changes, re-read the Emojis section.

== UTF-8 not found on system ==

If the locale trick does not work, or you are on a system that does not have a UTF locale pack (or you are unable to install one), you can try to force UTF-8 by doing the following.

'''Step 1'''

Open the eggdrop1.9.2/src/tcl.c file in your editor.

Search for (around line 650)

<pre>
if (encoding == NULL) {
encoding = "iso8859-1";
}
</pre>

and insert the following right after it

<code>
encoding = "utf-8";
</code>

'''Step 2'''

Recompile Eggdrop.

== How can I check what encoding is set? ==
* If you have the .tcl command enabled, you can run
<pre>
.tcl encoding system
</pre> to check what encoding Tcl is trying to use

Account Tracking

2024-05-25T15:32:48Z

Geo: Add limitation for join floods

In Eggdrop version 1.9.3, the ability to identify users based on their IRC service account name was added. However, Eggdrop's ability to 100% accurately track the account name associated with a user on a channel depends on three server-provided features
* WHOX. WHOX is an updated version of the WHO command that can provide the account name of users in a channel when requested. WHOX allows Eggdrop to obtain the account status of members already present in a channel when it joins. You can view if your IRC server supports WHOX by viewing the 005 line when you connect to the server.
* Extended-join. Extended-join is an IRCv3 capability that sends the account name of a user (if present) when a user joins a channel. Extended-join allows Eggdrop to obtain the account status of a member as they join a channel. You can view if your IRC server supports this capability by sending /quote CAP LS with your IRC client and viewing the response.
* Account-notify. Account-notify is an IRCv3 capability that notifies members in a channel when a user authenticates to server. Account-notify allows Eggdrop to update the account status of a user if they authenticate after joining a channel. You can view if your IRC server supports this capability by sending /quote CAP LS with your IRC client and viewing the response.

If these three capabilities are all present and enabled, Eggdrop can accurately track a user's account status at all times. If one or more of these three capabilities is missing, Eggdrop will attempt a "best-effort" at tracking account status based on the information it can glean from the capabilities that are enabled. Additionally, you can negotiate the "account-tag" capability (if the IRC server supports it) and Eggdrop will update the account information of a user that speaks in a channel. For those that like tables, it looks like this:

{| class="wikitable"
! style="text-align:left;"| Eggdrop updates the account list when the...
! WHOX
! extended-join
! account-notify
! account-tag
|-
|... bot joins a channel
| style="text-align:center;" | X
|
|
|
|-
|... auth'd user joins a channel
|
| style="text-align:center;" | X
|
|
|-
|... user authenticates on a channel
|
|
| style="text-align:center;" | X
|
|-
|... auth'd user talks
|
|
|
| style="text-align:center;" | X
|}

== Use in Tcl Scripts ==
The ability to track accounts opens up a wealth of possibilities for Tcl scripts. In order to trigger Tcl script events to cover all instances where a user logs in, it is recommended to pair an ACCOUNT bind with a JOIN bind. This will allow you to check the account (if any) associated with a user as they join, as well as if they authenticate after joining.

== Imperfect Tracking ==
If the WHOX, extended-join and account-notify are not all enabled, the accuracy of the account list looks like this:

{| class="wikitable"
! style="text-align:left;"| WHOX
! account-notify
! extended-join
! account-tag
| Eggdrop properly tracks a user's account status...
|-
| style="text-align:center;" | X
|
|
|
| ... when the bot joins the channel and the user is already authenticated
|-
| style="text-align:center;" | X
| style="text-align:center;" | X
|
|
| ... when the bot joins the channel and the user is already authenticated, or the user authenticates in a common channel
|-
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | X
|
| ... all the time
|-
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | X
| ... all the time
|-
| style="text-align:center;" | X
| style="text-align:center;" | X
|
| style="text-align:center;" | X
| ... when the bot joins the channel and the user is already authenticated, or if the user authenticates in a common channel, or an authenticated user joins then talks in a common channel
|-
| style="text-align:center;" | X
|
|
| style="text-align:center;" | X
| ... when the bot joins the channel and the user is already authenticated, or once an authenticated user talks after joining
|-
| style="text-align:center;" | X
|
| style="text-align:center;" | X
| style="text-align:center;" | X
| ... when the bot joins the channel and the user is already authenticated, or if the user is authenticated before they join a common channel, or once a they join a common channel then authenticate and then talk
|-
|
| style="text-align:center;" | X
| style="text-align:center;" | X
|
| ... when a user authenticates in a common channel or an already authenticated user joins a channel
|-
| style="text-align:center;" | X
|
| style="text-align:center;" | X
|
| ... when the bot joins the channel and the user is already authenticated, or an already authenticated user joins a channel
|-
|
| style="text-align:center;" | X
|
|
| ... when a user authenticates in a common channel
|-
|
| style="text-align:center;" | X
| style="text-align:center;" | X
| style="text-align:center;" | X
| ... when an authenticated user joins a common channel, or when a user authenticates in the channel, or when a user authenticated before the bot joined talks
|-
|
| style="text-align:center;" | X
|
| style="text-align:center;" | X
| ... when a user authenticates in a common channel, or a user who authenticated before the bot joined talks
|-
|
|
| style="text-align:center;" | X
| style="text-align:center;" | X
| .. when an already authenticated user joins the channel or a user who authenticated before the bot joined talks
|-
|
|
| style="text-align:center;" | X
|
| ... when an authenticated user joins the channel
|-
|
|
|
| style="text-align:center;" | X
| ... when an authenticated user talks
|-
|}

== Example Tcl Script ==
This is an example script that allows an authenticated user to op someone via a public command

<code><pre>
bind PUB * .op acct_op

proc acct_op {nick user hand chan text} {
set accthand [finduser -a [getaccount $nick]]
if [string match $accthand ""] {
putserv "PRIVMSG $chan :You are not authenticated"
return 1
}
if {[matchattr $accthand +o|+o $chan]} {
pushmode $chan +o $text
putserv "PRIVMSG $chan :Op'ing $nick"
} else {
putserv "PRIVMSG $chan :You do not have access to .op"
}
}
</pre></code>

This is an example script that performs actions when a user authenticates or joins a channel already authenticated

<code><pre>
bind ACCOUNT * * acct_track_acct
bind JOIN * * acct_track_join

proc acct_track_acct {nick user hand chan acct} {
if {[string match $acct ""]} {
putserv "PRIVMSG $chan :$nick de-authenticated"
} else {
putserv "PRIVMSG $chan :$nick is now authenticated as $acct"
}
}

proc acct_track_join {nick user hand chan} {
set acctnick [getaccount $nick]
if {[string match $acctnick ""]} {
putserv "PRIVMSG $chan :$nick joined and is not authenticated."
} else {
putserv "PRIVMSG $chan :$nick joined and is authenticated as $acctnick"
}
}
</pre></code>

== Other Limitations ==

If the extended join capability is not enabled, Eggdrop can't check accounts when a user joins. This means handles with a +f flag that have an account, but not a matching hostmask, added will not be exempt from join flood controls and could be kicked/banned. To prevent this, you must either update the hostmask to match that of the user, or ensure Eggdrop has requested the extended join capability from the server if available.

EggModules

2024-05-04T16:45:54Z

Geo:

server.mod is anything that affects the live connection to the ircd that does not involve channels

irc.mod is anything that affects live channels and live users on channels.

channels.mod has nothing to do with the live connection and is just userfile/chanfile storage of handles and permissions and flags

the line between server.mod and irc.mod is blurry at times - for example when we receive an AWAY notification we break it down for the channel-users it triggers for, so the message itself has nothing to do with channels but we call it for each channel the user is on, so that's irc.mod. server.mod and irc.mod separation is historical, I wouldn't separate them these days. cross-module stuff is a bit annoying (as opposed to modules calling into the core) because of it, easier if you put it in the "right" spot

channels.mod is .+user, .+chan etc. channels.mod can check and do IRC stuff via server.mod/irc.mod if they are loaded but it does not require it

irc.mod requires channels.mod and server.mod. server.mod can works without channels.mod and irc.mod

EggModules

2024-05-04T16:43:04Z

Geo:

irc.mod is anything that affects live channels and live users on channels.

channels.mod has nothing to do with the live connection and is just userfile/chanfile storage of handles and permissions and flags

the line between server.mod and irc.mod is blurry at times - for example when we receive an AWAY notification we break it down for the channel-users it triggers for, so the message itself has nothing to do with channels but we call it for each channel the user is on, so that's irc.mod. server.mod and irc.mod separation is historical, I wouldn't separate them these days. cross-module stuff is a bit annoying (as opposed to modules calling into the core) because of it, easier if you put it in the "right" spot

channels.mod is .+user, .+chan etc. channels.mod can check and do IRC stuff via server.mod/irc.mod if they are loaded but it does not require it

irc.mod requires channels.mod and server.mod. server.mod can works without channels.mod and irc.mod

EggModules

2024-05-04T16:42:07Z

Geo:

irc.mod is anything that affects live channels and live users on channels.

channels.mod has nothing to do with the live connection and is just userfile/chanfile storage of handles and permissions and flags

he line between server.mod and irc.mod is blurry at times - for example when we receive an AWAY notification we break it down for the channel-users it triggers for, so the message itself has nothing to do with channels but we call it for each channel the user is on, so that's irc.mod. server.mod and irc.mod separation is historical, I wouldn't separate them these days. cross-module stuff is a bit annoying (as opposed to modules calling into the core) because of it, easier if you put it in the "right" spot

channels.mod is .+user, .+chan etc. channels.mod can check and do IRC stuff via server.mod/irc.mod if they are loaded but it does not require it

irc.mod requires channels.mod and server.mod. server.mod can works without channels.mod and irc.mod

EggModules

2024-05-04T15:40:27Z

Geo: Created page with "irc.mod is anything that affects live channels and live users on channels channels.mod has nothing to do with the live connection and is just userfile/chanfile storage of handles and permissions and flags the line between server.mod and irc.mod is blurry at times - for example when we receive an AWAY notification we break it down for the channel-users it triggers for, so the message itself has nothing to do with channels but we call it for each channel the user is on, so..."

irc.mod is anything that affects live channels and live users on channels
channels.mod has nothing to do with the live connection and is just userfile/chanfile storage of handles and permissions and flags
the line between server.mod and irc.mod is blurry at times - for example when we receive an AWAY notification we break it down for the channel-users it triggers for, so the message itself has nothing to do with channels but we call it for each channel the user is on, so that's irc.mod. server.mod and irc.mod separation is historical, I wouldn't separate them these days. cross-module stuff is a bit annoying (as opposed to modules calling into the core) because of it, easier if you put it in the "right" spot

irc.mod guarantees server.mod is loaded, but not vice versa

server.mod works without channels.mod, irc.mod requires channels.mod

channels.mod is .+user, .+chan etc.
channels.mod can check and do IRC stuff via server.mod/irc.mod if they are loaded but it does not require it

EggWiki

2024-05-04T15:39:14Z

Geo:

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/setup Installation Tutorial]

[[Do I have Tcl installed?]]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

[[Cert Val Failed| certificate validation failed: unable to get local issuer certificate ]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Connect To Partyline with TLS| How do I connect to the partyline using TLS?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

[[Inline| When compiling ancient versions of Eggdrop, I get "undefined reference to `cron_matchfld'" and other similar errors]]

== Tcl Examples ==
[[Setudef| Writing scripts that work only on selected channels]]

[[MinutelyWho| Write a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl that can access https websites]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]

[[EggModules|What is the difference between the IRC, Server, and Channel modules?]]

EggWiki

2024-05-04T15:39:02Z

Geo:

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/setup Installation Tutorial]

[[Do I have Tcl installed?]]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

[[Cert Val Failed| certificate validation failed: unable to get local issuer certificate ]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Connect To Partyline with TLS| How do I connect to the partyline using TLS?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

[[Inline| When compiling ancient versions of Eggdrop, I get "undefined reference to `cron_matchfld'" and other similar errors]]

== Tcl Examples ==
[[Setudef| Writing scripts that work only on selected channels]]

[[MinutelyWho| Write a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl that can access https websites]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]
[[EggModules|What is the difference between the IRC, Server, and Channel modules?]]

Eggdrop for Docker

2024-04-09T23:30:01Z

Geo:

Information and documentation for the Eggdrop Docker image can be found at [https://hub.docker.com/_/eggdrop https://hub.docker.com/_/eggdrop].

== Mounting Scripts into Docker ==
It can be difficult for beginners to add scripts into a Docker container. An easy way to add scripts would be to create a scripts directory on the host and mount it to /home/eggdrop/eggdrop/scripts (or the path of your choosing). This would be accomplished from the command line by adding an option similar to:

-v /path/to/host/scripts:/home/eggdrop/eggdrop/scripts

or via docker-compose:

<pre>
volumes:
- /path/to/host/scripts:/home/eggdrop/eggdrop/scripts
</pre>
...and then load the script as usual from the config file.

== Adding Tcl packages required for scripts ==

Many scripts require extra OS packages to be installed in order to function, such as tcl-tls, tcl-lib and libsqlite3-tcl. At first look, it may feel difficult to install a package required for a Tcl script since you don't (generally) have command line access. In keeping with Docker philosophy, the base Eggdrop package is intentionally packaged with only the minimal requirements needed for base Eggdrop functionality. However, users may easily add add packages when starting a container like this:

<pre>
docker run -i eggdrop sh -c 'apk add tcl-lib tcl-tls && exec /home/eggdrop/eggdrop/entrypoint.sh eggdrop.conf
</pre>

or in a docker-compose file:

<pre>
command: [ "apk add tcl-lib tcl-tls && exec /home/eggdrop/eggdrop/entrypoint.sh eggdrop.conf" ]
</pre>

== Setting a Vhost with Docker ==
We're still trying to figure out the best way to do this! One method we've found is to set the following options in your docker-compose config file:

<pre>
networks:
default:
driver: bridge
ipam:
driver: default
driver_opts:
com.docker.network.host_ipv4: <ip here>
</pre>

Importantly, do not set the vhost4 setting in the config if you use this method.

Also importantly, there are still some to-be-determined side effects for using this method, but this will atleast get you online using the vhost of your choice

Eggdrop for Docker

2024-04-09T22:59:09Z

Geo:

Information and documentation for the Eggdrop Docker image can be found at [https://hub.docker.com/_/eggdrop https://hub.docker.com/_/eggdrop].

== Setting a Vhost with Docker ==
We're still trying to figure out the best way to do this! One method we've found is to set the following options in your docker-compose config file:

<pre>
networks:
default:
driver: bridge
ipam:
driver: default
driver_opts:
com.docker.network.host_ipv4: <ip here>
</pre>

Importantly, do not set the vhost4 setting in the config if you use this method.

Also importantly, there are still some to-be-determined side effects for using this method, but this will atleast get you online using the vhost of your choice

Eggdrop for Docker

2024-04-09T22:57:03Z

Geo: Created page with "Information and documentation for the Eggdrop Docker image can be found at [https://hub.docker.com/_/eggdrop]. == Setting a Vhost with Docker == We're still trying to figure out the best way to do this! One method we've found is to set the following options in your docker-compose config file: <pre> networks: default: driver: bridge ipam: driver: default driver_opts: com.docker.network.host_ipv4: <ip here> </pre> Importantly, do not set the vh..."

Information and documentation for the Eggdrop Docker image can be found at [https://hub.docker.com/_/eggdrop].

== Setting a Vhost with Docker ==
We're still trying to figure out the best way to do this! One method we've found is to set the following options in your docker-compose config file:

<pre>
networks:
default:
driver: bridge
ipam:
driver: default
driver_opts:
com.docker.network.host_ipv4: <ip here>
</pre>

Importantly, do not set the vhost4 setting in the config if you use this method.

Also importantly, there are still some to-be-determined side effects for using this method, but this will atleast get you online using the vhost of your choice

Inline

2023-12-29T22:46:46Z

Geo:

Errors like "undefined reference to `cron_matchfld'" indicate a compatibility issue regarding Eggdrop's use of the inline keyword.

See [http://www.greenend.org.uk/rjk/tech/inline.html here] for the gory details as to why.

The fix is to use
<pre>
CFLAGS="-std=gnu89" ./configure
</pre>
instead of just
<pre>
./configure
</pre>

(you may need to do a <code>make distclean</code> prior to running this).

Inline

2023-12-29T22:46:05Z

Geo: Created page with "Errors like "undefined reference to `cron_matchfld'" indicate a compatibility issue regarding Eggdrop's use of the inline keyword. See [http://www.greenend.org.uk/rjk/tech/inline.html here] for the gory details as to why. The fix is to use <pre> CFLAGS="-std=gnu89" ./configure </pre> instead of just <pre ./configure </pre> (you may need to do a <code>make distclean</code> prior to running this)."

Errors like "undefined reference to `cron_matchfld'" indicate a compatibility issue regarding Eggdrop's use of the inline keyword.

See [http://www.greenend.org.uk/rjk/tech/inline.html here] for the gory details as to why.

The fix is to use
<pre>
CFLAGS="-std=gnu89" ./configure
</pre>
instead of just
<pre
./configure
</pre>

(you may need to do a <code>make distclean</code> prior to running this).

EggWiki

2023-12-29T22:43:14Z

Geo: /* FAQ */

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/setup Installation Tutorial]

[[Do I have Tcl installed?]]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

[[Cert Val Failed| certificate validation failed: unable to get local issuer certificate ]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Connect To Partyline with TLS| How do I connect to the partyline using TLS?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

[[Inline| When compiling ancient versions of Eggdrop, I get "undefined reference to `cron_matchfld'" and other similar errors]]

== Tcl Examples ==
[[Setudef| Writing scripts that work only on selected channels]]

[[MinutelyWho| Write a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl that can access https websites]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]

EggWiki

2023-12-29T22:42:58Z

Geo: /* FAQ */

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/setup Installation Tutorial]

[[Do I have Tcl installed?]]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

[[Cert Val Failed| certificate validation failed: unable to get local issuer certificate ]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Connect To Partyline with TLS| How do I connect to the partyline using TLS?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

[[Inline]]| When compiling ancient versions of Eggdrop, I get "undefined reference to `cron_matchfld'" and other similar errors]]

== Tcl Examples ==
[[Setudef| Writing scripts that work only on selected channels]]

[[MinutelyWho| Write a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl that can access https websites]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]

UTF-8

2023-08-12T22:59:17Z

Geo:

There are four common issues users encounter when dealing with UTF-8 encoding issues.

== Emojis don't appear ==

Perhaps the most common problem seen today is people attempting to use Unicode emojis (Thumbs up, skull and crossbones, party hats, etc), and incorrectly thinking their Eggdrop does not support any UTF-8 encoding at all. The inability to use Emojis is a result of an issue with Tcl currently (by default) not being able to support Unicode characters with control codes over 3 bytes, which means Tcl cannot handle control codes higher than U+FFFF (More information on this can be found at https://wiki.tcl-lang.org/page/Unicode+and+UTF-8). The remedy for this issue requires you to download a current version of the Tcl source from https://www.tcl.tk/software/tcltk/download.html and manually compile it (this cannot be done by intalling Tcl via a package manager such as apt or yum).

'''Step 1'''

Open the generic/tcl.h file in your editor.

Search for

<code>#define TCL_UTF_MAX 3</code>

and replace it with

<code>#define TCL_UTF_MAX 6</code>

'''Step 2'''

Follow the instructions included with the download to compile and install Tcl.

'''Step 3'''

You'll need to recompile Eggdrop, and may need to specify --with-tcllib and --with-tclinc to point to the new location you installed Tcl to. A correct ./configure command may look similar to this:

<code>
./configure --with-tclinc=/usr/local/include/tcl.h --with-tcllib=/usr/local/lib/libtcl8.6.so
</code>

== HTTP scripts output "funny" characters ==

If a script that pulls information from an HTTP source isn't outputting characters properly (letters with accents, etc, are being displayed as other incorrect characters), take a look at https://tcl.tk/man/tcl8.6/TclCmd/http.htm#M61 for an explanation, then try adding set ::http::defaultCharset utf-8 before the http request in the script.

== Locale issues ==

If you're still having issues with UTF-8, on your host machine, type locale. If it looks similar to this, congrats! you have UTF-8 support and Eggdrop should be able to handle non-Emoji unicode characters.

<pre>
LANG=en_US.UTF-8
LANGUAGE=
LC_CTYPE="en_US.UTF-8"
LC_NUMERIC="en_US.UTF-8"
LC_TIME="en_US.UTF-8"
LC_COLLATE="en_US.UTF-8"
LC_MONETARY="en_US.UTF-8"
LC_MESSAGES="en_US.UTF-8"
LC_PAPER="en_US.UTF-8"
LC_NAME="en_US.UTF-8"
LC_ADDRESS="en_US.UTF-8"
LC_TELEPHONE="en_US.UTF-8"
LC_MEASUREMENT="en_US.UTF-8"
LC_IDENTIFICATION="en_US.UTF-8"
LC_ALL=
</pre>

If it does *not* look like that (specifically, the LANG variable does not end in UTF-8, then you can change your locale to one that supports UTF-8, and Eggdrop will pick up on that change. To do this:

'''Step 1'''

Visit https://help.ubuntu.com/community/Locale (or a similar page for the OS flavor of your choice). In short, you'll want to view the locales available on your system by running

<code>
locale -a
</code>

and find the UTF-8 setting that matches your preferred language. Open the /etc/default/locale file in your editor.

Search for

<code>
LANG=<something>
</code>

and replace it with

<code>
LANG=de_EN.UTF-8
</code>

or, obviously, whichever language makes sense to use for you.

'''Step 2'''

Recompile Eggdrop.

If you are still having issues after making these changes, re-read the Emojis section.

== UTF-8 not found on system ==

If the locale trick does not work, or you are on a system that does not have a UTF locale pack (or you are unable to install one), you can try to force UTF-8 by doing the following.

'''Step 1'''

Open the eggdrop1.9.2/src/tcl.c file in your editor.

Search for (around line 650)

<pre>
if (encoding == NULL) {
encoding = "iso8859-1";
}
</pre>

and insert the following right after it

<code>
encoding = "utf-8";
</code>

'''Step 2'''

Recompile Eggdrop.

== How can I check what encoding is set? ==
* If you have the .tcl command enabled, you can run
<pre>
.tcl encoding system
</pre> to check what encoding Tcl is trying to use

Connect To Partyline with TLS

2023-07-09T21:09:30Z

Geo: /* Connect with TLS */

== Create a TLS Listen Port ==

To connect to the partyline using TLS, you must first ensure you created a listening port that uses TLS (in the config). This is done by specifying a '+' in front of the port specified in the config.

<pre>
listen 1.2.3.4 +4444 all
</pre>

== Create TLS certificates ==
Next, you must ensure you have TLS certificates to use. If you don't have a pair already, you can generate self-signed certificates from a terminal by running:
<pre>
openssl req -new -x509 -nodes -keyout my.key -out my.crt
</pre>

== Connect with TLS ==
Then, you must use a client capable of TLS connections (No, telnet is not one of them!) A common method is using the OpenSSL 'sclient' program. To connect from a host with OpenSSL installed, use:
<pre>
openssl s_client -cert my.crt -key my.key -connect host:sslport
</pre>
(Don't use a + in front of the port here, just the number)

Connect To Partyline with TLS

2023-07-09T21:09:02Z

Geo: Created page with "== Create a TLS Listen Port == To connect to the partyline using TLS, you must first ensure you created a listening port that uses TLS (in the config). This is done by specifying a '+' in front of the port specified in the config. <pre> listen 1.2.3.4 +4444 all </pre> == Create TLS certificates == Next, you must ensure you have TLS certificates to use. If you don't have a pair already, you can generate self-signed certificates from a terminal by running: <pre> openss..."

== Create a TLS Listen Port ==

To connect to the partyline using TLS, you must first ensure you created a listening port that uses TLS (in the config). This is done by specifying a '+' in front of the port specified in the config.

<pre>
listen 1.2.3.4 +4444 all
</pre>

== Create TLS certificates ==
Next, you must ensure you have TLS certificates to use. If you don't have a pair already, you can generate self-signed certificates from a terminal by running:
<pre>
openssl req -new -x509 -nodes -keyout my.key -out my.crt
</pre>

== Connect with TLS ==
Then, you must use a client capable of TLS connections (No, telnet is not one of them!) A common method is using the OpenSSL 'sclient' program. To connect from a host with OpenSSL installed, use:
<pre>
openssl s_client -cert my.crt -key my.key -connect host:sslport (Don't use a + in front of the port here, just the number)
</pre>

EggWiki

2023-07-09T21:02:20Z

Geo: /* FAQ */

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/setup Installation Tutorial]

[[Do I have Tcl installed?]]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

[[Cert Val Failed| certificate validation failed: unable to get local issuer certificate ]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Connect To Partyline with TLS| How do I connect to the partyline using TLS?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

== Tcl Examples ==
[[Setudef| Writing scripts that work only on selected channels]]

[[MinutelyWho| Write a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl that can access https websites]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]

Cert Val Failed

2023-07-09T19:02:39Z

Geo: Geo moved page Cert Val Failed to Certificate Validation Failed

#REDIRECT [[Certificate Validation Failed]]

Certificate Validation Failed

2023-07-09T19:02:39Z

Geo: Geo moved page Cert Val Failed to Certificate Validation Failed

With some servers, you may see an error that looks like this (debug log enabled):

<pre>
[21:57:55] TLS: certificate validation failed at depth 2: unable to get local issuer certificate
[21:57:55] TLS: alert during write: fatal (unknown CA).
[21:57:55] TLS: awaiting more writes
[21:57:55] TLS: handshake failed due to the following error: certificate verify failed
[21:57:55] TLS: handshake failed due to the following errors:
[21:57:55] TLS: error:0A000086:SSL routines::certificate verify failed
</pre>

The exact cause or server misconfiguration is still unknown, but if you see this error, ensure you have set your local CA path in the config correctly:

<pre>
set ssl-capath /etc/ssl/certs
</pre>

Certificate Validation Failed

2023-07-09T19:01:12Z

Geo: Created page with "With some servers, you may see an error that looks like this (debug log enabled): <pre> [21:57:55] TLS: certificate validation failed at depth 2: unable to get local issuer certificate [21:57:55] TLS: alert during write: fatal (unknown CA)...."

EggWiki

2023-07-09T18:58:11Z

Geo: /* Common Errors */

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/setup Installation Tutorial]

[[Do I have Tcl installed?]]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

[[Cert Val Failed| certificate validation failed: unable to get local issuer certificate ]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

== Tcl Examples ==
[[Setudef| Writing scripts that work only on selected channels]]

[[MinutelyWho| Write a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl that can access https websites]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]

Config Changes

2023-04-09T01:40:26Z

Geo:

== Config changes made in 1.9.0 ==
* Added additional net-types for freenode, Quakenet, and Rizon (net-type)
<pre>
## What is your network?
## Options are:
## EFnet
## IRCnet
## Undernet
## DALnet
## Libera
## freenode
## QuakeNet
## Rizon
## Twitch (This requires twitch.mod to be loaded as well)
## Other (This is a good, sane default option to use if your network/ircd is
## not listed here. Additional configuration options for this setting
## can be found further down in the IRC MODULE section)
set net-type "EFnet"
</pre>
* Added SASL configuration settings
<pre>
#### CAP Features ####
# This section controls IRCv3 capabilities supported natively by Eggdrop. You
# can enable individual settings here to be requested as part of the
# registration process with the IRC server. Not all servers support all CAP
# features. https://ircv3.net/support/networks.html maintains a list of some
# popular servers, and you can also use '.tcl cap available' from the partyline
# to list capabilities available on that server.
# SASL is a method that allows Eggdrop to authenticate with a NickServ service
# as part of the connection process to a server, eliminating the need to later
# authenticate via a /msg command.
#
# To request SASL authentication via CAP, set this to 1
#set sasl 0
# Set SASL mechanism to authenticate with.
# Options are:
# 0 = PLAIN (normal user/pass exchange, only encrypted
# if connected to the IRC server with a
# SSL/TLS connection)
#
# 1 = ECDSA-NIST256P-CHALLENGE (Uses a certificate; usually requires a
# public key to be registered with NickServ
# or other similar service. Set certificate
# to use in sasl-ecdsa-key setting below)
#
# 2 = EXTERNAL (Some other method you set up. Certificates
# used are defined in ssl-certificate and
# ssl-privatekey settings in SSL section)
#
#set sasl-mechanism 0
# Set username to authenticate to IRC NickServ with
#set sasl-username "llamabot"
# Set password to authenticate to IRC NickServ with
#set sasl-password "password"
# Specify the location of certificate to use for the SASL
# ecdsa-nist256p-challenge. An ECDSA certificate can be generated with the
# command:
# openssl ecparam -genkey -name prime256v1 -out eggdrop-ecdsa.pem
#set sasl-ecdsa-key "eggdrop-ecdsa.pem"
# Set SASL failure action
# If SASL authentication fails, do you want to connect to the server anyway?
# Set to this to 0 to disconnect and retry until success, or 1 to continue
# connecting to the server without SASL authentication.
#set sasl-continue 1
#
# Timeout (in seconds) before giving up SASL authentication
#set sasl-timeout 15
</pre>
* Added ability to choose specific SSL/TLS protocols to use (ssl-protocols)
<pre>
# Specify the list of protocols allowed for use with ssl. The protocol list is
# one or more protocol strings separated by spaces. Available protocols are
# SSLv2, SSLv3, TLSv1, TLSv1.1, TLSv1.2, TLSv1.3.
# set ssl-protocols "TLSv1 TLSv1.1 TLSv1.2 TLSv1.3"
</pre>
* Added ability to allow bots to remain linked if userfile sharing fails (sharefail-unlink)
<pre>
# By default, Eggdrop will abort the linking process if userfile sharing is
# enabled but the userfile transfer fails. Set this to 0 to keep the bots
# linked if the userfile transfer fails and retry every minute (both bots must
# be v1.9.0 or higher).
#set sharefail-unlink 1
</pre>
* Changed the method Eggdrop uses to add servers from a {} list to the new addserver command
<pre>
# This is the bot's server list. The bot will start at the first server listed,
# and cycle through them whenever it gets disconnected. You need to change these
# servers to YOUR network's servers.
#
# The format is:
# server add <server> [port [password]]
# Prefix the port with a plus sign to attempt a SSL connection:
# server add <server> +port [password]
#
# This format is new as of version 1.9.0. The previous method using
# set servers {} will still work for now, but is deprecated and will be removed
# in a future release.
server add you.need.to.change.this 6667
server add another.example.com 6669 password
server add 2001:db8:618:5c0:263:: 6669 password
server add ssl.example.net +7000
</pre>
* Added CAP settings
<pre>
# To request the account-notify feature via CAP, set this to 1
#set account-notify 0
# To request the invite-notify feature via CAP, set this to 1
#set invite-notify 0
# To request the message-tags feature via CAP, set this to 1. NOTE: Enabling
# this feature may interfere with RAW binds in scripts.
#set message-tags 0
# If you have any additional CAP features you would like to request at
# registration but are not listed above, set them here as space separated
# strings. Setting features here does not guarantee Eggdrop's ability to support
# these them.
#set cap-request "feature1 feature2 feature3"
</pre>
* Removed the listen-addr command. The listen command now accepts an optional IP argument in lieu of using listen-addr
<pre>
# To bind the listening port to a specific IP instead of all available, insert
# a valid IP assigned to the host Eggdrop is running on infront of the port
# (this replaces the listen-addr setting used prior to Eggdrop v1.9)
#
# listen 1.2.3.4 3333 all
</pre>
* Added the show-uname setting, which allows you to disable the display of uname info for the host system in things like .status
<pre>
# Disable this setting if you do not want to show name and release level of the
# operating system. You'll probably also want to edit the default motd (in
# text/motd) and remove its display from there.
set show-uname 1
</pre>

== Config changes made in 1.9.1 ==
* Added Libera to accepted server types

== Config changes made in 1.9.2 ==
* Added the 'extended-join' setting, to enable the extended-join CAP capability
<pre>
# To request the account-notify feature via CAP, set this to 1
#set extended-join 0
</pre>
* Moved DNS-related settings out of the modules section and into the core config area
* No longer load the (now-deprecated) DNS module by default

== Config changes made in 1.9.3 ==
* None.

== Config changes made in 1.9.4 ==
* None.

== Config changes made in 1.9.5 ==
* None.

Do I have Tcl installed?

2023-03-06T00:28:17Z

Geo: Created page with "To compile the bot you need the TCL libraries and header somewhere on your system. The ./configure script will try to find them for you. If this fails, you might try to search them on your own. The library is called libtclX.X.so or libtclX.X.a. The "X.X" will be the version of the library. The extension '.so' means it is a "dynamically loadable library" and the '.a' mean it will be "statically linked". You can try to find it using find /usr -name "libtcl*" -print Th..."

To compile the bot you need the TCL libraries and header somewhere on your system. The ./configure script will try to find them for you. If this fails, you might try to search them on your own.

The library is called libtclX.X.so or libtclX.X.a. The "X.X" will be the version of the library. The extension '.so' means it is a "dynamically loadable library" and the '.a' mean it will be "statically linked". You can try to find it using
find /usr -name "libtcl*" -print This can take a HUGE amount of time.
Do the same to find the header file
find /usr -name "tcl.h" -print

EggWiki

2023-03-06T00:27:26Z

Geo: /* Setting Up Eggdrop */

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/setup Installation Tutorial]

[[Do I have Tcl installed?]]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

== Tcl Examples ==
[[Setudef| Writing scripts that work only on selected channels]]

[[MinutelyWho| Write a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl that can access https websites]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]

Compiling

2023-03-06T00:26:52Z

Geo: Created page with "== What do I need to apply a .patch file to the eggdrop's source? == You need to make sure you have the 'patch' utility, and that it is at least version 2.1. patch -v to find this out. == How do I apply a patch to my source? == Make sure that you are applying the patch file to the correct version of eggdrop. 'gzip -d' the .patch file, if it ends with .gz Enter your eggdrop's source root directory and apply the patch with patch -p1 < eggdrop1.3.xx+demo.patc..."

== What do I need to apply a .patch file to the eggdrop's source? ==

You need to make sure you have the 'patch' utility, and that it is at least version 2.1.

patch -v

to find this out.

== How do I apply a patch to my source? ==

Make sure that you are applying the patch file to the correct version of eggdrop. 'gzip -d' the .patch file, if it ends with .gz Enter your eggdrop's source root directory and apply the patch with

patch -p1 < eggdrop1.3.xx+demo.patch

Find things that might have gone wrong: find . -name "*.rej" -print

If the patch utility asked you about "What file to patch", then you probably do not have the correct version of the patch utility. If you do, then it also may be that you are trying to apply the patch file to an incorrect version of eggdrop. Make sure the eggdrop source you have match the version of the patch file you are trying to apply.

== What kind of shell am I using? ==

For some things you do on your shell account you need to know what kind of shell you are using. The easiest way is to type
echo $SHELL
If this does not work, use 'ps' and see what processes are running. Find the one that starts with a dash '-', this is probably your login shell.

This shell can be: sh, bash, ksh, csh or tcsh (or others...).

== Where can i get a precompiled eggdrop for my computer? ==

It is HIGHLY recommended AGAINST using precompiled Eggdrops from untrusted sources. Eggdrop has been a regular target for hacking and crashing. Distribution of precompiled (binary) versions of Eggdrop are the easiest way of hackers to provide you with the easiest (and most dangerous) way of gaining access to not only your bot, but to your computer account directly. Don't advertise your precompiled Eggdrop binary sites on the Eggdrop list either =P

== I get 'Makefile:3 :invalid operator' or some-such-thing when I try to 'make' ==

Try 'gmake' instead of make

EggWiki

2023-03-06T00:21:36Z

Geo: /* Setting Up Eggdrop */

Welcome to EggWiki!

== Setting Up Eggdrop ==
[https://docs.eggheads.org/setup Installation Tutorial]

[[Installing Tcl Locally]]

[[Running_Multiple_Eggdrops_From_One_Directory|Running Multiple Eggdrops From One Directory]]

[[Upgrading]]

* [[Config_Changes|Config file changes, by version]]

[[Compiling|Compiling FAQs]]

== Using Eggdrop ==
[[Partyline]]

[[DCC]]

[[Channel_Administration|Channel Administration]]

[[Loading Tcl Scripts]]

[[CAP|Enabling CAP (IRCv3) Extensions]]

[[Account Tracking]]

== Common Errors ==

[[Tcl Not Installed]]

[[No Telnet Port Set]]

[[Known Eggdrop Errors]]

[[Matchattr Tcl Command Issues]]

[[Not Sharing Userfile | User file rejected by <bot>: Not sharing userfile]]

== FAQ ==

[[Eggdrop_Startup_Errors| Why won't my Eggdrop start?]]

[[NickServ| How do I authenticate to NickServ?]]

[[Bot Auto Op| How do I make my Eggdrops securely op each other?]]

[[Dynamic_Bans| How do I stop Eggdrop from removing bans?]]

[[Hostmasks]]

[[UTF-8]]

[[Threaded DNS]]

[[Timer_Drift| What does "timer drift - spun X minutes" mean?]]

[[Tcl| What is Tcl?]]

[[TermSignal| Eggdrop quit, and the last entry says "Received Terminal Signal"]]

[[PBKDF2_transition| How should I upgrade to PBKDF2 hashing from Blowfish? (1.9.0+)]]

== Tcl Examples ==
[[Setudef| Writing scripts that work only on selected channels]]

[[MinutelyWho| Write a script that performs a /who on all channels]]

[[EndOfWho| Writing a bind that triggers at the end of a 315 message (WHO listing)]]

[[TclHTTPS| Writing a Tcl that can access https websites]]

== Eggdrop Mechanics ==
This is a really technical section dedicated to what is happening under the covers... you probably will never need this information, but its good to have it documented somewhere!

[[EggdropRecords|How Eggdrop tracks users]]

TclHTTPS

2023-02-05T22:24:27Z

Geo:

The http package is a common package required by Tcl scripts that need to connect to websites. However, the "default" commands don't make it easy to understand how to connect to an https website instead of an http website, and will often generate an error if the user tries to do so. Below is an example of how to do so.

NOTE: You have to install both the http AND tls Tcl libraries on the host for this to work- on Debian-based systems, this is done by an administrator running <code>sudo apt-get install tcl-tls</code>. The http package comes standard with Tcl; you shouldn't need to install it separately.

To connect to a webpage and display its contents, you can use the following code example:

<pre>
package require http
package require tls

http::register https 443 [list ::tls::socket -autoservername true]
catch {set req [http::geturl https://my.secure.site/ -timeout 10000]} error
set status [http::status $req]
if {$status != "ok"} {
putlog "HTTP request error: $error"
return
}
putlog [http::data $req]
</pre>

TclHTTPS

2023-02-05T22:23:43Z

Geo: Created page with "The http package is a common package required by Tcl scripts that need to connect to websites. However, the "default" commands don't make it easy to understand how to connect to an https website instead of an http website, and will often generate an error if the user tries to do so. Below is an example of how to do so. NOTE: You have to install both the http AND tls Tcl libraries on the host for this to work- on Debian-based systems, this is done by an administrator run..."

The http package is a common package required by Tcl scripts that need to connect to websites. However, the "default" commands don't make it easy to understand how to connect to an https website instead of an http website, and will often generate an error if the user tries to do so. Below is an example of how to do so.

NOTE: You have to install both the http AND tls Tcl libraries on the host for this to work- on Debian-based systems, this is done by an administrator running <code>sudo apt-get install tcl-tls</code>. The http package comes standard with Tcl; you shouldn't need to install it separately.

To connect to a webpage and display its contents, you can use the following code example:
<code>
package require http
package require tls

http::register https 443 [list ::tls::socket -autoservername true]
catch {set req [http::geturl https://my.secure.site/ -timeout 10000]} error
set status [http::status $req]
if {$status != "ok"} {
putlog "HTTP request error: $error"
return
}
putlog [http::data $req]
</code>