Bukkit

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.