1.x/List of Objective node types: Difference between revisions

From Citizens Wiki

< 1.x

(Created page with "= Objective nodes types = To aid with generic objective design, each objective can use one of a common set of variables: * amount * string * materialid * location * item * npcde...")
 
No edit summary
Line 9: Line 9:
* npcdestination (destination NPC ID)
* npcdestination (destination NPC ID)


Each objective type may use one or more of these variables - a reference is provided below.
Each objective type may use one or more of these variables.


- Specifying item and locations -
- Specifying item and locations -
Line 25: Line 25:


Build quest (build) - place a certain number of blocks
Build quest (build) - place a certain number of blocks
Uses: ''materialid'' - the block ID to place. amount - the amount that must be placed.
 
<pre>
'0':
    '0':   
        type: build      # Specifies build objective.
        materialsid: 54  # Chest. Material player is required to build.
        amount: 1        # Number of items that must be placed.
</pre>


Location quest (move location)- be within a certain range of a location.
Location quest (move location)- be within a certain range of a location.
Uses:  
 
* ''location'' - the base location to move to.  
<pre>'0':
* ''amount'' - the leeway in blocks that the player can be away from the location before finishing.
    '0':   
* ''time'' - the time (in seconds) that the player has to stay in this location for.
        type: move location   # Specifies loaction objective.
            x: 150      # Coordinates of location required to visit.
            y: 47
            z: 420
        time: 10        # The time (in seconds) that the player has to stay in this location for.
        amount: 1        # The leeway in blocks that the player can be away from the location before finishing.
</pre>
 
Note by aufdemrand: Location quest is currently producing console errors when using /quest status. They also do not trigger when the objective is complete. This is a reported bug and is being worked on.
 


Hunt quest (hunt) - kill a certain number of monsters.
Hunt quest (hunt) - kill a certain number of monsters.

Revision as of 03:37, 31 January 2012

Objective nodes types

To aid with generic objective design, each objective can use one of a common set of variables:

  • amount
  • string
  • materialid
  • location
  • item
  • npcdestination (destination NPC ID)

Each objective type may use one or more of these variables.

- Specifying item and locations - Item nodes have three sub-nodes, two that must be included and one optional. The id sub-node designates the item/block ID. The amount sub-node specifies the item amount. The optional data sub-node specifies the item data value to be used.

Location nodes have 4 required sub-nodes, two optional. The world node specifies the world name of the location. The x, y, and z nodes specifies the x, y, and z values. The optional pitch/yaw nodes specify the rotation (think aeroplanes) of the location.

Quest Types

Build quest (build) - place a certain number of blocks

'0':
    '0':    
        type: build      # Specifies build objective.
        materialsid: 54  # Chest. Material player is required to build.
        amount: 1        # Number of items that must be placed.

Location quest (move location)- be within a certain range of a location.

'0':
    '0':    
        type: move location   # Specifies loaction objective.
            x: 150       # Coordinates of location required to visit.
            y: 47
            z: 420
        time: 10         # The time (in seconds) that the player has to stay in this location for.
        amount: 1        # The leeway in blocks that the player can be away from the location before finishing.

Note by aufdemrand: Location quest is currently producing console errors when using /quest status. They also do not trigger when the objective is complete. This is a reported bug and is being worked on.


Hunt quest (hunt) - kill a certain number of monsters. Uses:

  • amount - the number of monsters to kill.
  • string - which monsters should be killed. Using '-' as the first character makes a whitelist. '*' represents all.

Distance quest (move distance)- walk a certain number of blocks. Uses:

  • amount - the amount of blocks to walk.

Block destroy quest (destroy block) - break a certain amount of blocks. Uses:

  • amount - the amount of blocks to break.
  • materialid - the block ID to break.

Delivery quest (delivery)- deliver an item to an npc. Uses:

  • npcdestination - the NPC ID to deliver to.
  • materialid - the material that must be in hand.
  • amount - the amount of the material that must be in hand.

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.