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.