Wiki

Clone wiki

Ace / 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