===  http://bestirc.net.ru
===
=== - BestIRC group

Tat's Trivia Bot v3.53

http://tatarize.com
To check for latest version.

To use this trivia bot
1) Simply put the files in your mIRC directory.
2) At the status window type: /load -rs trivscript.mrc
3) Goto 'Commands, Trivia, Options'. Then, add the channel you want to use the trivia bot on.
4) Go to that channel and type: !trivia

The game should start.

Note: Do not bother to open the file. It needs to be loaded with mIRC. Just uncompress the files into your mIRC directory. If you cannot find your mIRC directory, inside mIRC type "//run $mircdir". That should open up the mIRC directory where you need to place the files.

Goto Commands, Trivia, options, and set the options as you require.

General:
Channel: Not truely needed to be set in options. Commands, set channel will set the current channel as the trivia channel.
Scores: Use what file to define specific scores for the channel set.
Question: Specify the question.txt
Additions: This file is a sort of drop file for suggestion on new question by patrons.
Report: Close to the additions but different file (could specify the same) for problems with questions.
Delimiter: The character that seperates questions from answers in the questions file.
Directory: Directory that the files (Question, Additions, Report) reside in.
Hint Character: Allows a hint character to be specified as whatever you choose.
NOTE: Using # can cause errors as it is sometimes taken to mean the channel name by mIRC.
No-activity off: After a set number of questions the bot turns itself off.
Hint-Pause: After a person requests a hint it refuses to take a correct answer for a giving amount of time.

Defaults:
Primary Color: Color of dynamic.
Secondary Color: Color static text.
B & U: These make the color that the color is next to either (B)old or (U)nderlined.
Background1: Background color for the text.
Background1: Background color for the secondary text.
Before Start: Lag in seconds between start and first question.
Beween Questions: If the question was answered or the question timed out different amount of lag can be applied.
Given to Answer: Amount of time before the question times out.
Before '!hint' allowed: To combat people who want a !hint before they finish reading the question
Default Round: If nobody specifies how long they wish the round to be by using a command such as !trivia 10 this is how many questions are done in the round.
Champ Goal: The goal amount before reset so long as Champ Mode is engaged.

Teams:
When somebody does the command !trivia team, team mode begins. With a default number of questions in the round. 
Team 1: This specifies the name of Team 1.
Team 2: Name of team 2.
(Team 3): Name of Team 3. If used.
(Team 4): Name of Team 4. If used.
Tied message: If at the end of the round if any number of teams are tied for first place.
Team 1 victory message: Message displayed if team 1 wins.
Team 2 victory message: Message displayed if team 2 wins.
Team 3 victory message: Message displayed if team 3 wins.
Team 4 victory message: Message displayed if team 4 wins.
For example to make the team 1 victory message: 

"Team 1 soundly whoops the butts of Team 2".
"*t1 soundly whoops the butts of *t2". 

The *t1 and *t2 are replaced with Team 1's and Team 2's names.
Limit Join Period: You can choose to limit the amount of questions which a person must have joined a team by. Or simply leave it not depressed and have no limit.



Themes dialog.
Allows certain !themes to be added, the themes themselves are rather simple, when set they allow for a different number or questions, question file, and an option to use team mode with this theme.
To be accessed, for example if you allow a scramble theme to use the scramble.txt question list provided with this release.
!trivia scramble, by a patron or yourself would start it up with the scramble.txt question file.
Add button, adds a theme, you shall be prompted for name, round, questionfile, and whether you'd like this to be a team game.



Patron commands:
Command ----------- Function
!help ------------- Provides help on the commands to the patron.
!strivia ---------- Stops trivia
!trivia ------------ Starts trivia.
!trivia x --------- x must be a number. 
!trivia Unlimited - For an unlimited question round.
!trivia Team ------ For team mode.
!trivia Team # ---- For a specified sized team game.
!hint ------------- Gives a hint
!vowels ----------- Gives the vowels of the answer.
!last ------------- Gives the last letter of the answer.
!words ------------ Gives the number of words in the answer.
!join x ----------- Joins a team, must be in team mode, x can be a 1 or 2 or (3 or 4) in 4 team mode.
!add -------------- Allows patrons to add questions
!report ----------- Lets you report problems with the questions
!triviaping ------- Checks the lag from the bot
!version ---------- Displays the version of this bot
!hof <unit> <time>- Displays the hall of fame, for <score|streak|time|wpm> of time <day|week|month|year>
!hoffast ---------- Displays speed hall of fame
!hofstreak -------- Displays streak hall of fame
!hofwpm ----------- Displays words per minute all of fame
!hofscoreday ------ Displays top scores for the day.
!hoftimeday ------- Displays top times for the day.
!hofstreakday ----- Displays top streak for the day.
!hofwpmday -------- Displays top words per minute for the day.
!hofscoreweek ----- Displays top scores for the week.
!hoftimeweek ------ Displays top times for the week.
!hofstreakweek ---- Displays top streak for the week.
!hofwpmweek ------- Displays top words per minute for the week.
!hofscoremonth ---- Displays top scores for the month.
!hoftimemonth ----- Displays top times for the month.
!hofstreakmonth --- Displays top streak for the month.
!hofwpmmonth ------ Displays top words per minute for the month.
!hofscoreyear ----- Displays top scores for the year.
!hoftimeyear ------ Displays top times for the year.
!hofstreakyear ---- Displays top streak for the year.
!hofwpmyear ------- Displays top words per minute for the year.
!promotion -------- Displays next military promotion and points needed for it
!server ----------- Displays the bot's server
!record(s)--------- Displays the record time and streak
!champ ------------ Displays the champ
!pause ------------ Pauses the current round.
!resume ----------- Resumes the current round.
!repeat ----------- Repeats the question
!next ------------- After half the time has expired allows a person to timeout the question early.
!themes ----------- Displays available themes
!stat(s) ---------- Returns the patron's current rank, score, best time, best streak.
!stat(s) <name> --- Allows !stats for other players.
!stat(s) # -------- Allows the bot to call the stat of a specified rank.

Operation Commands:
!op find <text> - Finds text.
!op add <question*answer> - Adds a question and directly to the main question file.
!op ban <user> - Bans a user.
!op unban <user> - Unbans a user.
!op ask <#> - Asks given question.
!op banned -- Lists banned individuals
!op enable ---- Enables the bot.
!op disable --- Disables the bot.

Categories:
general questions...
#general
sports questions...
#sports
animal questions...
#animal
The categories work like so, determining the category by the closest #category at the bottom.

Features:
Answer hashing routine to fix some typos. It's trivia not a Spelling B. Auto-enabled.
Options dialog to quicky adjust the settings on the bot.
Team mode; when somebody types "!trivia team"
Choice between 2-team and 4-team game.
Customizable team mode end messages to allow you to set up themes to your trivia bot.
Question logging to stop any question from repeating itself in a round.
Advanced high score ranking system that allows anybody to know their rank (!stats) out of hundreads of scores.
Flawless sorting of the high score entries.
Scores based on Streak, Time, Words per minute and of course Score.
Customizable award triggers, messages, and commands for most events on the bot.
Allows unlimited question rounds.
Allows any number of secondary answers.
Unlike other trivia bots this one allows the trivia bot itself (you) to play.
Scramble: Jumble-like play. Could make the entire bot do scrambles by making the entire question file like "Scramble*Hi All"
Total: Give every responce to given category. Question format: "Total: integers between 2-7*3*4*5*6"
Multi: Pick the answer out of a multiple choice entry. Question format: "Multi: 2 + 2 =*1*2*3*4*5*6"
Bonus: Allow certain questions to be worth an given number of points. Question format: "20: Pi (to 4 after decimal)*3.1415"
Themes: Let you're people choose what type of game they play.
HTMLBuild: Allows automatic score update to the web.
Day, Week, Month, Year high scores for score, time, streak, wpm

Fixes in 3.53
Few more spelling errors.
Auto.check.strip bug. Thanks akai
Nonnumq update/fix
Qfile update to fix space in directory name error.

Fixes in 3.52
Sped up sort routine. Should fix major lag some people had.
Sped up getvar routine. Should fix general lag here and there.
%c2o $c2o fixed. Caused some award issues.
Moved awards to process awards section. (No real change)
$plot fixed. Never really worked before.
Spelling mistake 'responses' thanks Duvalier
Fixed error in Sunday week feature. Changed default.
Uword fix, actually functions now.
Restored kill streak on strivia.
Added option Show None. To help protect question files.
Added button for keep ask feature.

Fixes in 3.5
Added on join to command tab.
Upped time on %ident (precausion against unset).
Htmlbuild speedup, for versions 6.14+ of mIRC.
Htmlbuild bug fix for time scoreby returning total rather than intended result.
Ending with '.', ':', '!' no longer append ?. Thank's tom-g.
Described awards on channels.
Blank lines no longer count as questions.
Multi questions need to use a comma rather than just a space. Natural spaces confuse.
Rounds hint down instead of up.
If no new information is going to be given in the next hint, hint isn't shown.
$strip added to process command routine.
Team mode now gives normal finish as well as team score info.
Add on/off for ranks now also in the ranks dialog.
Double personal hints by different, to the channel. Would repeat, now fixed.
Answer message now shows current rank.
Previously added in answer message for last rank, if uprank is triggered.

If there is a feature that you would like to see added,
any questions, comments, bugs or compliments:

- http://tatarize.com forums are setup to serve.
		It's the best way to contact me.

Good Luck.
		Tat.