BogusTrivia Installation

Install BogusTrivia the Ultimate TCL Trivia Script

The following information can be found in the BogusTrivia Readme files included in the packaged script. A new installer has been implemented to provide smooth installations with both new installs and upgrades. Follow the directions below which match your installation type. While every effort has been made to provide an easy error free upgrade it is recommended you backup your existing install of BogusTrivia.
The instructions for Windrop installations are the same as Eggdrop with the exception of having to set file permissions.

!! WARNING !!

The installation instructions below are NECESSARY in their ENTIRETY. This release of BogusTrivia requires ALL NEW FILES. If you are upgrading from a previous version of BogusTrivia backup your current installtion.

It is assumed you have a working Eggdrop or Windrop installed and running. BogusTrivia uses a database which can become quite large depending on how many questions you wish to add. Many shell providers offer additional space at a nominal charge. If your are running BogusTrivia on a Windrop space is limited only by your hard drive capacity or 1 million questions.

New Installation Eggdrop & Windrop

1. You need to set the following Permissions on the directories below:
    a.  you have to chmod 711 on your home directory.
    b.  you have to chmod 700 on eggdrop (or whatever you have named your bot folder.)

2. Log into you shell. At the prompt use the commands below to set file permissions as shown below. Failing to set the correct file permission will prevent BogusTrivia from writing the files it needs to.

Examples:
Setting File Permissions:
    a.  chmod -R 700 eggdrop
    b.  chmod 711 while in the home directory of your shell.

3. Add this line to your bots conf file.. source scripts/t-2.tcl and upload.
4. Unzip the contents of BogusTrivia to your computer.
5. Open the t-2.settings.tcl and set your channel & game options.

6. Upload the following files to your bot's /scripts directory:
     t-2.tcl :Main BogusTrivia tcl game script
     t-2.commands.tcl :Extended BogusTrivia commands tcl
     t-2.settings.tcl :BogusTrivia Script Settings tcl (Set All Game Options Here!)
     bogus.ques.sample :Sample questions (or some other question files)

7. Restart your bot.

8. Add Questions to Create the Database:
Using the /msg command, message your bot with one of the .add commands.
.add is sufficient if you're adding the included question file or files with *triv* in the filename. Follow the message window as the script may ask for user input. It may have you verify by sending you 3 examples from the file you're adding. You will need to answer yes or no {or: y or n}.

Note: If you are adding multiple question files and You're Sure They're ALL The Same Format, you may answer using "yes all" {or: y a}. The script provides error correction and creates a file called t2.badqes, these are broken Q&A and may later be edited or discarded as you wish.

9. Mix the Question database using one of the mixing commands:
The default .mix will mix the question & kaos files 4 times.

Note: Extra large databases may not mix well and stall the bot. This is NOT a BogusTrivia issue. The issue occurs when mixing large databases causes you bot to exceed your shells process load limit.

10. Starting the Game:
The command to Start & Stop the Trivia is now optional. The default on/off triggers are .t2/.t2off and may be changed to anything you like in the t-2settings.tcl This is a public command used in the channel and you may set user access by flags in the t-2.settings.tcl to minimize abuse.
NOTE: As always this script is designed to work out of the box. Other then setting your channel and choosing a theme in the t-2.settings.tcl this script will run optimally as default.

Upgrade Installation Eggdrop & Windrop

1. Backup your existing BogusTrivia installation.
2. Unzip the contents of BogusTrivia to your computer.
3. Open the t-2.settings.tcl and set your channel & game options.
4. Upload the following files to your bot's /scripts directory:
     t-2.tcl :Main BogusTrivia tcl game script
     t-2.commands.tcl :Extended BogusTrivia commands tcl
     t-2.settings.tcl :BogusTrivia Script Settings tcl (Set All Game Options Here!)
5. Rehash your bot.
Note: You will receive the message: (Quit: BogusTrivia script update: Bot must be restarted!)
6. Restart Game Play.