1.x/Quester: Difference between revisions

From Citizens Wiki

< 1.x

No edit summary
 
(30 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Description here.
{{NoSupport}}
 
'''Questers''' allow players to go on many different types of quests. They can collect or place blocks, attack mobs, travel a certain distance, and more! Quests are fully customizable in the [[1.x/Quests.yml]] file. You can assign these quests to a quester and send your players on fun quests. See below for information on setting up a quester and customizing your quests.
== Configuration Nodes ==


== Commands ==
== Commands ==


== Quests ==
{| class="wikitable collapsible collapsed" style="text-align: center; width: 100%"
 
|-
=== Basics ===
! style="width: 100%; background-color:#ADD8E6" colspan="6" | '''Quester Commands'''
 
|-
Quests are defined in the quests.yml file located in plugins/Citizens. Each root node in that file is a quest name - below, the two example quest names in quest.yml are 'example' and 'example2'. This is what you will use ingame to identify each quest.
! style="width: 250px;" | Command
Inside this, there are text nodes - pretty self-explanatory. Note that you can use <br> to denote a line break.
! style="width: 200px;" | Args Description
 
! style="width: 150px;" | Require Selected
The repeatable option allows a quest to be repeated. Set it to false for once-off quests.
! style="width: 150px;" | Require Ownership
 
! style="width: 170px;" | Permission
=== Objectives ===
! Description
 
|-
Thus far, objectives have a set structure - a number of different 'steps' and a number of objectives within each step. This allows for more free-form quest design. Note that each step should be marked by an ascending number '''with single quotes''' around it. Each objective within a step is incremented concurrently.
| /quester help
 
| ''None''
The message variable is sent to the player on completion of each objective.
| false
 
| false
'''Objective Types'''
| citizens.quester.use.help
 
| View the help page for questers
To aid with generic objective design, each objective can use one of a common set of variables:
|-
* amount
| /quester assign [quest]
* string
| ''quest'' - name of quest to assign to a quester
* materialid
| true
* location
| true
* item
| citizens.quester.modify.quests.assign
* npcdestination (destination NPC ID)
| Assign a quest to a quester
 
|-
Each objective type may use one or more of these variables - a reference is provided below.
| /quester remove [quest]
 
| ''quest'' - quest to remove from a quester
- Specifying item and locations -
| true
Item nodes have three sub-nodes, two that must be included and one optional.
| true
The ''id'' sub-node designates the item/block ID.
| citizens.quester.modify.quests.remove
The ''amount'' sub-node specifies the item amount.
| Remove a quest from a quester
The optional ''data'' sub-node specifies the item data value to be used.
|-
 
| /quester quests (page)
Location nodes have 4 required sub-nodes, two optional.
| ''page'' - page number
The ''world'' node specifies the world name of the location.
| true
The ''x'', ''y'', and ''z'' nodes specifies the x, y, and z values.
| true
The optional ''pitch''/''yaw'' nodes specify the rotation (think aeroplanes) of the location.
| citizens.quester.use.quests.view
 
| View a quester's quests
=== Quest Types ===
|-
 
| /quest help
Build quest (build) - place a certain number of blocks
| ''None''
Uses: ''materialid'' - the block ID to place. amount - the amount that must be placed.
| false
 
| false
Location quest (move location)- be within a certain range of a location.
| citizens.quester.use.quests.help
Uses: ''location'' - the base location to move to. amount - the amount in blocks that the player can be away from the location before finishing.
| View the help page for quests
 
|-
Hunt quest (hunt) - kill a certain number of monsters.
| /quest abort
Uses:
| ''None''
* ''amount'' - the number of monsters to kill.
| true
* ''string'' - which monsters should be killed. Using '-' as the first character makes a whitelist. '*' represents all.
| true
 
| citizens.quester.use.quests.abort
Distance quest (move distance)- walk a certain number of blocks.
| Abort the current quest
Uses:
|-
* ''amount'' - the amount of blocks to walk.
| /quest completed (page)
 
| ''page'' - page number
Block destroy quest (destroy block) - break a certain amount of blocks.
| false
Uses:
| false
* ''amount'' - the amount of blocks to break.
| citizens.quester.use.quests.status
* ''materialid'' - the block ID to break.
| View completed quests
 
|-
Delivery quest (delivery)- deliver an item to an npc.
| /quest status
Uses:
| ''None''
* ''npcdestination'' - the NPC ID to deliver to.  
| false
* ''materialid'' - the material that must be in hand.
| false
* ''amount'' - the amount of the material that must be in hand.
| citizens.quester.use.quests.status
 
| View the status of the current quest
Combat quest (player combat) - kill a certain number of players.
|}
Uses:
* ''amount'' - the amount of players to kill.
* ''string'' - which players should be killed. Using '-' as the first character makes a whitelist. '*' represents all. g:group represents groups.
 
Collect quest (collect) - pick up a certain number of items.
Uses:
* ''amount'' - the number of items to pick up.
* ''materialid'' - the ID to pick up.


=== Rewards ===
== Usage ==
To accept a quest, go to a quester NPC. Via left clicking, you can scroll through the descriptions of each possible quest that the quester has assigned to it and that you can accept. Right click to accept the quest.


These can be used as both rewards *and* requirements to start a quest. As rewards, they can be either give rewards, or take rewards. As requirements, they can only be used to take from a player.
Only one quest can be accepted at any time - use /quest abort to abandon the current quest.


Rank reward (rank) - grants a group ('rank') to a player.
The status of the current quest can be viewed at any time via /quest status. On completion of the quest, return to the original quester NPC and right click them to finish the quest.
Specified by the rank: node.
== Quest Configuration ==


Permission reward (permission) - grants a permission to a player.
See [[1.x/Quests.yml]] for detailed information about writing and editing quest structure.
Specified by the permission: node.


Quest reward (quest) - grants a quest to a player. Note that it cannot be taken away from a player.
== Troubleshooting Quests.yml ==
Specified by the quest: node.


Item reward (item) - gives an item to a player.
Many problems with quest files are caused by incorrectly formatted YAML.  To make sure your YAML quest file is able to be parsed correctly, this handy tool may be of help. [http://yaml-online-parser.appspot.com/ This online YAML parser] will take input syntax in the left window, and if correctly parsed, will show a result in the right side. If errors occur, check your [[1.x/Quests.yml]] formatting and try again.
Loaded from the item: nodes.


Health reward (health) - gives health to a player.
When writing custom quests, check format thoroughly, especially objectives. The [[1.x/Quests.yml]] page outlines each node required by quests.
Loaded from the amount: node.


Money reward (money) - gives money to a player.
{{NavBox}}
Loaded from the money: node.
[[Category:Citizens1]]

Latest revision as of 13:49, 1 May 2012

Not Supported!
This page is about Citizens 1.x, while the current version is Citizens 2.0.2. This page's content may be outdated, and shouldn't be trusted as being correct. See this page's talk page for more information. If you were looking for the 2.0.2 equivalent of this page, try Quester. If you feel this message was displayed in error, please contact an administrator.

Questers allow players to go on many different types of quests. They can collect or place blocks, attack mobs, travel a certain distance, and more! Quests are fully customizable in the 1.x/Quests.yml file. You can assign these quests to a quester and send your players on fun quests. See below for information on setting up a quester and customizing your quests.

Commands

Usage

To accept a quest, go to a quester NPC. Via left clicking, you can scroll through the descriptions of each possible quest that the quester has assigned to it and that you can accept. Right click to accept the quest.

Only one quest can be accepted at any time - use /quest abort to abandon the current quest.

The status of the current quest can be viewed at any time via /quest status. On completion of the quest, return to the original quester NPC and right click them to finish the quest.

Quest Configuration

See 1.x/Quests.yml for detailed information about writing and editing quest structure.

Troubleshooting Quests.yml

Many problems with quest files are caused by incorrectly formatted YAML. To make sure your YAML quest file is able to be parsed correctly, this handy tool may be of help. This online YAML parser will take input syntax in the left window, and if correctly parsed, will show a result in the right side. If errors occur, check your 1.x/Quests.yml formatting and try again.

When writing custom quests, check format thoroughly, especially objectives. The 1.x/Quests.yml page outlines each node required by quests.