KnuffelScript Talker Systeem 
============================

INDEX

1	TALKER SYSTEEM
1.1 	INTRODUCTIE
1.2	OUDE TALKERS
1.3	TALKERS MAKEN
1.4	TALKER MODUSSEN (1word / Sentence)
1.5	TAGS
1.6	VOORBEELD
2.1	VERSIE HISTORIE


1 TALKER SYSTEEM


1.1 INTRODUCTIE
===============

KnuffelScript heeft een eigen talker systeem, waarbij je zelf gemakkelijk talkers kunt toevoegen.
Het heeft een eigen formaat, dus het zal niet werken met zelfgemaakte talkers met eigen code. 

Om dit te doen, kun je bijv. je eigen .tlk of .txt bestand aanmaken. (met Notepad/Kladblok)


1.2 OUDE TALKERS
================

Wanneer je het Knuffelscript talker systeem ingeschakeld hebt (Knuffelscript menu) < F9 > , zullen je oude talkers niet goed werken. Oude talkers zijn bijv:

ON *:INPUT: {
   if $1 == haha { msg $active 12Ha12Ha $2- | /sound haha.wav }
}

Dus mocht je dit soort talkers willen laden, zorg er dan voor dat het talker systeem uitgeschakeld staat, dus dat er geen vinkje staat bij: BorgIRC menu > Talkers > Maak gebruik van talkers.


1.3 TALKERS MAKEN
=================

KnuffelScript heeft dus nu z'n eigen talker systeem, waarmee je veel gemakklijker (hoop ik) je eigen talkers kunt maken.
Dit gaat door middel van .tlk of .txt bestanden. Deze maak je bijv. in kladblok of iets dergelijks. Misschien dat ik nog een talker editor maak, maar dat weet ik nog niet zeker.

Een Knuffelscript talker bestand is opgemaakt uit 2 delen. Het eerste deel bevat algemene informatie over de talker, zoals de auteur, versienummer en de beschikbare talkermodus (Zie 1.4). Het tweede deel bevat het talker gedeelte.
Het formaat is vrij simpel:

afkorting<spatie>talker

Dus:

hoi 12Ho12i


1.4 TALKER MODUSSEN
===================

Het talker systeem kan zo ingesteld worden dat het kan reageren op twee verschillende situaties:

1-woord (1word)
---------------
De talker reageert alleen wanneer je zin begint met het desbetreffende woordje en zal alleen dat woordje vervangen.
Let op, voor deze modus moet je zgn. "tags" in je talkers verwerken als je bijv. tekst erachter wilt hebben.

Voorbeeld van een 1-woord talker
--------------------------------

Nick1 typt in:	 hoi STING en STING2

In de talker staat: hoi 12Ho12i
Resultaat: <Nick1> 12Ho12i

In de talker staat: hoi 12Ho12i <2>
Resultaat: <Nick1> 12Ho12i STING

In de talker staat: hoi 12Ho12i <2->
Resultaat: <Nick1> 12Ho12i STING en STING2

In de talker staat: hoi 12Ho12i <2> <sound hoi.wav>
Resultaat: <Nick1> 12Ho12i STING en STING2     en het geluidje hoi.wav wordt afgespeeld.


Hele zin (Sentence)
-------------------
De talker reageert wanneer het woordje/de letter in je zin voorkomt. Dit betekent dat het alle matches die het tegenkomt zal vervangen. Dit kan echter een probleem vormen wanneer een talker de letter "h" in zich heeft. Dit betekent nl. dat elke letter "h" vervangen wordt door bijv. woorden. Dit zou niet echt goed zijn.


Voorbeeld van een Hele zin talker
---------------------------------

Nick1 typt in:	 STING en STING2 hoi

In de talker staat: hoi 12Ho12i
Resultaat: <Nick1> STING en STING2 12Ho12i

Voor een hele zin talker hoef je dus geen <tags> te gebruiken.


Niet elke talker zal goed werken met deze twee modussen. Bijvoorbeeld sommige talkers hebben bijv. het volgende:

h 12Ho12i

Dit betekent dat in de Hele-zin modus elke letter "h" wordt vervangen door "12Ho12i". Dat gaat dus niet goed.
Dus stel als jouw talker veel gebruik maakt van hele korte benamingen (1-letterig of 2-letterig) dan is het aan te raden om alleen bij 1word "Yes" te zetten.

Daarom heeft elke talker twee velden, waarin je kunt instellen waar jouw talker compatible mee is:

1word=Yes
Sentence=No


1.5 TAGS
========

BTS ondersteunt zogenaamde "tags" in de talkers:

<2>				$2
<2->				$1-
<sound ....wav> 		/sound ...wav|mid|mp3
<me> 				$me
<chan>				$chan / #
<time>				$time
<date>				$date


<2> & <2-> zijn dus nodig voor de 1-zin modus als je wilt dat er tekst achter het talker gedeelte komt.
In de Hele zin modus worden deze tags genegeerd.



1.6 VOORBEELD
=============

Voorbeeld van twee complete talkers:


[talkers]
Name=Mijn Talker
Author=STING
Version=1.00
1word=Yes
Sentence=No

ha 12Ha12Ha <2->
hoi 12Ho12i <2>
huh 12Hu12H <sound huh.wav>






[talkers]
Name=Mijn Talker
Author=STING
Version=1.00
1word=No
Sentence=Yes

haha 12Ha12Ha
hoi 12Ho12i
huh 12Hu12H <sound huh.wav>




Let op: Het einde van een talker kun je het beste afsluiten met een "", zodat de kleur die erna komt weer normaal is.

Zodiac1-2,Bracha 1-2 zijn typische 1-word talkers. In de Hele zin modus wordt het een rommeltje.
STING1+2 zijn compatible met beide modussen.



2.1 VERSIE HISTORIE
===================

v1.01

* Talker uitleg uitgebreid
* Oude talkers en dergelijken werken nu goed als het talker systeem uitgeschakeld staat
* Extra controles geimplementeerd bij het laden van de talkers
* Template/sjabloon talker toegevoegd (Template.tlk)
* Bij het laden van talkers wordt nu ook naar het .txt bestandstype gekeken

v1.00

* 1e release.