1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!-- $Id: mod-server.html,v 1.41 2010/01/10 22:28:57 pseudo Exp $ -->
<html>
<head>
<title>Eggdrop Documentation: Server Module</title>
</head>
<body>
<div align="center">
<p><strong>Server Module</strong></p>
</div>
<hr>
<p>The server module allows the bot to connect to an IRC server.</p>
<blockquote>
<ol>
<li><a href="#config">Config file settings</a></li>
</ol>
</blockquote>
<hr>
<p><a name="config"></a>1. <strong>Config file settings</strong></p>
<blockquote>
<p>This module provides the core server support. You have to load this
if you want your bot to come on IRC.<br>
</p>
<p>Put this line into your Eggdrop configuration file to load the
server module:</p>
<p><strong>loadmodule server</strong></p>
<p>There are also some variables you can set in your config
file:</p>
</blockquote>
<blockquote>
<dl>
<dt><strong>set net-type 0</strong></dt>
<dd>
<p>What is your network?</p>
<p>0 = Efnet<br>
1 = IRCnet<br>
2 = Undernet<br>
3 = Dalnet<br>
4 = +e/+I/max-bans 20 Hybrid<br>
5 = Others</p>
</dd>
<dt><strong>set nick "LamestBot"</strong></dt>
<dd>
<p>Set the nick the bot uses on IRC, and on the botnet unless
you specify a separate botnet-nick, here.</p>
</dd>
<dt><strong>set altnick "LamestBot"</strong></dt>
<dd>
<p>Set the alternative nick which the bot uses on IRC if the nick
specified by 'set nick' is unavailable. All '?'
characters will be replaced by random numbers.</p>
</dd>
<dt><strong>set keep-nick 1</strong></dt>
<dd>
<p>This setting makes the bot try to get his original nickname back
if its primary nickname is already in use.</p>
</dd>
<dt><strong>set realname "/msg LamestBot hello"</strong></dt>
<dd>
<p>Set here what to display in the real-name field for the bot.</p>
</dd>
<dt>
<p>
<strong>bind evnt - init-server evnt:init_server</strong><br>
<strong>proc evnt:init_server {type} {</strong><br>
<strong> global botnick</strong><br>
<strong> putquick "MODE $botnick +i-ws"</strong><br>
<strong>}</strong>
</p>
</dt>
<dd>
<p>This is a Tcl script to be run immediately after connecting to a
server.</p>
</dd>
<dt><strong>set init-server { putserv "MODE $botnick +i-ws"
}</strong></dt>
<dd>
<p>This is a Tcl script to be run immediately after connecting to a
server. It is limited to 120 characters, and is depriciated due to
the EVNT bind (see <a href="tcl-commands.html">Tcl Commands</a>).</p>
</dd>
<dt><strong>set connect-server { putlog "Connecting to
server." }</strong></dt>
<dd>
<p>This is a Tcl script to be run immediately before connecting to a
server. It is limited to 120 characters, and is depriciated due to
the EVNT bind (see <a href="tcl-commands.html">Tcl Commands</a>).</p>
</dd>
<dt><strong>set disconnect-server { putlog "Disconnected from
server." }</strong></dt>
<dd>
<p>This is a Tcl script to be run immediately after disconnecting
from a server. It is limited to 120 characters, and is depriciated
due to the EVNT bind (see <a href="tcl-commands.html">Tcl
Commands</a>).</p>
</dd>
<dt><strong>set servers {</strong></dt>
<pre>
you.need.to.change.this:6667
another.example.com:7000:password
</pre>
<p><strong>}</strong></p>
<dd>
<p>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.</p>
<p>For example:</p>
<p>set servers {<br>
irc.netw.ork<br>
irc.krow.ten:6668<br>
}</p>
<p>The format is: server[:port[:password]]</p>
<p>Both the port and password fields are optional; however, if you
want to set a password you must also set a port. If a port isn't
specified it will default to your default-port setting..</p>
</dd>
<dt><strong>set default-port 6667</strong></dt>
<dd>
<p>Set the default port which should be used if none is specified
with '.jump' or in 'set servers'.</p>
</dd>
<dt><strong>set msg-rate 2</strong></dt>
<dd>
<p>Number of seconds to wait between transmitting queued lines to
the server. Lower this value at your own risk. ircd is known to
start flood control at 512 bytes/2 seconds.</p>
</dd>
<dt><strong>set server-cycle-wait 60</strong></dt>
<dd>
<p>This setting defines how long Eggdrop should wait before moving
from one server to another on disconnect. If you set 0 here,
Eggdrop will not wait at all and will connect instantly. Setting
this too low could result in your bot being K:Lined.</p>
</dd>
<dt><strong>set never-give-up 1</strong></dt>
<dd>
<p>This settings makes the bot cycle forever through the server
list until it successfully connects to one.</p>
</dd>
<dt><strong>set server-timeout 60</strong></dt>
<dd>
<p>Set here how long Eggdrop should wait for a response when
connecting to a server before giving up and moving on to next
server.</p>
</dd>
<dt><strong>set servlimit 0</strong></dt>
<dd>
<p>If the number of servers on the net gets below this number,
the bot will jump to a new server (it will assume it's on the
losing end of a netsplit). Set this to 0 to turn off. If your
bot is running on any major IRC network, this should probably
be turned off.</p>
</dd>
<dt><strong>set check-stoned 1</strong></dt>
<dd>
<p>Set this to 1 if Eggdrop should check for stoned servers? (where
the server connection has died, but Eggdrop hasn't been notified
yet).</p>
</dd>
<dt><strong>set serverror-quit 1</strong></dt>
<dd>
<p>If you want your bot to exit the server if it receives an
ERROR message, set this to 1.</p>
</dd>
<dt><strong>set max-queue-msg 300</strong></dt>
<dd>
<p>Set here the maximum number of lines to queue to the server.
If you're going to dump large chunks of text to people over IRC,
you will probably want to raise this. 300 is fine for most people
though.</p>
</dd>
<dt><strong>set raw-log 0</strong></dt>
<dd>
<p>This setting allows you the logging of raw incoming server
traffic via console/log flag 'r', raw outgoing server
traffic via console/log mode 'v', raw botnet traffic via
console/log mode 't', and raw share traffic via console/log
mode 'h'. These flags can create a large security hole,
allowing people to see user passwords. This is now restricted to +n
users only. Please choose your owners with care.</p>
</dd>
<dt><strong>set quiet-reject 1</strong></dt>
<dd>
<p>This setting makes the bot squelch the error message when
rejecting a DCC CHAT, SEND or message command. Normally,
Eggdrop notifies the user that the command has been rejected
because they don't have access. Note that sometimes IRC
server operators detect bots that way.</p>
</dd>
<dt><strong>set flood-msg 5:60</strong></dt>
<dd>
<p>Set here how many msgs in how many seconds from one host
constitutes a flood. If you set this to 0:0, msg flood protection
will be disabled.</p>
</dd>
<dt><strong>set flood-ctcp 3:60</strong></dt>
<dd>
<p>Set here how many ctcps in how many seconds from one host are
recognized as a flood. Not specifying or using number = 0
will not check against ctcp floods.</p>
</dd>
<dt><strong>set answer-ctcp 3</strong></dt>
<dd>
<p>Set how many ctcps should be answered at once here.</p>
</dd>
<dt><strong>set lowercase-ctcp 0</strong></dt>
<dd>
<p>If you want your bot to answer lower case ctcp requests (non
rfc-compliant), set this setting to 1. mIRC will do this, most
other clients will not.</p>
</dd>
<dt><strong>set trigger-on-ignore 0</strong></dt>
<dd>
<p>If you want Eggdrop to trigger binds for ignored users, set
this to 1.</p>
</dd>
<dt><strong>set exclusive-binds 0</strong></dt>
<dd>
<p>This setting configures PUBM and MSGM binds to be exclusive
of PUB and MSG binds. This means if a MSGM bind with the mask
"*help*" exists and is triggered, any MSG bindings
with "help" in their mask will not be triggered.
Don't enable this unless you know what you are doing!</p>
</dd>
<dt><strong>set double-mode 0</strong></dt>
<dd>
<p>Allow identical messages in the mode queue?</p>
</dd>
<dt><strong>set double-server 0</strong></dt>
<dd>
<p>Allow identical messages in the server queue?</p>
</dd>
<dt><strong>set double-help 0</strong></dt>
<dd>
<p>Allow identical messages in the help queue?</p>
</dd>
<dt><strong>set use-penalties 1</strong></dt>
<dt>(default on net-type 1)</dt>
<dd>
<p>This enables Eggdrop's penalty calculation. Every command
Eggdrop sends to the IRC server raises it's penalty points.
If Eggdrop reaches a server limit, it gets disconnected with
"excess flood" message. Eggdrop is able to count internal
those penalty points, too and take measures against excess flooding.
Note: it's highly advised to turn this on!</p>
</dd>
<dt><strong>set optimize-kicks 1</strong></dt>
<dd>
<p>This optimizes the kick queue. It also traces nick changes
and parts in the channel and changes the kick queue accordingly.
There are three different options for this setting:</p>
<p>0 = Turn it off.<br>
1 = Optimize the kick queue by summarizing kicks.<br>
2 = Trace nick changes and parts on the channel and change
the queue accordingly. For example, bot will not try to kick
users who have already parted the channel.</p>
</dd>
</dl>
</blockquote>
<blockquote>
<p>There are more settings for 'net-type' 5.</p>
<p><strong>Use this settings only if you set 'net-type' to
5!</strong></p>
</blockquote>
<blockquote>
<dl>
<dt><strong>set check-mode-r 1</strong></dt>
<dd>
<p>This settings defines how umode +r is understood by Eggdrop.
Some networks use +r to indicate a restricted connection. If this
is your case, and you want your bot to leave restricted servers
and jump to the next server on its list, then set it to 1. Please
note, this setting is automatically set to 0 for net-type 0/2/3/4,
and set to 1 for net-type 1.</p>
</dd>
<dt><strong>set nick-len 9</strong></dt>
<dd>
<p>This setting allows you to specify the maximum nick-length
supported by your network. The default setting is 9. The
maximum supported length by Eggdrop is 32.</p>
</dd>
</dl>
</blockquote>
<hr>
<p><em>Copyright © 1997 Robey Pointer<br>
Copyright © 1999 - 2010 Eggheads Development Team
<a href="http://www.eggheads.org/"> Eggheads Development Team</a></em></p>
</body>
</html>
|