This documentation is no longer updated. Please visit https://pikamug.gitbook.io/quests/
Notice: This information is intended for intermediate users. Read carefully!
Similar to how all quest stages have objectives, they can also perform actions. An action is something that happens during a stage, but is typically cosmetic and doesn't inherently progress the quest. For example, causing a player to lose hunger or get struck by lightning are considered actions.
To make an action, run /quests actions 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 action. 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 action |
| 2 | - | Player | Send message, clear inventory, give items, apply potion effects, set hunger level, set saturation level, teleport to location, or execute commands |
| 3 | - | Timer | Set time to fail quest and whether to cancel the quest timer |
| 4 | - | Effect | Set effects or set explosion locations |
| 5 | - | Weather | Set storm or thunder in a particular world, or set lightning strike locations |
| 6 | - | Set mob spawns | Action to spawn mobs |
| 7 | - | Fail the quest | Action to fail the quest |
| 8 | - | Save | Finish working on your action |
| 9 | - | Exit | Discard all work on your action |
For now, enter '5' for the Weather menu, then '2' to set up an action which will force thunder across a world for a while.
Input '1' to select one of your Minecraft server's worlds by name. They will be listed for your convenience, but you can only select one! You may create a second action later if you wish to deal out thunder across multiple worlds.
Once that's done, enter '2' to set a duration of time in seconds. This is how long your thunder action will last for. As an example, type in 180 for the event to last 3 minutes.
Enter all the appropriate prompt numbers for 'Done' until you've saved your action! You should be greeted with this message:
Nice job! Unlike the Quest Editor, there is no need to reload the plugin. Exit the Action 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 9 to run the action before, during, or after the stage:
Click here to see the breakdown.
| # | - | Choice | Description |
|---|---|---|---|
| 1 | - | Start Action | Activate on start of stage |
| 2 | - | Finish Action | Activate at end of stage |
| 3 | - | Death Action | Activate if player dies during stage |
| 4 | - | Disconnect Action | Activate if player disconnects during stage |
| 5 | - | Chat Action | Activate if chat message sent during stage |
| 6 | - | Command Action | Activate if command run during stage |
| 7 | - | Done | Save and return to previous menu |
Chat and command actions are run during the stage when the player enters a specific keyword or command in-game, respectively.
