This documentation is no longer updated. Please visit https://pikamug.gitbook.io/quests/
Warning: This information is intended for advanced users. Proceed with caution!
When a player is carrying out a stage of a quest, it may be desirable to force them to meet a certain criteria. For example, holding a specific item while completing objectives. To do this, a condition must be created and applied.
To make a condition, run /quests conditions in-game (it is not currently accessible from the console). You will be greeted with the following:
Enter '1' in chat so the plugin may prompt you to enter a name for your condition. This can be any alphanumeric sequence, which means letters and numbers are OK, but no special characters or symbols! Don't worry, you can change it later if you're unsure.
After you've chosen a valid name, this screen will appear:
Click here to see the breakdown.
# | - | Choice | Description |
---|---|---|---|
1 | - | Set name | Change the name of your condition |
2 | - | Entity | Ride entity |
2 | - | Player | Own permission or hold in main hand |
3 | - | World | Stay within world, stay within biome, or stay within region |
4 | - | Check placeholder | Whether placeholder value is true |
5 | - | Fail the quest | Whether to fail quest if condition not met |
6 | - | Save | Finish working on your condition |
7 | - | Exit | Discard all work on your condition |
Select a condition type and decide whether the player should fail the quest if said condition is not met.
Enter all the appropriate prompt numbers for 'Done' until you've saved your condition! You should be greeted with this message:
Nice job! Unlike the Quest Editor, there is no need to reload the plugin. Exit the Condition Editor and then create or edit a quest in the Quest Editor. Go to the 'Edit Stages' menu and, after setting at least one objective, select option 11 to apply the condition.