DonsQUIZ Version 1.50 (c) by Donneker
======================================
Stefan Hummert
visit http://www.donneker.de
www.donster.de
www.erfolgswelt.de

Ein Quiz-Script für mIRC von Stefan Hummert.
- SYSTEMVORRAUSSETZUNGEN -- SYSTEMVORRAUSSETZUNGEN -- SYSTEMVORRAUSSETZUNGEN -- SYSTEMVORRAUSSETZUNGEN -
Systemvorraussetzungen: Für DonsQuiz, ein Script, das, wie dieser Name schon andeuted, nicht alleine
laufen kann sondern, es werden für den Betrieb ein paar Programme benötigt.
Zuallererst die empfohlene Rechnerkonfiguration, unter der das Script die nötige
Geschwindigkeit hat, um ohne allzugrosse Zeitverzögerungen reagieren zu können.
Hardware:
PC mit 200 MHz Intel Pentium oder besser
48 MB Hauptspeicher
Das Script braucht nur ca. 1 MB Plattenplatz, bei
weiteren Add-Ons evtl. auch etwas mehr.
Eine schnelle anbindung ans Internet (mindestens ISDN),
besser natürlich gleich eine LAN Verbindung zum Server.
Software:
Windows 9x / NT / 2000
MIRC ab version 5.6x (neuste Version immer empfohlen)
mirc gibts bei www.mirc.co.uk
Das Script ist für dieses Programm geschrieben.
- SYSTEMVORRAUSSETZUNGEN -- SYSTEMVORRAUSSETZUNGEN -- SYSTEMVORRAUSSETZUNGEN -- SYSTEMVORRAUSSETZUNGEN -

- INSTALLATION -- INSTALLATION -- INSTALLATION -- INSTALLATION -- INSTALLATION -- INSTALLATION -
Einfach die Datei "Donsquiz.ini", "Donsquiz2.ini", "Donsquiz3.ini", "Donsquiz4.ini"
"Donsquiz.ger" (deutsche Sprachdatei), "Donsquiz.db" (Quizfragendatenbank)
"Donsquiz_Readme.txt" (diese Readme, die gleichzeitig die Hilfedatei für den Quizmaster dastellt)
und die Datei "Donsquiz_Lizenz.txt" (enthält die Lizenzbestimmungen)
ins mIRC-Verzeichnis kopieren. Falls schon eine ältere Version von DonsQUIZ installiert war,
werden die alten Dateien überschrieben. In der Donsquiz.db (früher Donsquiz.txt) datei sind die bisher
schon verfügbaren Fragen. (für automatische Fragen)
Wenn man nun seine alte Donsquiz.txt behalten will, diese einfach in Donsquiz.db umbenenen, oder
bei Optionen im Menü als Hauptdatenbank-Datei Donsquiz.txt angeben.
Wenn ihr selber eine Datei mit Fragen habt, und diese behalten wollt, müsst ihr sehen
das sie nicht durch die Donsquiz.db (früher Donsquiz.txt) überschrieben wird!

Sollte vor diesem Quiz ein anderes mit gleichem Befehlssatz schon installiert worden sein,
dieses zuerste mit "/unload -a (anderes Quiz)" bei Redhead z.b. "/unload -a Redhead.ini" tippen.
Dann zum Installieren in mIRC "/load -a Donsquiz.ini" eingeben.
- INSTALLATION -- INSTALLATION -- INSTALLATION -- INSTALLATION -- INSTALLATION -- INSTALLATION -

- ACHTUNG -- ACHTUNG -- ACHTUNG -- ACHTUNG -- ACHTUNG -- ACHTUNG -- ACHTUNG -- ACHTUNG -
Versionshinweise: in Version 1.25 wurde die der Aufbau der Quizfragendatenbank verändert.
Das bedeuted, sollte vor dieser Version schon eine DonsQuiz version (z.b. 1.22) eingesetzt worden
sein, mit Quizfragendatenbank, und ihr wollt die fragen behalten, und nur DANN, dann müsst ihr
eure Fragendatenbank mit dem Befehl /convert >dateiname< also z.b. "/convert Donsquiz.txt"
eingeben. DAS müsst ihr nur EINMALIG machen! auch solltet ihr sicherheitshalber vorher
euer Fragenfile nochmal abspeichern (also sichern)!
DAMIT Convert funktioniert, muss das Quiz gestartet sein!
Versionshinweise: ab Version 1.36 wird auch diese Readme Datei gebraucht. Also keine! Änderungen
an dieser Datei vornehmen. Die Hilfe für den Quizmaster wird hierraus gelesen!
- ENDE HINWEIS -- ENDE HINWEIS -- ENDE HINWEIS -- ENDE HINWEIS -- ENDE HINWEIS -

- GENERELLES -- GENERELLES -- GENERELLES -- GENERELLES -- GENERELLES -- GENERELLES -
Gennerell gilt, das in der Nicklist (also in der Listbox, in der alle user angezeigt werden)
und im Channelfenster beim rechtsklick ein Menü aufgeht...
da gibt's nun ein Unterpunkt - >quiz und der hat viele weitere Unterpunkte.
Diese sollten sich von alleine erklären, probiert sie einfach mal aus.
Über diese Menü hat man unter dem Punkt Allgemein nun die Möglichkeit einzelne Befehle
die die User ausführen können zu deaktivieren (unterpunkt Befehle) und auch
z.b. Sound einzustellen oder zu deaktiviern (der Sound ist nur ein Hinweissound, der
abgespielt wird, wenn die Quizfrage richtig beantwortet wurde).
Auch kann man dort Einstellen, ob alle neuen eingegebenen Fragen gespeichert werden
sollen oder nicht.
- GENERELLES -- GENERELLES -- GENERELLES -- GENERELLES -- GENERELLES -- GENERELLES -

- QUIZFRAGENDATENBANK FENSTER -- QUIZFRAGENDATENBANK FENSTER -- QUIZFRAGENDATENBANK FENSTER -
Zusätzlich gibt es ab Version 1.35 nun ein Fenster, in dem die Fragen der Hauptdatenbank
aufgezeigt werden. Mit diesem Fenster kann man Fragen stellen indem man auf die entsprechende
frage Doppelklickt. Mit rechtsklick erscheint ein Menü, das sich selbst erklären sollte.
Bei bearbeiten geht ein weiteres Fenster auf, in dem man die Frage bearbeiten kann.
In diesen DonsQuiz-Edit Fenster kann man nun die gespeicherte Frage, Antwort und die zugehörigen
Tips sehen. Grün Markiert ist die entsprechende Abkürzung. Entweder kann man mit einem
Rechtsklick wieder ein Menü aufrufen, über das man die Daten bearbeiten kann, oder
man macht es direkt über die befehlszeile wo schon /DQE steht. wenn man z.b. eine
Frage korrigiern möchte gibt man ein /DQE F Neuer-Fragen-Text. /DQE steht ja schon da,
das F weist darauf hin, das man die Frage korrigiern möchte, und der Text dahinter ist
die neue Frage. Um die Antwort zu korrigiern gibt man also ein /DQE A Richtige-Antwort
Um einen Tip zu verändern einfach /DQE Tip-Nummer Veränderter-Tip eingeben, also wenn man,
z.b. Tip Nr. 0 verändern möchte einfach /DQE 0 Veränderter-Tip eingeben, oder um einen
neuen Tip einzugeben einfach eine Nummer höher Greifen! Gibt es z.b. einen Gespeicherten
Tip mit der Nummer 0, und man will einen weiteren hinzufügen muss man /DQE 1 Neuer-Tip
eingeben. Gibt es bisher noch keinen Tip und man möchte einen hinzufügen muss man /DQE 0 Neuer-Tip
eingeben. Zuletzt noch etwas, um einen Tip zu löschen. Dies kann man mmit /DQE D Tip-nummer.
Das D steht für Delete (engl. löschen) und Tip-Nummer für die Tip Nummer die man löschen möchte.
z.b um Tip nr. 5 zu löschen einfach /DQE D 5 eingeben.
- QUIZFRAGENDATENBANK FENSTER -- QUIZFRAGENDATENBANK FENSTER -- QUIZFRAGENDATENBANK FENSTER -

- OPTION STRIKT -- OPTION STRIKT -- OPTION STRIKT -- OPTION STRIKT -- OPTION STRIKT -
Die Option Strikt sagt aus, das das Script nur auf exakte eingaben reagiert, also bei z.b.
zahlen kann man für 10 nicht wie früher auch 100 tippen. Bei Wörtern mit Buchstaben
habe ich eine zulässige Abweichung von bis zu 3 Buchstaben eingebaut.
Generell is die Option Strikt aktiviert.
- OPTION STRIKT -- OPTION STRIKT -- OPTION STRIKT -- OPTION STRIKT -- OPTION STRIKT -

BEFEHLE -- BEFEHLE -- BEFEHLE -- BEFEHLE -- BEFEHLE -- BEFEHLE -- BEFEHLE -- BEFEHLE -
Die Befehle für DonsQUIZ: (für den Quizmaster)
die Befehle für die User sind an den Nachrichten ersichtlich.

Quiz starten:
/quizon #channel Beispiel: "/quizon #chatfun"

Quiz beenden:
/quizoff

Quiz Hilfe:
/quizhelp [wort]
Es kann jederzeit während das Quiz läuft auch für den Quizmaster hilfe
angezeigt werden. Wenn man nach einem Wort suchen lässt. Normalerweise
sucht der Befehl nur nach "Schlagwörtern" also wichtigen Wörtern.
Will man allerdings die Suche nach diesem Wort durchführen, also ohne das
es zwingenderweise ein Schlagwort ist muss man um das Wort * setzen.
Beispiele: /quizhelp Frage - zeigt Hilfe nach dem Schlagwort "Frage" an,
wenn dieses nicht gefunden wird gibts eine Meldung aus.

oder /quizhelp *nun* - zeigt alle! Hilfen an, die über dieses Wort verfügen.
also sollte man dementsprechend vorsichtig sein, wenn
man keine ganze wiedergabe der Hilfedatei haben will.

Frage stellen:
/qf
Es erscheint ein Dialogfeld, wo man nacheinander die Frage und die Antwort
eingeben muß. Die Frage wird jedoch erst gestellt, wenn man daraufhin nochmal
Eingaben bestätigt.

Automatisch Frage stellen:
/qfa [Nummer] [Wort]
entweder schreibt man nur /qfa, dann stellt der computer automatisch selber
eine frage. Mann kann optional auch noch eine Nummer angeben die zwischen 1
und der zahl liegen muss, die am anfang der donsquiz.txt datei steht. (anzahl
der fragen, die gespeichert sind.) das könnte dann z.b. so aussehen /qfa 55
Wenn man das optionale argument wort angibt, wird eine frage gestellt, die das
Wort unter [Wort] enthält. (kann auch mehr als nur ein Wort sein...
wird auch noch eine [nummer] angegeben, wird ab
der Zeile [Nummer] das suchen begonnen. z.b. /qfa Land oder /qfa 100 Land

Frage wiederholen:
/qw
Die zuletzt gestellte frage wird wiederholt! ist keine Frage gestellt, wird
natürlich auch keine wiederholt.

Antwort korrigieren:
/qa
Es erscheint ein Dialogfeld, bei dem Sie die richtige Antwort eingeben können
also falls Sie sich einmal vertippt haben.

Tip geben mit:
/qt
Es erscheint ein Dialogfeld, wo man den Tip eingeben kann.

Tip geben mit:
/qta
Verbesserte Version von /qt. Hier kann man den Tip direkt an der
Befehlszeile Hinter /qta Text.... eingeben.
schreibt man nur /qta ohne text dahinter, gibt der Computer einen
Automatischen Tip, der aus der antwort mit punkte dazwischen besteht.
Beispiel: Antwort wäre Hallo. Tip vom Computer wäre: H....
Diesen automatischen Computertip gibt der Computer auch aus, wenn
von 3 verschiedenen Chattern !Tip eingegeben wird (im quizchannel)

Ab Version 1.25 kommen vor diesen Automatischen Tips die gespeicherten
Tips, die evtl. vorhanden sind. Auch werden neue Tips zu alten Fragen
Automatisch gespeichert (gilt für beide befehle, also /qt als auch /qta)
Der Quizmaster sollte dann allerdings darauf achten, keine Tips
wie >>Aniliner FAST<< zu geben, denn bei wiederholung der frage und
dieses Tips dürften die Ratenden auch nicht viel schlauer sein :-)

Quizdatenbankfrage korrigieren:
/qe [Nummer]
Es erscheint das Dialogfeld das das gleiche ist wie weiter oben bei
- QUIZFRAGENDATENBANK FENSTER - beschrieben worden ist.
Durch den Befehl /qe wird es lediglich erleichtert, die Frage zu editiern,
wenn man nur die Nummer kennt (dafür ist das Argument Nummer)
Wenn man keine Nummer hinter /qe angibt, so wird die aktuelle Frage editiert.

Rangliste:
/quizstats [Nummer]
Es werden die 3 besten Spieler mit ihrer Punktzahl aufgelistet,
allerdings kann man diese Voreinstellung ändern, und wenn man eine
Nummer angibt, werden die ersten angezeigt, bis zur Nummer, auser
es gibt nicht soviele einträge.

Gruppenliste:
/quizteams
Hier werden alle Gruppen aufgelistet, die Mitglieder haben!

Antwort nachschauen:
/quizantwort
Die aktuelle Frage und die Lösung werden nocheinmal angezeigt.
NUR SICHTBAR für den, der das Quiz selber laufen hat. Es wird also NICHTS im
Channel gezeigt.

Zusatzpunkte vergeben:
/quizcount [nick] [Punkte]
Mit dieser Option kann man einem User gleich mehrere Zusatzpunkte geben.
z.b. /quizcount Donneker 3
würde in diesem Fall Donneker 3 Punkte bekommen! Diese vorgehensweise ist
allerdings NICHT sichtbar, sprich das Quiz gibt keine Meldung aus, das
die Punkte addiert wurden, obwohl sie addiert worden sind!

Datenbank-Fenster:
/dqwin
Hiermit wird die Hauptdatenbank (also das Fragenfile) in einem Fenster
angezeigt, in dem man einfach vorhandene Fragen stellen oder bearbeiten
kann. Doppelklick auf eine Frage stellt diese, während ein Rechtsklick
ein Menü öffnet, in dem man den Punkt Bearbeiten auswählen kann, um
die Gespeicherten Daten zu verändern (z.b. um etwas zu korrigieren)

etwas Werbung:
/quizad
Macht im Channel etwas Werbung für das QUIZ und zeigt die URL an.
Auch wenn das Quiz im Moment gar nicht läuft und nicht
gestartet wurde.

standby Modus:
/quizby
Damit kann man das Quiz auf Standby schalten, und das Menü, sowie die
USERBEFEHLE sind solange deaktiviert... kann man also auch als
"verstärkten" floodschutz nehmen.
Eigentlich dafür gedacht.. das man z.b. mehrere Quizze laufen lassen kann,
die die selben befehle verwenden, und damit nicht jedes darauf reagiert,
bzw. man sein quiz später nach einer pause fortsetzen kann.

- BEFEHLE -- BEFEHLE -- BEFEHLE -- BEFEHLE -- BEFEHLE -- BEFEHLE -- BEFEHLE -- BEFEHLE -

- OPTIONEN -- OPTIONEN -- OPTIONEN -- OPTIONEN -- OPTIONEN -- OPTIONEN -- OPTIONEN -
Einstellungsmöglichkeiten des Scripts.
Man kann sehr viele Variationen von Punktevergaben machen, und das Script bietet
auch sehr viele Einstellungsmöglichkeiten dafür.
Zum Beispiel kann man mehreren Usern, die die richtige antwort gesagt haben, Punkte
geben. Man kann verschiedene Punktevergabesysteme einstellen.
Man kann den Floodschutz des Scriptes einstellen, damit man nicht zu leicht
vom IRC Server geschmissen wird.
- OPTIONEN -- OPTIONEN -- OPTIONEN -- OPTIONEN -- OPTIONEN -- OPTIONEN -- OPTIONEN -

- FRAGEN -- FRAGEN -- FRAGEN -- FRAGEN -- FRAGEN -- FRAGEN -- FRAGEN -- FRAGEN -- FRAGEN -
FRAGE: Warum hat dieses Quiz soviele .ini Dateien und ist aus insgesamt mehreren Dateien
zusammengesetzt? Brauche ich die wirklich alle ?
ANTWORT:Ja, es werden alle ! Dateien benötigt, um ein funktionsfähiges Quizscript
benutzen zu können. Die Aufspaltung in mehrere Dateien hat seinen Sinn,
denn z.b. kann mirc in der aktuellen version nur Scriptdateien bis 30000 Bytes
verarbeiten.

FRAGE: Brauche ich auch die Donsquiz_Readme.txt, damit das Script funktioniert ?
ANTWORT:Ja, auch diese Datei wird benötigt. Zwar enthält Sie keinen Scriptcode,
doch sie ist z.b. für den Befehl /quizhelp nötig, da die Hilfen für den
Quizmaster aus dieser Datei hier gelesen werden. Deshalb sollte man auch
an dieser Datei keine Änderungen durchführen.

FRAGE: Was ist, wenn nach einiger Zeit im Quiz eine Meldung kommt die lautet:
/set: line too long (line xxx, donsquiz.ini)
ANTWORT:Das liegt an den Fragen, die gespeichert werden, damit man nicht doppelte
Fragen stellt. Leider kann die Variable nur eine bestimmte anzahl fragen
speichern, mann muss dann auf im Quizmenue auf -> Allgemein -> Question-Reset


- FRAGEN -- FRAGEN -- FRAGEN -- FRAGEN -- FRAGEN -- FRAGEN -- FRAGEN -- FRAGEN -- FRAGEN -


Bei Problemen oder Verbesserungsvorschlägen bitte eine eMail an donsquiz@my.donster.de
Donneker