Getting Started
After installing the plugin, get started by making your first Quest. There are 2 types of commands: /q for the Quest user commands and /qa for the admin commands, which we will use to create the quest!
To create your first quest type: /qa create <Quest Name>
Once all your Quests are created, you have to give the players the following permission: notnot.quests.use Otherwise, they won't be able to take any Quests.
After creating the Quest, you need to edit them in order to add functionality. You can add Objectives, Rewards, Requirements and so-called Triggers.
First, type /qa edit <Quest Name>. Replace <Quest Name> with the name of the Quest you would like to edit.
Now, this command is not done yet - but just run it anyways. It will show you all the available options of what you can edit :)
Helpful Tip: After each argument in any command, you can simply press enter & run command — even if the command is not finished. This will show a useful error message with a mini-tutorial and an explanation about what the heck the next argument is.
Let's create an example Quest together. We'll name it TheVirus. First, create the Quest by typing /qa create TheVirus.
Now, the initial Quest Name cannot have any spaces. However, we can give it a display name which can have spaces - and that's the name the player will actually see!
/qa edit TheVirus displayName A Deadly Virus
Next, we want to add a description to the Quest, which will be displayed in multiple places, for example if the player tries to preview or take the Quest:
/qa edit TheVirus description A deadly virus has infected the people of Winterfell. You have to murder the infected villagers to prevent the virus from spreading further.
Without any requirements, every single player will be able to accept your Quest. However, that Quest we're gonna make will be quite tricky! Let's require the player to have at least 10 Quest Points until they can accept the Quest:
/qa edit TheVirus requirements add QuestPoints 10 No
Quest Points can be earned by completing Quests, or they can be given out manually. The "No" at the end of this command means that the Quest Points won't be deducted from the Players balance once they accept it.
Let's add our first objective! First, the player has to free up the road from all the shit the infected Zombies made:
/qa edit TheVirus objectives add BreakBlocks DIRT 64 Yes
This objective will be completed once the player breaks 64 dirt. The "Yes" at the end makes it so progress is deducted when the player places dirt. Otherwise, they could cheat.
Now, let's add a description for that objective:
/qa edit TheVirus objectives edit 1 description set The infected Zombies shat on the street. Clean it up by breaking 64 dirt blocks!
And a name:
/qa edit TheVirus objectives edit 1 displayName set Stinky Street
Onto our next objective! The street is clear! The player should now kill all the infected villagers:
/qa edit TheVirus objectives add KillMobs ZOMBIE_VILLAGER 15
After 15 kills of Zombie Villagers, that objective will be completed! Now let's add a description and a name:
/qa edit TheVirus objectives edit 2 description set You can see the infected villagers in front of you! Murder them all to stop the virus from spreading!
/qa edit TheVirus objectives edit 2 displayName set Zombies ahead!
After accepting this Quest, you will see this:
As you see, both objectives are visible. You can also complete them in no particular order.
However, we want the second Objective, "Zombies ahead!" to only be visible and complete-able after the first Objective is completed.
To accomplish that, we need to make the second objective depend on the first one:
/qa edit TheVirus objectives edit 2 dependencies add 1
Done! If we take the Quest now, the second objective is hidden:
With Triggers, we can add some action to the Quest!