TBtriv Home Page
Author: Troy Parry (TroyBoy on AustNet)
Web: http://www.oocities.org/troyparry/tbtriv/
Script: TBtriv v1.3 (released 29th January 2005)
TBtriv v1.31 (updated 8th February 2005 – release notes below)
TBtriv v1.32 (updated 22nd February 2005 – release notes below)
Features:
1. Highly configurable options
2. Menu driven configuration
3. Remote
Admin module to remotely control your Trivia Bot
(from the channel and/or DCC chat)
4. FTP module to upload weekly/monthly scores to a web server
5. MEGA bonus and Jackpot questions
6. Lengthy KAOS questions
7. Multi Answer capable
8. Multi Session compatible
9. True Row streaking
10. Row Bonus’s
11. User Rating’s
12. 10 different styles for each Channel Hint and Private Hint
13. Random question asking (Based on number of questions)
14. Sequential question asking (1 from each file)
15. 20 configurable adverts
16. Fast, WPM, Row, best week, best month records
17. Inbuilt !seen script
18. Comes with 150,000 questions
19. Auto-stop on play inactivity, auto-start on player join
20. Shows you how many points needed to catch the next player ahead
Download TBtriv v1.32:
TBtriv v1.32 new install – click here
TBtriv v1.32 (packaged with mIRC 6.16) – click here
TBtriv v1.32 mrc script (for people upgrading from v1.3x) - click here
(Copy over the old script and start mIRC)
Install Instructions for
new install:
TBtriv v1.32 new install instructions
The file structure of TBtriv132_full.zip:
|
TBtriv_v1.3\TBtriv.mrc |
The actual Trivia script |
|
TBtriv_v1.3\TbtrivRemoteAdmin.mrc |
Script to allow users to remotely manage |
|
TBtriv_v1.3\TBtrivUploadFTP.mrc |
Script to auto-upload scores via FTP |
|
TBtriv_v1.3\help\ |
Location of this help file |
|
TBtriv_v1.3\html\ |
Location of html weekly/monthly scores |
|
TBtriv_v1.3\ini\ |
Location of all settings/stats |
|
TBtriv_v1.3\questions\ |
Location of all questions files |
1. Unzip
Tbtriv13_full.zip (any location you like).
Eg, to “c:\program files\mIRC\”
Files will unzip to the TBtriv_v1.3\ directory.
2. To
load the script, type this command from mIRC:
/load –rs1 “(your chosen folder)\TBtriv_v1.3\TBtriv.mrc”
eg, /load –rs1 “c:\program files\mIRC\TBtriv_v1.3\TBtriv.mrc”
3. Click “yes” to allow the script to load.
4. A menu will popup. Enter the Trivia channel name.
5. Enter the network name that your channel name is on.
6. Change the settings, adverts and colours if necessary.
7. Once you are done, click “SAVE”.
8. From
the mIRC “commands” menu, or from a mouse right-click,
select “TBtriv v1.3” >> “start trivia” to start the trivia.
Question file formats:
All questions files must be put into the questions\ folder.
Regular questions must be named yourfilename.txt
The KAOS questions file MUST be named questions.KAOS
The MEGA questions file MUST be named questions.MEGA
Questionfiles.txt & Questions.MEGA
The format is: Question*Answer
Eg, Music! Madonna sang: Like a __________ ?*prayer
Questions.KAOS
The format is: Question*answer1*answer2*…answer99
Eg, KAOS: Name all the colours of the rainbow*red*yellow*pink*green*purple*orange*blue
You could have dozens of answers
(limit not tested – as long as the length doesn’t exceed approx 940 chars).
TBtriv Main Menu
|
Menu Item |
Description |
Default |
|
Channel |
Your trivia channel name |
#mychannelx |
|
Network |
The network your channel is on |
AustNet |
TBtriv Row Bonus Menu
|
Menu Item |
Description |
Default |
|
Enable/Disable Box |
Enable/Disable the Row Bonus |
Ticked |
|
Row |
Issue a Bonus1 after “x” in a row |
3 |
|
Points |
Issue “x” points after “x” in a row |
500 |
|
Say |
Says “blah” after “x” in a row |
Well done! |
TBtriv User Ratings Menu
|
Menu Item |
Description |
Default |
|
Questions Answered |
The number of questions someone needs to answer in order to progress to this rating |
10,50,100, 250,500, 1000,2500, 5000,10000 |
|
Rating Name |
|
Level1,2,3… |
TBtriv Statistics Menu
|
Menu Item |
Description |
Default |
|
Current Jackpot Amount |
The total amount currently in the Jackpot |
NA |
|
Jackpot will go off at |
The amount the jackpot will go off at |
NA |
|
MEGA Bonus will go off after |
How many questions need to be answered before the MEGA goes off |
NA |
TBtriv Force a Question Menu
|
Menu Item |
Description |
Default |
|
Question |
The question you wish to ask |
NA |
|
Answer(s) |
The answer(s) separated by * |
NA |
|
Normal/MEGA/KAOS |
The type of question to trigger off |
Normal |
TBtriv Hint Style Menu
|
Menu Item |
Description |
Default |
|
Private Hint style |
Set the style of the reply for when someone asks for a private hint |
Last char of each word |
|
Hint1 style |
Set the style of the Hint1 |
All hidden |
|
Hint2 style |
Set the style of the Hint2 |
First char of each word |
|
Hint3 style |
Set the style of the Hint3 |
All vowels |
TBtriv Question Files Menu
|
Menu Item |
Description |
Default |
|
File Pick Method |
Set the style of the how questions will be picked |
Random |
TBtriv Points Menu
|
Menu Item |
Description |
Default |
|
Scoring units |
Eg, “points”, or “kisses” etc |
Points |
|
MEGA between |
A MEGA bonus will go off somewhere between this range of Qs answered |
300-1000 |
|
Jackpot between |
A Jackpot will go off once it reaches a random amount between this low-high value |
25000-50000 |
|
Lowest NORMAL score |
The low range for normal questions |
250 |
|
Highest NORMAL score |
The high range for normal questions |
1000 |
|
Bonus1 score |
The amount for bonus1 |
1000 |
|
Bonus2 score |
The amount for bonus2 |
1500 |
|
Bonus3 score |
The amount for bonus3 |
2000 |
|
Bonus4 score |
The amount for bonus4 |
4000 |
|
MEGA Bonus score |
The amount for the MEGA bonus |
25000 |
|
Jackpot receives |
The amount of points that the jackpot will receive from unanswered questions |
5 (%) |
TBtriv Options Menu
|
Menu Item |
Description |
Default |
|
Enable !pingme command |
Enabling the !pingme command will let users determine their lag with the bot |
Ticked |
|
Start trivia on channel join |
Enable this to start trivia once you join the trivia channel |
Ticked |
|
KAOS enabled (1 in x chance) |
Enabling this will allow the use of KAOS questions. The value of “x” means there will be 1 KAOS per “x” normal questions asked (on average) |
Ticked (20) |
|
Autovoice record holders |
When a record-holder joins the trivia channel, the bot will auto voice them |
Ticked |
|
Allow hint |
Allow users to use ~ for private hints |
Ticked |
|
Charge for ~ Hint (%) |
Charge people “x”% for ~ hints |
Ticked (10) |
|
Echo private answer to channel |
Privately echo the answer to the bots trivia channel after each question |
Ticked |
|
Show answer on timeout |
If enabled, the answer will be revealed when nobody gets the question correct |
Ticked |
|
Score reduction after hints |
The score will reduce by 1/3 after each hint is issued |
Unticked |
|
Lenient answering |
If this is enabled, then the bot will ignore any non-alpha numeric characters |
Ticked |
|
Show Welcome on join |
If this is enabled, the bot will send a welcome message to the channel when someone joins (best to disable in channels with 100+ users) |
Ticked |
|
Show Mystats on join |
If this is enabled, the bot will send a !mystats <nick> to the channel when someone joins (best to disable in channels with 100+ users) |
Ticked |
|
Special character |
The character used for special commands like “pingme” and “stats” |
! |
|
Hint character |
The character used when asking for a private hint |
~ |
|
Reset Questions counter |
You can choose to have the questions counter reset at the end of the week or month or never |
Never |
TBtriv Adverts Menu
|
Special Advert Variables |
Description |
|
TOPWEEK |
Displays the Weeks Top 10 scores |
|
TOPWEEKBEST |
Displays the Top 10 players best scores in a Week |
|
TOPMONTH |
Displays the Months Top 10 scores |
|
TOPMONTHBEST |
Displays the Top 10 players best scores in a Month |
|
LASTWEEKTOP3 |
Displays last Weeks Top 3 scores |
|
LASTMONTHTOP3 |
Displays last Months Top 3 scores |
|
OWNER |
Displays the owner of the script and the url to this website |
|
TOPROW |
Displays the Top 10 row records |
|
RECORDS |
Displays the all-time records |
|
RESETTIMES |
Displays the weekly/monthly reset times |
|
TOPPOINTS |
Displays the Top 10 players all-time points winnings |
|
STATS |
Displays the trivia statistics |
|
TOPSPEED |
Displays the Top 10 best WPM speeds |
|
TOPFAST |
Displays the Top 10 fast answer records |
|
TOPMEGA |
Displays the Top 10 MEGA bonus records |
|
TOPJACKPOT |
Displays the Top 10 Jackpot records |
NOTE: These special commands have the same output as using them from the channel.
E.g. !stats or !records etc.
Tbtriv Colours Menu
|
Menu Item |
Description |
Default |
|
Question |
The colour of the question |
1,9 |
|
KAOS Points |
KAOS and normal question Points colour |
12 |
|
KAOS Total Points |
KAOS Total points colour |
4 |
|
Bonus Points |
Bonus points colour |
0,4 |
|
MEGA Bonus |
MEGA bonus colour |
1,13 |
|
Top 10 Primary |
Top 10 primary colour |
1,8 |
|
Top 10 Secondary |
Top 10 secondary colour |
0,4 |
|
Question Count |
The colour of the question count – left of the question |
8,4 |
|
Advert Colour |
The colour of the adverts (except special adverts) |
1,8 |
|
Answer Primary |
The primary colour of the answer |
04 |
|
Answer Secondary |
The secondary colour of the answer |
12 |
NOTE: The colour codes are the same as the ones used in mIRC (control-k)
The format is (foreground),(background)
Tbtriv Timing Menu
|
Menu Item |
Description |
Default |
|
Secs between questions |
The gap between asking questions |
10 |
|
Secs between Q and Hint1 |
The gap between the question and Hint 1 |
0 |
|
Secs between Hint1 and 2 |
The gap between Hint 1 and 2 |
15 |
|
Secs between Hint2 and 3 |
The gap between Hint 2 and 3 |
15 |
|
Secs between Hint3 and end |
The gap between Hint 3 and the time up |
25 |
Tbtriv Menu:
You can access the Tbtriv menu by right-clicking the mouse in the status/channel window.
Tbtriv Main Menu
This will popup a window with options described earlier
Tbtriv Home Page
This will connect to the internet and load the Tbtriv home page
Reload Questions\*.txt files
You need to reload the questions files if:
1. You
added/deleted/changed questions from an existing questions.txt file and
you want those questions to be included now
2. You deleted an existing questions.txt file that’s currently loaded into memory
3. You added a new questions.txt file that you want included now
When mIRC starts, all the *.txt files in the Questions folder will be loaded.
If you don’t want some
questions.txt files loaded, then rename them to something
other than .txt (eg, questionsfile.inactive)
When you reload questions, the
old ones are removed from memory first, then the
new ones are loaded (any *.txt in questions\)
The reason why it is loaded into
memory is to reduce the occurrence of questions being
asked more than once. After a question is picked from memory, it is deleted.
Once a file has had all the questions removed from the file in memory, the file
is
then reloaded into memory.
Force A MEGA Bonus
This will force a MEGA Bonus question to be asked next
Force the Jackpot
This will make the jackpot go off when the next question is answered correctly
Help
This will launch the Tbtriv.htm file from the help\ folder
Reset > Weekly/Monthly Scores
The following things will happen:
1. A html file will be created from the existing Top 20 weekly/monthly scores
2. The Weekly/Monthly scores will be erased
3. The html file will be uploaded via FTP (if TBtrivUloadFTP.mrc is loaded)
FTP Module
You can manually upload the last
weeks/months html file if for any reason it
didn’t work during the automatic weekly/monthly reset
You can read the TBtrivUploadFTP.mrc for setup information (required)
Remote Admin Module
If this script is loaded, then
you can grant access to people (level 50)
Once someone has access, they can remotely issue commands for your Trivia Bot
to follow.
To give/remove someones Remote
Admin access, right click on their nick and select it
from the Remote Admin menu. See below for detailed Remote Admin commands.
Unload TBtriv
Unloading the TBtriv.mrc script does not delete any files, settings or statistics.
Unloading TBtriv.mrc will perform the following:
1. Stop any game in progress
2. Stop any Trivia timers
3. Unload questions files from memory
4. Unset all %TBtriv* variables
5. Unload the script from memory
To load the script again, you can type:
/load –rs TBtriv_v1.3\TBtriv.mrc
NOTE: If you would like to start the game with default settings/scores, then delete all the files in the
Ini\ folder before loading the script.
REMOTE ADMIN COMMANDS:
|
Command |
Description |
Level |
Chan |
DCC |
|
.chat |
Requests a DCC chat with the bot |
ALL |
ü |
û |
|
.pass <password> |
Authenticate to the bot in DCC chat |
ALL |
û |
ü |
|
.help |
Shows this help |
ALL |
ü |
ü |
|
.op <nick> |
Op <nick> in #channel |
50 |
ü |
ü |
|
.deop <nick> |
Deop <nick> in #channel |
50 |
ü |
ü |
|
.voice <nick> |
Voice <nick> in #channel |
50 |
ü |
ü |
|
.devoice <nick> |
Devoice <nick> in #channel |
50 |
ü |
ü |
|
.kick <nick> [reason] |
Kick <nick> from #channel |
50 |
ü |
ü |
|
.ban <nick> [reason] |
Ban <nick> from #channel |
50 |
ü |
ü |
|
.unban <address> |
Unban <*!*@*> |
50 |
ü |
ü |
|
.stop |
Stop trivia |
50 |
ü |
ü |
|
.start |
Start trivia |
50 |
ü |
ü |
|
.join |
Join #channel |
50 |
û |
ü |
|
.part [reason] |
Part #channel |
50 |
û |
ü |
|
.records |
Recalculate records |
50 |
ü |
ü |
|
.questions |
Unload/Reload Questions\*.txt files |
50 |
ü |
ü |
|
.hop |
Part/join #channel |
50 |
ü |
ü |
|
.ignores |
Shows a list of all addresses being ignored |
50 |
û |
ü |
|
.ignore <nick> |
Ignore <nick> |
50 |
ü |
ü |
|
.unignore <nick> |
Unignore <nick> |
50 |
ü |
ü |
|
.status |
Shows current server/connection info |
50 |
û |
ü |
|
.who |
Shows a list of all authenticated admins |
50 |
û |
ü |
|
.broadcast <message> |
Sends message to all authenticated admins |
50 |
û |
ü |
|
.msg <nick> <message> |
Sends message to <nick> (if authenticated) |
50 |
û |
ü |
|
.server <address> [port] |
Connect trivia bot to server <address> |
100 |
ü |
ü |
|
.ftpweek |
FTP last weeks top20 |
100 |
ü |
ü |
|
.ftpmonth |
FTP last months top20 |
100 |
ü |
ü |
|
.resetweek |
Reset the weekly scores |
100 |
ü |
ü |
|
.resetmonth |
Reset the monthly scores |
100 |
ü |
ü |
|
.removeplayer <nick> |
Remove all stats for <nick> |
100 |
ü |
ü |
|
.command <command> |
Runs any command from the bot |
200 |
ü |
ü |
|
.admins |
Shows a list of all created admins |
200 |
ü |
ü |
|
.close <nick> |
Closes <nicks> DCC chat |
200 |
ü |
ü |
<> = Mandatory [] = Optional
EXTRA NOTES:
1. TBtriv will only work with mIRC versions 5.91 and above (tested up to version 6.16.)
2. Typing from the trivia session will cause lag. Keep typing to a minimum.
3. The
weekly scores reset automatically. The script install time is used for the
weekly reset time.
You can reset the time from the TBtriv v1.32 menu >> reset >>
weekly scores
4. The Monthly scores reset automatically. The calendar month is used for the reset time.
5. You cannot break records while playing from the trivia bot session.
6. You
can now open several mIRC sessions without it affecting Trivia. If you connect
to the same
network more than once, the Trivia script will play from the first session
opened.
7. Currently, this may not work if you are using the Remote Admin script.
TBtriv v1.31 Release Notes:
1. Fixed the weekly/monthly reset (the html count was always resetting 1 instead of incrementing)
2. !stop
is now !stop <bot> (and !start <bot>)
This is to allow multiple bots in the same channel (eg a backup bot)
3. Changed the Remote Admin script to include different access levels
4. Added a dozen extra Remote Admin commands
5. Added the ability to list all Remote Admins from the menu
TBtriv v1.32 Release Notes:
1. When
a player answers a question correctly, they are showed how many points are
needed
to catch the next player ahead of them (up to the top 100 positions)
EOF