Pages

Events

Page is updated to match version 0.6.2.

This page describes what each quest event does and how to use it.

What is event

Events define certain actions executed on specified occasions. Events vary from simple teleportation or message display to world modification or quest modification. Events also serve as rewards on quest complete.

Adding event

General command to add event is /q event add {<occasion>} <event type> <additional arguments>.
Command description:

  • event type - all event types are listed below
  • occasion = all ocasions are listed of special arguments page
  • additional argumets - event type-specific

Event types

Message

Command: /q event add {<occasion>} msg <message+>
+ - message supports '&' color codes and '\n' newlines
Displays message to player on specified occasion.
Config:

type: 'MSG'
# message is MANDATORY
message: '&cMessage event just happened !'

Command

Command: /q event add {<occasion>} cmd <command+>
+ - command must be without starting '/', %p in command represents player's name
Runs command as console on specified occasion.
Config:

type: 'CMD'
# command is MANDATORY
command: 'deop %p'

Teleport

Command: /q event add {<occasion>} tele {<location>}
Teleport player to location on occasion.
Config:

type: 'TELE'
# location is MANDATORY
location: '100;70;100;world'

Block

Command: /q event add {<occasion>} block {<block>} {<location>+}
+ - location 'here' in this case means last targeted block
Sets the block to specified type on occasion. Set it to 0 or air to remove it. No drops are produced, unless there is torch or similar item attached to it.
Config:

type: 'BLOCK'
# block is MANDATORY
block: 'stone'
# location is MANDATORY
location: '100;70;100;world'

Explosion

Command: /q event add {<occasion>} explosion {<location>} [damage+]
+ - true to cause, false to not cause damage
Creates explosion on specified location on occasion.
Config:

type: 'EXPLOSION'
# location is optional - defaults to player's location
location: '100;70;100;world'
# range is optional - default is 0
range: 5
# damage is optional - default is false
damage: true

Lightning

Command: /q event add {<occasion>} lightning {<location>} [damage+]
+ - true to cause, false to not cause damage
Striked specified location with lightning on occasion.
Config:

type: 'LIGHTNING'
# location is optional - defaults to player's location
location: '100;70;100;world'
# range is optional - default is 0
range: 5
# damage is optional - default is false
damage: true

Quest

Command: /q event add {<occasion>} quest <quest name>
Attempts to start specified quest for the player. Fail is logged into console. Best combined with cancel event.
Config:

type: 'QUEST'
# quest ID is MANDATORY
quest: 2

Cancel

Command: /q event add {<occasion>} cancel
Cancels current quest. Be careful when adding delay to this event, as it does not care if player accepted new quest since.
Config:

type: 'CANCEL'

Toggle

Command: /q event add {<occasion>} toggle <quest ID>
Toggles quest with specified ID. Fail is logged into console. (non-existant quest)
Config:

type: 'TOGGLE'
# quest ID is MANDATORY
quest: 2

Objective complete

Command: /q event add {<occasion>} objcom <objective ID>
Attempts to complete objective with specified ID. Objective is marked as completed without any additional costs. Fail is logged into console. (non-existant objective)
Config:

type: 'OBJCOM'
# objective ID is MANDATORY
objective: 3

Spawn

Command: /q event add {<occasion>} spawn {<entity>} <amount> {<location>} [range]
Spawns specified amount of given mobs spread randomly in range of certain location.
Config:

type: 'SPAWN'
# entity is MANDATORY
entity: 'creeper'
# amount is optional - default is 1
amount: 3
# location is optional - defaults to player's location
location: '100;70;100;world'
# range is optional - default is 0
range: 5

Item

Command: /q event add {<occasion>} item {<item>} <amount> {[enchants]}
Gives player certain item. If he has not enough space in his inventory, items that does not fit are dropped on the ground under his feet.
Config:

type: 'ITEM'
# item is MANDATORY
item: '278:1000'
# amount is optional - default is 1
amount: 3
# enchants are optional - defaults to none
enchants: '33:2,34:1'

Money

Command: /q event add {<occasion>} money <amount>
Gives player specified amount of money. Negative amount is subtractet from player's account. Fail is logged into console. (in case no economy plugin is found)
Config:

type: 'MONEY'
# amount is MANDATORY
amount: 1000

Exp

Command: /q event add {<occasion>} exp <amount>
Gives player certain amount of exp points (not levels). Negative amount takes exp.
Config:

type: 'EXP'
# amount is MANDATORY
amount: 1000

Effect

Command: /q event add {<occasion>} effect {<potion effect>}
Applies specified potion effect to player.
Config:

type: 'EFFECT'
# effect is MANDATORY (example: speed, 30 seconds, lvl 2)
effect: 'speed:30:1'

Point

Command: /q event add {<occasion>} point <amount>
Gives player certain amount of quester points. Negative amount takes points.
Config:

type: 'POINT'
# amount is MANDATORY
amount: 1000

Removing event

To remove event, type /q event remove <ID>, where <ID> is ID of event you want to remove.