Howto: Fast configuration of ircd.fwsd

Open ircd.fwsd in either config or notepad

1. ircd.fwsd
This is how the configuration file is parsed (syntax):

# comment
everything u write here will not be treated as configuration

LINE parameters
Adds a spesific line, f.ex a KLINE (server ban) or a listen port

FWSBOT=
special variable, for some critical functions of the IRCd. The IRCd will not start
if these lines are invalid. These arent added to the internal variable library.

variable=test
Adds a variable with the value 'test' to the internal variable library
For setting values like nick length, strings like "is an IRC Operator" and everything else
the not set by lines or the special variables.

2. Configuration

a) PORT lines: Client and server listening ports
PORT U 6667 0.0.0.0
SERVERPORT H 4400 0.0.0.0

The first line makes a port listening on 0.0.0.0 (all local IPs), port 6667
And it is not hidden (U)
The second line makes a port for servers listening on all local IPs, port 4400
And it is hidden for normal clients (H)

b) YLINE lines: Client classes
An Y-line allows a client matching the nick!user@host with the correct password to login
if theres not too many of that client-class. He can also get his spoof/vhost from Y-lines.
The first Y-line to allow him to login will be the definitive line, so keep the spoofs above
the big Y-lines.

YLINE *!*@127.0.0.1 3 %server% :
YLINE *!*@* 5000 . :

The first line spoofs clients from 127.0.0.1 to %server% wether they use password or not
(last parameter is empty), but there cant be more than 3 clients online with the IP 127.0.0.1
at the same time, or this Y-line will not work for 127.0.0.1 clients, and the next line is checked.
The last line allows everyone wether a passord is given or not, as long as there isnt 5000 with the
host/IP * online already. The line doesnt change anyones host since its length is < 2.

c) OPER lines: IRC Operator user/pass logins
OPER *!*@irc.fwsnet.net oswcAmj14NMKTHWGb local lqvx
Note: Oper pass is encrypted.
By using Password.exe and encrypting the string 'host' you get 'lqvx.'
Therefore, the oper command would typically be /oper local host.

Allows clients to use the /oper command and receive special usermodes.
The line above allows a client with the (v)host irc.fwsnet.net to /oper local host
and receive the ultimate amount of usermodes: oswcAmj14NMKTHWGb
Pretty simple huh?

d) ACHAN lines: Admin/Serverbot channels
ACHAN FWS nt :-=4/Flash12\Ware/3Studios\=-

The serverbot creates these channels on startup and sets the appropriate modes and topic.
In this case the channels name is #fws, the modes are +nt and the topic will be
-=4/Flash12\Ware/3Studios\=-.

e) Servername, servertag and the serverbot
SERVER=irc.fwsnet.net
SERVERTAG=FWSnet Test Server
FWSBOT=FWSNET
servernum=1

FWSBOT=nick sets the serverbots nickname, which also can be changed after startup.
If you are linking with somebody, the servernames, servernum's and serverbots nick need to be
different from all the other servers you are linking with!
servernum is used when linking IRCd's. Must be a unique number on the network.

f) admin variables: IRCd Admin info
admin1=Location: Someplace, Somecountry
admin2=Admin: MyName, ThaGroup
admin3=Email: fws@fwsnet.net

Sets the /admin info for the IRCd.

g) Start the IRCd. :)
Notes:
Invalid lines will not be used and/or shown.
Invalid special variables will make the IRCd unable to start, and a file is generated: fwsderr.txt

Last updated: 07.10.04