MoxQuizz

In other languages: English | Afrikaans | Albanian | Arabic | Brazilian | Bulgarian | Catalan | Chinese | Croatian | Czech | Danish | Dutch | Esperanto | Estonian | Filipino | Finnish | Flemish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Latvian | Lithuanian | Macedonian | Malay | Malayalam | Norwegian (Bokmål) | Norwegian (Nynorsk) | Persian | Polish | Portuguese | Romanian | Russian | Serbian | Slovak | Slovenian | Spanish | Swedish | Turkish | Ukrainian | Urdu

General Description

MoxQuizz is a multilingual quiz/trivia script for IRC built for eggdrop bots. It started as a clone of HSE's quizbot, but quickly grew to an independent program with own features. You can see it running in channel #quiz and #quiz.de on irc.dal.net.

MoxQuizz acts as a game master playing a quiz/game of trivia in a channel of you choice. Normally, a question is posted to the channel and all chatter is searched for the answer. If something matches an answer or an optional regular expression, the user who said it receives a score. The high-score table will be printed regularly (at each third of the game). When a player reaches a certain score, he wins the quiz and the rankings will be reseted. His/her score is recorded in the allstars table, too.

You can use your own question files (they are always welcome to be included in future distributions, note that the current database is based on such files). See the README.database for a description of the file format, it's quite straight forward and editable with any text editor. The bot comes with several databases and message sets:

MoxQuizz was completely written from scratch.

Though it is quite stable, you may encounter bugs. See the README[1] for more information about the available commands (README[2] for the fun commands) and the NEWS for a list of recent changes.

MoxQuizz has a place at freshmeat.net and a sourceforge project page

Stable versions

• 2003-07-20 Media:moxquizz-0.8.1.tar.gz (gpg-sig)
• 2002-07-05 Media:moxquizz-0.8.1-rc1.tar.gz (gpg-sig)
• 2002-02-02 Media:moxquizz-0.8.0.tar.gz (gpg-sig)
• 2001-06-26 Media:moxquizz-0.7.3.tar.gz (gpg-sig)

You can download here.

Installing

You might need some experience with eggdrop to install the bot, but it should not be too much ;) If you experience any trouble feel free to email me (moxon@meta-x.de). And yes, my english is really bad :(

0) Preparing eggdrop

Get and install a copy of eggdrop. Read it's readmes to get familiar with it it you aren't. Maybe you wish to increase NICKMAX. In eggdrop.h if you compile yourself, such that users joining with nicks longer than the standard length of 9 will be recognized by the bot. Depends on the net you wish to place the bot in.

Though MoxQuizz once was developed for an eggdrop version 1.4.3, it requires at least eggdrop version 1.6.8 compiled with TCL 8.3.2 or later. If you don't have those versions, please use the old version 0.7.3 of MoxQuizz.

1) Preparing yourself

Read the README file.

2) Make sure you are Prepared

Give your best to understand the README.

3) Upack the distribution

Just unpack MoxQuizz into a directory containing eggdrop. There should then be a subdirectory called "moxquizz-...." and a link "moxquizz", containing all relevant files.

4) CONFIGURATION of MoxQuizz

• 1. Eggdrop

You have to setup an eggdrop configuration file. Getting eggdrop to run is the hardest part of the installation. I provided a configuration file for eggdrops, almost ready to use: moxquizz.conf. You only have to change some variables: change at least IRC server, channel bot admin, bot owner and the nick of your bot. If you have perl installed on your system, you can use supplemental/setup.pl which does the setup for you.

IF your shell is from a shell provider, you normally have got some generated config from your provider. In this case, simply add the following lines to it and restart/rehash your bot.

source moxquizz/moxfun.tcl

source moxquizz/moxquizz.tcl

• 2. MoxQuizz

Then you have to edit moxquizz.rc, where all the configuration for the quiz is done. There is a single variable you want to change (but you have read README, so you already know which):

quizchannel

If you registered your bot with a nickserv, adjust $nickservpass, $nickservtext and $nickservmask in moxtools.tcl (look for "nickserv identification"). Make sure moxtools.tcl is loaded from your eggdrop config file (source it alike moxfun.tcl above). If not, forget about moxtools.

5) INITIALIZE THE EGGDROP USER RECORDS.

Start with ./moxquizz.conf -m or eggdrop moxquizz.conf -m and identify yourself to the bot to become the master.

6) Restart without -m and give you at least the flags P and Q to be able to control the bot. To do this, you have to log into the partyline of the bot. First set a password by

/msg <botnick> pass <your password> Then initiate a DCC CHAT with you bot and log in (either "/dcc chat <botnick>" or "/CTCP <botnick> CHAT". Inside the bot say: .chattr <yourhandle> +PQ to get the flags.

7) Finally, if you got that far, you are done.

Simply wait until you bot joins your channel, then say !ask there to start the quiz (can take some seconds, since eggdrop might need to set its message queues up). Optionally tell the bot to initialize (not needed, since all initialization is done automatically. It just prints some startup message to the channel) by saying inside the partyline: .!init

8) Enjoy!

Report any trouble to moxon@meta-x.de.