WorldQuest

Create Quests based on players position activating triggers which respond with scripted actions.

To create a script, stand in the location you want the trigger to be placed and type:

/wq create {quest_name}

This adds and entry to your questdb.txt file which would look something like this:

world,207,66,-86;{quest_name}:

The beta version then requires you to edit the questdb.txt file directly, the release version will have in game commands for creating and editing quests.

When a trigger is hit and a player is assigned the quest for that trigger a list of actions is executed. Here are some examples of different actions for quests:

To display text on the screen: text=type your response text here

To give the player money: money=100

To give the player items: item=247 item=diamond_helmet item=50,2 item=373:8193

To give the player XP: xp=100

To set the player from one rank to another: rank=guest,citizen

To give the player enchanted items: magic=diamond_sword,FIRE_ASPECT,1

To mark the quest as completed so the player can only do it once: quest=C

To assign the player a new quest: task=helmsmaze

To teleport the player to a new location: tp=world,-100,44,945

To spawn mobs: spawn=world,505,32,45,zombie

To load a schematic file: load=icecastle.schematic

The "money" action requires the Vault Plugin to be installed and a economy plugin for Vault to connect to.

The "rank" action requires the Vault Plugin to be installed and a permissions plugin for Vault to connect to.

The "load" action requires the WorldEdit Plugin to load the schematic files.

Here is an example of two quests:

world,-638,91,-1023;mountaintemple:quest=C~text=You brave the mountain passages and stand behind the alter. You find a note and it says: Find the passage that leads to a maze deep with the depths of the town within a mountain. Under the note you find some ancient coins~money=100~task=helmsmaze~ world,-889,35,-1237;helmsmaze:quest=C~text=You find the end of the maze and open the chest. Inside you find an enchanted diamond sword and helmet.~magic=diamond_sword,FIRE_ASPECT,1~magic=diamond_helmet,PROTECTION_EXPLOSIONS,2~

All actions are completed using the tilde "~" symbol as an end of command sign.

Each quest is completed using a carriage return.

To load any changes to the questdb.txt file after it has been edited do the following:

/wq load

WorldQuest uses two other files, the playerdb.txt and the config.yml

The config.yml file currently has only one setting:

Quests: {quest_name}

This lets you enter a name of a quest that get's auto-assigned to players as they logon.

The playerdb.txt looks like this:

axeldios:start=C,q1=C,q2=A,

carmen800535:start=A,

This shows that axeldios has completed two quests named "start" and "q1", and is assign a quest named "q2" And carmen800535 has only been assigned one quest named "start", but hasn't completed any quests.

To assign a quest to a player do:

/wq task [player_name] [quest_name]

To save your questdb.txt and playerdb.txt back to disk:

/wq save

To load both the quest and player databases do:

/wq loadall

If you reload your plugins, or restart your server, WorldQuest will first save both databases from memory to the disk files then reload them on startup.

Winterhold on AuthentiCity with girtacos9