***************************************************************************
***                            #QuizPL TeaM                             ***
***                                                                     ***
***                  Najlepszy kanał quizowy na IRC-u!                  ***
***************************************************************************
***                       https://www.quizpl.net                        ***
***                         kontakt@quizpl.net                          ***
***************************************************************************

Witaj drogi Quizowiczu. Oto instrukcja, dzięki której będziesz mógł/mogła samodzielnie napisać i puścić swoją premierę 
quizową na kanale #QuizPL. :)

Pełny poradnik znajdziesz pod adresem: https://www.quizpl.net/poradnik

############################
### I. Instalacja mIRCa. ###
############################

Jeśli masz już ściągniętego i poprawnie skonfigurowanego mIRCa możesz pominąć ten punkt i po uruchomieniu mIRCa dodać 
do ulubionych kanał #QuizPL oraz wejść na kanał poleceniem /join #QuizPL


Aby zaś ściągnąć mIRCa i móc grać na kanale #QuizPL wykonaj poniższe kroki:

1. Ściągnij plik https://www.quizpl.net/viewforum.php?f=79
2. Rozpakuj powyższy plik do dowolnego katalogu, np. C:\Program Files\
3. Przeczytaj zamieszczony tam plik "-= Przeczytaj mnie =-.txt"
4. Uruchom plik mIRC.exe
5. Kliknij teraz na pierwszą ikonkę pod menu (tą z piorunkiem) lub wpisz na dole "/server polska.irc.pl" (bez 
   cudzysłowu) i wciśnij enter. Jeśli połączyłeś się z serwerem i automatycznie otworzyło się nowe okienko, to jesteś 
   już na kanale #QuizPL i od teraz możesz zdobywać punkciki!


Alternatywnie możesz ściągnąć mIRCa ze strony autora programu https://www.mirc.com/get.html lecz wówczas musisz 
samodzielnie skonfigurować program lub napisać na adres kontakt@quizpl.net by uzyskać naszą pomoc.

###############################
### II. Instalacja skryptu. ###
###############################

Rozpakuj to archiwum i przenieś wszystkie pliki do głównego katalogu mIRCa, np. C:\Program Files\mIRC\ oraz uruchom 
plik mirc.exe

Teraz, by móc korzystać ze skryptu (w dniu puszczania quizu), należy go wgrać do uruchomionego wcześniej mIRCa. 
Uzyskasz to poleceniem:

/load -a dizquiz.ini

W okienku statusu powinien pojawić się podobny do tego napis:

* Loaded aliases 'C:\...\dizquiz.ini'

#############################################
### III. Przygotowanie pliku z pytaniami. ###
#############################################

Ten rodzaj quizu opiera się typowo na wiedzy graczy i jest podstawową formą premier quizowych.

Gdy zdecydujesz się napisać swój quiz i puścić go na kanale - wybierz sobie dziedzinę z jakiej chciałbyś napisać quiz 
(może być także wiedza ogólna).

Plik z pytaniami musi być w odpowiedniej postaci. Format pliku polega na tym, że pytania i odpowiedzi są umieszczane 
naprzemiennie w kolejnych linijkach zakończonych enterem, przy czym pytanie poprzedzamy "pyt ", zaś odpowiedź "odp " 
(zwróć uwagę czy przypadkiem nie napisałeś "pty" lub "opd", bo skrypt utknie na tym pytaniu). Przykład:

pyt Najlepszy kanał quizowy na IRC-u?
odp #QuizPL
pyt Ile jest 2*2?
odp cztery
pyt Jak ma na imie brat Lolka?
odp Bolek

Przykładowy quiz znajdziesz w pliku "przyklad.txt", zaznajom się z nim.


Podstawowe zasady układania quizów:

- format pliku musi być poprawny, bo quiz utknie na błędnym pytaniu (unikaj zbędnych spacji i wystrzegaj się pustych 
  linii)
- nie używaj w pytaniach i odpowiedziach znaków diakrytycznych (ą, ć, ę, ł, ń, ó, ś, ź, ż)
- pytania i odpowiedzi nie mogą zawierać błędów ortograficznych, stylistycznych, interpunkcyjnych i merytorycznych
- pytania zaczynaj wielką literą, a odpowiedzi małą, chyba że są to nazwy własne
- pytania nie mogą być ze sobą powiązane:

tak jest źle:

pyt Zagral glowna role w filmie "Szklana pulapka".
odp Bruce Willis
pyt Kto jest jego zona?
odp Demi Moore

tak jest dobrze:

pyt Zagral glowna role w filmie "Szklana pulapka".
odp Bruce Willis
pyt Byla zona Bruce'a Willisa.
odp Demi Moore

a tak nawet lepiej:

pyt Odtworca glownej roli w filmach "Szklana pulapka" oraz "12 malp".
odp Bruce Willis
pyt Byla zona Bruce'a Willisa (1987-1998).
odp Demi Moore

- unikaj długich odpowiedzi, najlepiej niech mają góra 2-3 wyrazy
- nie pisz zbyt długich, opisowych pytań - skonkretyzuj je
- nie używaj słów niecenzuralnych, jeśli to cytat z filmu lub piosenki użyj gwiazdki ("*") do cenzury
- nie układaj pytań "killerów", czyli takich, na które odpowiedzi znać będą tylko pasjonaci


Gdy już utworzysz zestaw ok. 50 pytań (na przykład w windowsowym notatniku, ale nie w Wordzie!), to zapisz je w pliku, 
w głównym katalogu z mIRCem. Pamiętaj jednak by nazwa pliku nie zawierała spacji.

################################
### IV. Puszczenie premiery. ###
################################

Kiedy napiszesz już quiz i ustalisz z operatorami kanału dzień i godzinę premiery - możesz przystąpić do jej 
realizacji w wyznaczonym terminie. Nie zapomnij tylko o wgraniu skryptu (patrz punkt II). ;)

Skrypt zawiera wiele poleceń. Pełną ich listę uzyskasz poleceniem: /kom

Aby uruchomić quiz otwórz okno kanału #QuizPL i wpisz:

/autoquiz #QuizPL przyklad.txt

gdzie za "przyklad.txt" podajesz nazwę własnego pliku z pytaniami.

W razie potrzeby możesz zwiększyć opóźnienie między poszczególnymi pytaniami (domyślnie jest to 7 sekund) poleceniem: 
/delay 10

*** Teraz gracze grają i cieszą się z Twojej premiery. ;) ***

W sytuacji gdyby quiz się utknął (z powodu błędu w pliku z pytaniami), to nie panikuj. Wpisz wtedy dwukrotnie 
polecenie /pauza Spowoduje to pominięcie błędnego pytania i przejście do kolejnego. W przypadku poważnych błędów w 
formacie w pliku z pytaniami koniecznym może się okazać pominięcie więcej niż jednego pytania lub wprowadzenie 
poprawek w pliku z pytaniami w trakcie premiery.

Po zakończeniu premiery trzeba wyświetlić wyniki. Uczynisz to poniższym poleceniem. Pamiętaj jednak by wyświetlić 
pełną punktację obejmującą wszystkich grających (uzyskasz to zwiększając liczbę podawaną za poleceniem - gdy 
"/stat 10" nie pokazało wszystkich, to wpisz np. "/stat 15" itd.):

/stat 10

Na koniec zamykasz quiz poleceniem:

/qoff


Po zakończeniu i zamknięciu quizu możesz (zalecane), ale nie musisz wyładować skrypt z mIRCa. Dokonasz tego 
poleceniem:

/unload -a dizquiz.ini

Aby puścić kolejną premierkę należy ponownie wgrać skrypt poleceniem /load (patrz punkt II).


Uwaga, nie zapomnij by po zakończeniu premiery przysłać plik z pytaniami, temat quizu wraz z datą puszczenia oraz 
pełne wyniki na adres kanałowy: kontakt@quizpl.net Pytania zostaną wówczas dodane do bazy naszego quizbota i wszyscy 
będą mogli się nimi cieszyć jeszcze przez długie lata ;)

##############################
### V. Polecenia kanałowe. ###
##############################

W trakcie trwania premiery quizowej dla graczy dostępne są specjalne polecenia. Pamiętaj, że z uwagi na specyficzny 
sposób funkcjonowania mIRCa te polecenia nie są dostępne dla puszczającego premierę.

Przypomnienie pytania: !przyp

Poproszenie o kolejną podpowiedź: !podp

Wyświetlenie własnej punktacji: !ile

Wyświetlenie punktacji trójki najlepszych graczy: !stat

##################################
### VI. Informacje o skrypcie. ###
##################################

Wersja: Dizzy 4.0
Autor: Dizzy


Miłej zabawy życzy,
Ekipa #QuizPL.
