[GENERAL (how to use)]
CAUTION: do not change the section headers! (those written in [brackets]) Do not remove the numbers in front of the message lines!
This file (custom.txt) can also be edited with any text editor!
version=2.0+


SECTIONS:
------------------
- predefs: Define your own tags here. Color tags must have the syntax <c..>=foreground,background
- channel messages: Contains messages that go to whole channels.
- user messages: Contains messages that go to single users.
- listfile header: Will be placed at the beginning of your file list. Add as many lines as you want, but don't forget the line numbers!


MEANING OF THE MESSAGES:
-------------------------------------------------
Each of the message numbers has its special associated event.

channel messages:
-----------------------------
NOTE: The channel messages don't contain the /msg #channel command, as they are generated by the program.
1, 2: not in use (reserved)
3: Send finished.
4: Send interrupted
5: not in use
6 to 15: Advertising messages.  They are chosen randomly. If you don't want 10 different ones, just make them equal :-)
16: Play message.

user messages:
------------------------
NOTE: the user messages contain the full command (/msg <ToNick>  - lets a private message window pop up at the remote computer. /notice <ToNick> - no separate window)
1: Message that goes with a send without queue. ("Look, here comes your file!")
2: Message with a send when it was in the queue. ("After waiting 10 minutes, there we go!")
3: Message with a manual send. ("Look what a fellow I am, I send you file XY by hand!")
4: Duplicate request, file already sending. ("You know, I realized your request the first time, believe it or not!")
5: Request added to queue. ("Sorry you'll have to wait a bit. I don't have a T1.")
6: Duplicate request, file already in the queue. (may contain a hint for the @nick-que command)
7: Max. queue per user reached. ("Sorry, but I only allow 2 que entries.")
8: Queue full. ("I'm smokin'. Plz try another user!")
9: File not found. ("Learn reading and writing, and get my new list!")
10: Send is disabled. ("I'm not sending right now coz I leave in a few minutes!")
11: @nick-que answer ("File XY has been waiting for 50 minutes and is still only number 97 of 100!")
12: @nick-que concluding line. "That makes a complete of 2 files you have in my queue")
13: No files in the queue. ("You don't have files in my queue!")
14: @nick-remove reply. ("Que entry XY has been killed without remainder.")
15: @find reply ("Found file: XY") (Note: please don't use color tags leading or following the !<MyNick> file part)
16: @find - too many files found ("I have some of it but I won't tell you, go get my list!")
17: Send complete. ("Thanks, you're a successful leecher and get a number now!")
18: special mIRC "private message window" message, part 1. ("I don't accept your request in private message windows. Turn that off!")
19: part two of the above (cause the message can be very long)
20: @find reply: number of files found.


TAGS:
----------
Use "tags" in this file to represent variable values. they will be replaced by the program. Write tags without spaces, in sharp <brackets>.  Not case sensitive.
<ToNick>  the nick which the message goes to
<MyNick>  your own nick
<TotMB>  sum of your file sizes, in MegaBytes (format: 0.00)
<TotFiles>  number of files you offer
<SentFull>  number of complete sends you made
<SentBroken>  number if incomplete sends you made.
<SentPercent>  percent completion of the last send.
<SentCPS>  speed (bytes per second) of the last send
<FileName>  name of the file assotiated with the message
<FileSizeMB>  size of the file in Megabytes (format: 0.00)
<PlayTime>   length of an audio file (minutes:seconds) (format: mm:ss)
<FileKbps>  bitrate if an audio file
<FileKHz>  sample rate of an audio file
<FileMode>  audio mode (mono/stere etc.)
<TimesSent>  times this file has been sent
<CurrSends>  number of sends you currently have
<AvailSends>  number of send slots you have available
<MaxSends>  maximum of sends you make simultaneously
<CurrQueue>  number of currently queued requests
<AvailQueue>  number of queue places you have available
<MaxQueue>  maximum of queue entries you make
<QueuePos>  position of a request in the queue (@nick-que reply)
<QueueFiles>  number of requests a single user has in your queue (@nick-que reply)
<QueuePerUser>  max. number of queue positions a single user can take
<CurrDate>  current date (format: YYYY/MM/DD - Y2K compatible ;-)
<CurrTime>  current system time (format: hh:mm:ss)
<StartDate>  date of installation of FileShare
<SendEnable>  ON when send is enables, OFF when disabled
<FindEnable>  ON when @find reply is enabled, OFF when disabled
<FilesFound>  number of files found (@find reply)
<FindMask>  mask the remote user entered (@find reply)
<QueueMin>  minutes a request has been in the queue (@find reply, send from queue)
<Version>  FileShare version number (format: 1.11)
<LowCPS>  low cps limit for removal from the send list
<Author>  the author's nick (Marc II)
<AuthorsMail>  the author's email address (markus.petz@kfunigraz.ac.at)
<c1> <c2> .. <cn>  own defined color schemes (in the predefs section)
<c=1,0>  special syntax to directly set the text- and background colors
<u>  Underline. A second <u> ends the underlining.
<i>  Italic. A second <i> ends the italic style.
NOTE: this only works well with Pirch. mIRC may interpret it in another way.
<b> Bold. A second <b> ends the strong style.



___________________________________________
BELOW ARE THE ACTUAL MESSAGES YOU CAN SET:
===========================================
___________________________________________

[PREDEFS]
<c1>=6,0
<c2>=6,8
<c3>=1,0
<gr>=>
<le>=<
<dummy>=


[CHANNEL MESSAGES]
3=<c1>*   I just finished sending <c2> <FileName> <c1> to <c2> <ToNick> <c1>. This was the successful download Nr. <c2> <SentFull> <c1>   *
4=<c1>*   Send of file <c2> <FileName> <c1> to <c2> <ToNick> <c1> has been  interrupted at <c2> <SentPercent> <c1> percent!   *
6=<c1>*   PIRCH FileShare by Marc2 :: <c2> <TotFiles> <c1> files <c2> <TotMB> <c1> MB :: slots free: <c2> <AvailSends>/<MaxSends> <c1> :: que free: <c2> <AvailQueue>/<MaxQueue> <c1> :: type @<MyNick> to get a list   *
7=<c1>*   PIRCH FileShare by Marc2 :: <c2> <TotFiles> <c1> files <c2> <TotMB> <c1> MB :: slots free: <c2> <AvailSends>/<MaxSends> <c1> :: que free: <c2> <AvailQueue>/<MaxQueue> <c1> :: type @<MyNick> to get a list   *
8=<c1>*   PIRCH FileShare by Marc2 :: <c2> <TotFiles> <c1> files <c2> <TotMB> <c1> MB :: slots free: <c2> <AvailSends>/<MaxSends> <c1> :: que free: <c2> <AvailQueue>/<MaxQueue> <c1> :: type @<MyNick> to get a list   *
9=<c1>*   PIRCH FileShare by Marc2 :: <c2> <TotFiles> <c1> files <c2> <TotMB> <c1> MB :: slots free: <c2> <AvailSends>/<MaxSends> <c1> :: que free: <c2> <AvailQueue>/<MaxQueue> <c1> :: type @<MyNick> to get a list   *
10=<c1>*   PIRCH FileShare by Marc2 :: <c2> <TotFiles> <c1> files <c2> <TotMB> <c1> MB :: slots free: <c2> <AvailSends>/<MaxSends> <c1> :: que free: <c2> <AvailQueue>/<MaxQueue> <c1> :: type @<MyNick> to get a list   *
11=<c1>*   PIRCH FileShare by Marc2 :: <c2> <TotFiles> <c1> files <c2> <TotMB> <c1> MB :: slots free: <c2> <AvailSends>/<MaxSends> <c1> :: que free: <c2> <AvailQueue>/<MaxQueue> <c1> :: type @<MyNick> to get a list   *
12=<c1>*   <c2> <TotSentMB> <c1> Megabytes sent (<SentFull> full sends, <SentBroken> incomplete) :: slots free: <c2> <AvailSends> <c1> :: que free: <c2> <AvailQueue> <c1> :: @find is <c2> <FindEnable> <c1> :: type @<MyNick>-help for commands :: PIRCH Fileshare <Version> by Marc2   *
13=<c1>*   <c2> <TotSentMB> <c1> Megabytes sent (<SentFull> full sends, <SentBroken> incomplete) :: slots free: <c2> <AvailSends> <c1> :: que free: <c2> <AvailQueue> <c1> :: @find is <c2> <FindEnable> <c1> :: type @<MyNick>-help for commands :: PIRCH Fileshare <Version> by Marc2   *
14=<c1>*   <c2> <TotSentMB> <c1> Megabytes sent (<SentFull> full sends, <SentBroken> incomplete) :: slots free: <c2> <AvailSends> <c1> :: que free: <c2> <AvailQueue> <c1> :: @find is <c2> <FindEnable> <c1> :: type @<MyNick>-help for commands :: PIRCH Fileshare <Version> by Marc2   *
15=<c1>*   <c2> <TotSentMB> <c1> Megabytes sent (<SentFull> full sends, <SentBroken> incomplete) :: slots free: <c2> <AvailSends> <c1> :: que free: <c2> <AvailQueue> <c1> :: @find is <c2> <FindEnable> <c1> :: type @<MyNick>-help for commands :: PIRCH Fileshare <Version> by Marc2   *
16=<c1>FileShare now playing: <c2> <FileName> <PlayTime> <FileKHz>kHz <FileKbps>kbps <FileMode> (<FileSizeMB>MB) <c1> -- Get it: !<MyNick> <FileName>


[USER MESSAGES]
1=/notice <ToNick> <ToNick>, here comes <c2> <FileName> <c=1,0> as requested. Low cps limit is <c2> <LowCps> <c=1,0>.
2=/notice <ToNick> <ToNick>, after <c2> <QueueMin> <c=1,0> min in my queue finally here is <c2> <FileName> <c=1,0>. Thank you for waiting!
3=/notice <ToNick> sent manually: <c2> <FileName> <c=1,0> (<c2> <FileSizeMB> <c=1,0>MBytes). Low cps limit is <c2> <LowCps> <c=1,0>
4=/msg <ToNick> You are already receiving <c2> <FileName> <c=1,0>!
5=/msg <ToNick> Your request <c2> <FileName> <c=1,0> has been added <c2> #<QueuePos> <c=1,0> to my queue. Type <c2> @<MyNick>-help <c=1,0> for more info. Please dont change your nick or leave the channel!
6=/msg <ToNick> Your request <c2> <FileName> <c=1,0> is already in my queue! Type <c2> @<MyNick>-que <c=1,0> to see status.
7=/msg <ToNick> Sorry, you are only allowed to have <c2> <QueuePerUser> <c=1,0> files in my queue. Your request [ <c2> <FileName> <c=1,0> ] has NOT been added.
8=/msg <ToNick> Sorry, my queue is full... Your request <c2> <FileName> <c=1,0> has NOT been added. Try again in a while!
9=/msg <ToNick> Sorry, the file you requested [ <c2> <FileName> <c=1,0> ] does not exist in my list. Please check the name and try again. You may get my actual list by typing <c2> @<MyNick> <c=1,0> 
10=/msg <ToNick> Sorry, my file server is currently disabled. <c2> <FileName> <c=1,0> has NOT been added to the queue.
11=/msg <ToNick> <c2> <FileName> <c=1,0> has been waiting for <c2> <QueueMin> <c=1,0> min and is currently <c2> #<QueuePos> <c=1,0> in the que.
12=/msg <ToNick> That makes <c2> <QueueFiles> <c=1,0> of <c2> <QueuePerUser> <c=1,0> files you are allowed to have in my queue.
13=/msg <ToNick> You have NO files in my queue.
14=/msg <ToNick> <c2> <FileName> <c=1,0> has been removed from my queue.
15=/msg <ToNick> Found matching file: !<MyNick> <FileName>
16=/msg <ToNick> Too many files to display. Please get my list by typing <c2> @<MyNick> <c1>
17=/msg <ToNick> Thank you for downloading <c2> <FileName> <c=1,0>. Hope you enjoy it! :-)
18=/msg <ToNick> Your mIRC "request in private message" option seems to be on. Some people dont like getting file requests in private windows.
19=/msg <ToNick> Please turn that off (choose: File-<gr>Options-<gr>click "+" sign next to "Sounds"-<gr>Requests-<gr>disable "send !nick file as private message"-<gr>hit OK)-<gr>repeat request <c2>in the channel window<c=1,0> :-)
20=/msg <ToNick> <c2> <FilesFound> <c=1,0> Files found matching <c2> <FindMask> <c=1,0> Copy and paste into the <c2> channel window <c=1,0> Hint: If you have a PIRCH client (not mIRC!), try <c2> !<MyNick> TSEND <le>filename<gr> <c=1,0> - this will establish a faster TDCC connection.


[LISTFILE HEADER]
1=-----------------------------------------------------------------------------
2=--- <MyNick> file list, generated <CurrDate> <CurrTime>
3=--- list of <TotFiles> files, total <TotMB> Megabytes
4=--- FileShare fileserver (c) Marc II, version <Version>
5=--- THIS IS A PIRCH98 SCRIPT - To get it, mail <AuthorsMail>
6=-----------------------------------------------------------------------------
7=
8=[=========================================]
9=| COMMANDS for general use of the script: |
10=[=========================================]
11=Note: My nick may not always be exactly the same! My alternative nicks may be <MyAltNicks>
12=
13=@<MyNick>    - to get the actual list of files available
14=!<MyNick> filename   - request download of file (you may be added to a queue,
15=<dummy>     in that case you have to be in the channel when the send starts
16=<dummy>     you can interrupt and resume the transfer anytime you want, just request a new send
17=!<MyNick> TSEND filename   - request download of file by TDCC. This is a faster protocol mainly for PIRCH users.
18=@<MyNick>-QUE   - to see your position in the queue
19=@<MyNick>-REMOVE filename  - to remove your files out of the queue (filename is optional,
20=<dummy>     all files are removed if none is given
21=@FIND mask   - to search for a particular filename (mask contains wildcards [?*] and text)
22=@<MyNick>-HELP   - to receive a short overview of commands
23=
24=ENJOY!!
25=
26=
27=[==========================]
28=| List of available files: |
29=[==========================]
30=copy the file name including !NICK and the file extension
31=and paste it into the channel, example:
32=!<MyNick> (simple_minds)-belfast_child.mp3
33=
34=
