StartersQuiz
Language files version 2 now available!
NEW VERSION UPDATED, LOOKING FOR TRANSLATORS. If you find some bugs please submit a ticket! Click here to start translating
Donate if you appreciate the work as it costs a lot of time and effort to create this plugin. If not then I hope you let other people know about my work.
Description
StartersQuiz is a plugin that lets players do a quiz before they can actually do anything on the server. This includes Block-Breaking, Blockplacing and chatting at the moment but might get more later on. Players have to answer question that the admin has set up. You can make either Multiple-choice questions or question where players have to fill in something (Multiple-choice recommended).
Features
- Blocking certain abilities for players who have not finished the quiz yet.
- Configurable quizes
- Multiple quizzes
- Players can retry their current quiz.
- You can configure the maximum amount of attempts per quiz and default.
- Instead of the right amount of questions, you now have to configure the percentage to pass.
- It automatically checks whether a player passed or not.
- Permissions support
- Configure if a player has to be promoted to a different group when finsished.
- Configurable ban time in seconds, minutes, hours, days and weeks
- Blocked actions can be configured
- Players can answer without using the /sqanswer command. (Can be configured, default: false)
- You can reward players with money and items
- You can remove permissions from a player
- You can give players permissions
- Players can be permanently banned now
- Multiple bantimes can be configured
NOTE: Permissions are added and removed to and from each world apart, no global permissions are being used.
NOTE2 (For Groupmanager users): StartersQuiz only promotes to the group in the current player's world. Use GroupManager's mirroring to promote in other worlds too. Another way is too make different quizzes for different worlds if you do not (want to) use mirroring.
Planned Updates
Permissions supportConfigurable limited amount of attemptsConfigurable action when a player does not pass the quiz.When you extend the quiz and the player wants to retry, let him retry from where he finished before he had to do it again instead of the whole quiz.Add the possibility to add a player to group.And also the possibility to add permission to the user only.
Possibilty to make more than one quiz/testAdd a reward, items or money
Version 3 updates
- Re-configure commands
Add a /sqreload command- An overview for players (and admins) to view the results etc.
Let me know when you have some more ideas.
How To Install StartersQuiz
Installing StartersQuiz is very simple. Unpack StartersQuiz.zip and create new quizes like the one in the quizzes folder. Take a look at the example as it shows you how to configure the quizzes.
You also need Vault in order to let it work. To be sure you have the latest version of vault go to Vault's own BukkitDev page.
Commands
- /sq or /sqhelp - Show the help page/commands.
- /sqstart - Start the quiz
- /sqquestion - Show the current question.
- /sqanswer [A|B|C|etc.] - Give an answer to the question.
- /sqretry - Retry the quiz
- /sqreload - Reload the plugins files
Permission nodes
- sq.help - Gives access to the '/sq' and '/sqhelp' commands
- sq.start - Gives access to the '/sqstart' command.
- sq.question - Gives access to the '/sqquestion' command
- sq.answer - Gives access to the '/sqanswer' command
- sq.retry - Gives access to the '/sqretry' command
- sq.quiz - Gives you all of the above permissions. (NOTE: if the plugin does not work try to add the above permissions instead of this one)
- sq.quiz.[Quiz name] - Gives the user or group this quiz (You can only give one quiz to a group/user.
- sq.exclude.[Quiz name] - Excludes player or group from the specified quiz.
Do NOT use sq.* as it will also exclude you from a quiz. Instead use 'sq.quiz' to give a player or group all the quiz permissions and commands. OPs are always excluded so if you want to test you have to give the right permissions to a test group or something like that. And last but not least, permissions are CaSe-SeNsItIvE so check you quiz names before giving permissions.
Known Bugs
- With the current config QuestionsEveryXsec does not work. Change Questions to Question. The option should be QuestionEveryXsec.
- You have to add a possible answers at your quizzes at Answers. To leave it blank add - ' ' that prevents the plugin to give you errors on the server.log file.
- Please submit ticket when you find one (or more:))
how old are these plugins on bukkit going to get sigh?
Much thanks!
Is this plugin abandoned? If not I have a idea, a quiz should start after a player has played for a set amount of time, so players are experienced before trying the quiz that will grant them full membership.
@SilentDragonK
That error is weird actually. Also the NoQuizMessage bug is well know.
This afternoon I started remodeling the plugin. I want to re-code the whole plugin so I can get rid of all the bugs, add some new functionality and make it easier for me to update the plugin in the future. It may take some time to do all that work but soon there will be a StartersQuiz version 3.0.
KR Sluijsens
I have NoQuizMessage: true in my config File, but I still get StarterQuiz messages when i change the World or after a login
When i start the Quiz and answere the Questions i get the following Error:
but it works anyway oO (The User gets no Error, recives the Items and gets the Pex Rank) hope you fix this soon :)
@Sluijsens
You get the StartError even when you bump into an anvil and it bumps you back.
@ProsperCraft
NoQuizMessage should take care of this. But as you said it isn't working. I am taking a quick look at the moment.
The reason you get this message is because it checks for quizzes every time you teleport (Warping, Joining other world etc.)
KR Sluijsens
Every time our players(and ops) warp we would see StartError: You either are excluded from this quiz or you have already finished it.
I tried to comment the line out, but then it would cause exceptions.
I added the permission for /sqreload and when I ran it I got this..
I got everything to work now, but realized that the PromoteToGroup: member does not work with permissionsex, am I missing something? I got the message GroupManager disabled when it tried to promote the user.
On a side note, if you added the ability to run a command it wouldn't matter what permissions plugin we use.
To get around this for now, we have a room the beginner group starts in that has a button that is linked to command blocks that promote them and teleport them, and the plugin keeps them from being able to push it till they pass.
@ProsperCraft
Executing a command should be possible to implement. NoQuizMessage has to be set to true to work and the permission for reloading should be sq.reload.
As more questions come and this plugin gets outdated I shall fix the bugs and update the plugin and this page to the current bukkit version.
Kr Sluijsens
NoQuizMessage: true does not seem to be working, all users get the message about being exempt if it is true or false.
also what is the permission for admins? I can't even do /sqreload from the console, or op.
Can you make it execute a command? like warp them to /spawn after they complete the quiz and get promoted?
@ProsperCraft
That's right, it should be give. Thank you.
Typo- Do NOT use sq.* as it will also exclude you from a quiz. Instead use 'sq.quiz' to gove a player or group
I think gove should be give.
@Sluijsens
Thanks for the quick response!
@MrPokeDSDude
I am afraid this isn't an option in this plugin. You can only assign 1 group to a quiz.
Kr sluijsens
This is a really cool plugin but I was wondering, is there a way to say if a person puts a certain answer they get moved to a different group in permissions or gets a different reward to someone who put a different answer?
any github lib???