Wiki
Clone wikiAce / Fields description
Fields description
Conditions:
Parameters for all conditions
Params:
-reversed - not obligatory, if not present conditions will work normally, if equals true then reverses value returned by conditions
AREA
Desc: If player is in area defined by two points task will take place
Params:
-startX
-startY
-startZ
-endX
-endY
-endZ
CHANCE
Desc: Random chance for task to happen. Determined by cheking if rand(100) < chance parameter
Params:
-chance
DIMENSION
Desc: Check if player is in dimension.
Params:
-dim_id
INVENTORY
Desc: Check if player has specific item/block in inventory.
Params:
-modid
-name
-meta
-ignoreMeta if true meta value will not be checked
RADIUS_COORD
Desc: Check if player is in specific distance from location.
Params:
-startX
-startY
-startZ
-radius
PROXIMITY
Desc: Checks if player is in proximity to specified block or entity
Params:
-target - proximity can be checked to MOB (entity) or BLOCK
-modid - for block
-name
-meta
-mob - name of entity (Zombie, Wolf etc)
-radius
USING
Desc: Checks if specified item was in active slot in players inventory while performing task
Params:
-modid
-name
-meta
-ignoreMeta if true meta value will not be checked
TIME
Desc: Checks if current time of day is in operand relation to timeOfDay
Params:
-timeOfDay - time of day (0 - 23999) which will be tested
-operand - condition for checking time: EQUALS, BEFORE, AFTER
ACHIEVEMENT
Desc: Checks if player has got certain achievement
Params:
-player - for now only value is SELF (must think if other options make sense)
-achievement - as achievements statId (example achievement.openInventory)
SCOREBOARD
Desc: Checks if players score in certain objective is in operand relation to configured value
Params:
-objective- name of objetive added to scoreboard (example @objetive in /scoreboard objectives add @objective deathCount)
-player_type- for who event should trigger (SELF, ONE_PLAYER)
-player- name of player for player_type = ONE_PLAYER
-value- tested value
-operand- if player score EQUALS, GREATER, SMALLER to config value
POTION
Desc: Checks if player is under effect of potion with certain id
Params:
-id - id of potion to check
DIFFICULTY
Desc: Checks if game is in certain difficulty (when player is on server - server setting is checked)
Params:
-name - name of difficulty (EASY, NORMAL, HARD)
HANDLER_COUNT (condition)
Desc: Checks if defined handlerIdentifier is in operand relation to value
Params:
-handlerIdentifier - name of variable
-operand - comparison operation (EQUALS, GREATER, SMALLER)
-value - value to comapre variable
BIOME
Desc: Checks if player is in specified biome
Params:
-biomeName- name of biome (example Plains, Forest, Ocean etc)
WEATHER
Desc: Checks if in world where player is exists specified weather
Params:
-isRaining- if it is raining it will trigger task
-isThundering- if it is thunderstorm it will trigger task
ON_BLOCK
Desc: Checks droppped item is on specified block/in water
Params:
-modid
-name
-meta
-inWater - if item is in water task will be triggered
PLAYER_NAME
Desc: Checks player has specified name
Params:
-player - name of player
Triggers:
CHAT
Desc: Triggers when specific text is send in chat.
Params:
-text - text which triggers tasks
ENDER
Desc: Triggers when enderman is about to teleport or enderpearl is used by player.
Params:
-target (PLAYER, ENDER)
HARVEST
Desc: Triggers when player breaks block and drops are about to drop
Params:
-issuer - for who event should trigger (ALL_PLAYERS, SELF, precise player name)
-modid
-name
-meta
-any (if present and equals to true then harvest wll trigger only for issuer, no mod, block or meta checking)
INTERACT
Desc: Triggers when player interacts with block or air.
Params:
-action (Possible values are LEFT, RIGHT_BLOCK, RIGHT_AIR.)
-issuer - for who event should trigger (ALL_PLAYERS, SELF, precise player name)
-modid
-name (if RIGHT_AIR set this to air)
-meta
-ignoreBlock (true, false) if true will trigger on all interacts, can be ommited and then false is assumed
TOSS
Desc: Triggers when player drops item (default Q key)
Params:
-issuer - for who event should trigger (ALL_PLAYERS, SELF, precise player name)
-modid
-name
-meta
JOIN_WORLD
Desc: Triggers when player joins world
Params:
-target - for who event should trigger (ALL_PLAYERS, precise player name)
-noDeathDim- should event trigger only on loading game (true) or every dimmension change, death etc (false)
-joinOneEver - should event trigger only on first join to world ever (true)
TICK
Desc: Triggers when certain interval of ticks passes based on world total time.
Params:
-ticks - number of ticks between triggers
QUEST
Desc: Triggers when some mod posts AceQuestEventAPI.
Params:
-modid- Mod for which quest was completed
-questid- Id of quest that was completed
-issuer- Player that completed quest
ACHIEVEMENT
Desc: Triggers when player gets achievement.
Params:
-issuer- for who event should trigger (ALL_PLAYERS, SELF, precise player name)
-achievement- as achievements statId (example achievement.openInventory)
EXPIRE
Desc: Triggers when item despawns.
Params:
-modid - from whitch mod item comes from
-name - name of item
-meta
DEATH
Desc: Triggers when entity dies.
Params:
-target - name of target (example: Pig, PLAYER, Zombie)
LIVING_DROPS
Desc: Triggers when entity is droppping its drops.
Params:
-target - name of entity for which to trigger (example: Pig, PLAYER, Zombie)
INTERACT_ENT
Desc: Triggers when player interacts with mob (right click it)
Params:
-target - name of entity for which to trigger (example: Pig, PLAYER, Zombie)
Tasks:
BLOCK
Desc: Places block in world at specified location
Params:
-modid
-name
-meta
-location_type - values: COORD, SELF, BLOCK (leave coord parameters values equal to 0)
-xCoord
-yCoord
-zCoord
-nbt - set nbt for block like in MC
CANCEL
Desc: Cancels event which triggered task if it is cancelable
CHAT
Desc: Displays chat message for specified players
Params:
-receiver_type - who should be target of tasks (ALL_PLAYERS, ONE_PLAYER, SELF)
-receiver - player name when ONE_PLAYER is specified
-message
HARVEST_ADD
Desc: Adds items to drops from Harvest event
Params:
-modid
-name
-meta
-count
HARVEST_CLEAR
Desc: Clears all items from drops of Harvest event
HARVEST_REMOVE
Desc: Removes specified items from drops of Harvest event
Params:
-modid
-name
-meta
-count
INVENTORY_ADD
Desc: Adds items to specified players inventory
Params:
-target - player name when ONE_PLAYER is specified
-target_type - who should be target of tasks (ALL_PLAYERS, ONE_PLAYER, SELF)
-modid
-name
-meta
-count
-nbt - set nbt for item like in MC give command (http://minecraft.gamepedia.com/Commands#give)
INVENTORY_REMOVE
Desc: Removes items from specified players inventory
Params:
-target - player name when ONE_PLAYER is specified
-target_type - who should be target of tasks (ALL_PLAYERS, ONE_PLAYER, SELF)
-modid
-name
-meta
-count
ITEM
Desc: Drops stack of items/blocks at specified location
Params:
-modid
-name
-meta
-count
-location_type - values: COORD, SELF
-xCoord
-yCoord
-zCoord
POTION
Desc: Applies potion effect to specified players
Params:
-target_type - who should be target of tasks (ALL_PLAYERS, ONE_PLAYER, SELF)
-target - player name when ONE_PLAYER is specified
-id -id of potion
-duration - duration in ticks
-level - level o potion (eg for Strenght 1 or 2)
RELOAD
Desc: Reloads ACE configuration
SPWN_MOB
Desc: Spawns specified mob at location
Params:
-type - type of monster to zpawn (eg, Zombie, Wolf)
-location_type - values: COORD, SELF (leave coord parameters values as 0), RANDOM
-radius radius of randomization from player position
-xCoord
-yCoord
-zCoord
-nbt - set nbt for block like in MC
DUMP
Desc: Dump items, block or entities into file to use in other tasks
Params:
-objectType - values: ITEM, BLOCK, ENTITY, ACHIEVEMENT (dumps statId values for triggers and conditions)
TIME
Desc: Sets time of current day
Params:
-timeOfDay - time of day to set (0-23999), greater values will progress day
COMMAND
Desc: Runs specified / command. Cheats must be allowed.
Params:
-command - string containing full command (eg. /seed)
-ignorePrivilages - if true commands will be performed as op;can be ommited and then assumed value is false
SOUND
Desc: Playes specified and provided sound.
Params:
-name - name of sound file without .ogg
-player_type - play sound for ALL_PLAYERS or certain player by specifying his name
-volume - value from 0 to 1 (must use . not , to separate parts of value)
-pitch - value from 0 to 1 (must use . not , to separate parts of value)
HANDLER_COUNT (task)
Desc: Changes value of variable.
Params:
-handlerIdentifier - name of variable
-operation - how to change value:
+ increase by 1
- decrease by 1
CLEAR sets variable to 0
HANDLER_COUNT_CHAT
Desc: Prints value of variable for player who initiated trigger.
Params:
-handlerIdentifier - name of variable to print
ITEM_NEW_LIFE
Desc: Sets item despawn time (currently only works with TOSS trigger).
Params:
-newLife- number of ticks item despawn after
DROPS_CLEAR
Desc: Clears all drops from entity
Params:
-no params
DROPS_ADD
Desc: Adds specified items to entity drops
Params:
-modid - id of mod which item comes from
-name - name of item
-meta - meta of item
-count - how many to add
DROPS_REMOVE
Desc: Removes defined items from entity drops
Params:
-modid - id of mod which item comes from
-name - name of item
-meta - meta of item
-count - how many to remove
IDENTIFY
Desc: Prints in chat modid, name and meta of currently held item to use with other task, conditions etc.
Updated