Spawn Triggers are what make a Spawners start and are based on various game events ranging from random ticks to certain blocks being broken, etc.
Each type of Spawn Trigger has its own properties, some properties are shared mongst different types.
Shared Properties:
-
string type
The type of Spawn Trigger this is, if the type is not recognised, then it is ignored. Can be one of the listed types below in lowercase, no space, Ex: "ore"
-
int count
How much this influences the Spawner's trigger count by, usually just 1. If 0 this Trigger will instead completely reset the count, if negative it will reduce the count. See the Darkness Spawner for this in action. Default 1.
-
double chance
The Chance of triggering where 1 is 100%. Can be 0.0-1.0. Default 1.
-
array[Spawn Condition]
A Spawn Trigger can also have it's own list of Trigger-specific Spawn Conditions that are only checked for this Trigger. See the Darkness Spawner for this in action. Default empty.
-
int conditionsRequired
Determines how many Spawn Conditions must be met. If set to 0 or less then Spawn Conditions all are required. Default 0 (all).
This Trigger fires every world tick and is good for generic random spawners as well as timed spawners that spawn mobs all over the world. 20 ticks = 1 second.
-
int tickRate
How many ticks between trigger attempts. Default 400 (every 20 seconds).
-
bool useWorldTime
If true, rather than every "tickRate", it is instead when the world time is equal to the "tickRate" set, good for trigger at an exact time every world day. Default false.
Player Type (Formerly Tick Type)
This Trigger fires every player tick and is good for generic random spawners as well as timed spawners that revolve around each player. 20 ticks = 1 second.
-
int tickRate
How many ticks between trigger attempts. Default 400 (every 20 seconds).
-
int lastTickDistanceMin
The minimum distance the player must be away from the last tick position. Default -1 (ignored).
-
int lastTickDistanceMax
The maximum distance the player must be away from the last tick position. Default -1 (ignored).
-
bool useWorldTime
If true, rather than every "tickRate", it is instead when the world time is equal to the "tickRate" set, good for trigger at an exact time every world day. Default false.
This Trigger fires when certain blocks are broken by the player.
-
bool playerOnly
If true, only players can activate this Trigger, fake players are not counted as players. Default true.
-
bool onBreak
If true, the Block Break event will activate this trigger. Default true.
-
bool onHarvest
If true, the Block Harvest event will activate this trigger. Default true.
-
bool onPlace
If true, this Block Place event will activate this trigger. Default true.
-
array[string] blocks
A list of blocks to filter by. Use block ids like "minecraft:air". Default empty.
-
string blocksListType
Determines if the blocks list is a blacklist or whitelist. Default "whitelist".
-
array[string] blockMaterials
A list of block materials to filter by. Use the material name like "wood". Default empty.
-
string blockMaterialsListType
Determines if the block materials list is a blacklist or whitelist. Default "blacklist".
-
string silkTouch
How to react to blocks broken with or without silk touch. Can be: "ignore", "require" or "deny". Default: "ignore".
-
int fortuneMin
The minimum fortune that the harvester must have. Default: -1 (ignore).
-
int fortuneMax
The maximum fortune that the harvester must have. Default: -1 (ignore).
This Trigger fires when ore blocks are broken by the player.
-
Extends Block Type
This type uses the same properties as the Block Type.
-
bool ores
If true, ores (ore blocks that drop as blocks as well as coal and monster egg) will trigger, if false they wont. Default: true.
-
bool gems
If true, gems (ore blocks that drop as items excluding coal and monster egg) will trigger, if false they wont. Default: true.
This Trigger fires when blocks that are part of a tree are broken by the player. This searches for log blocks and then searchs up and to the side for leaves blocks.
This Trigger fires when crop blocks are broken by the player. This searches for vines, planted farm plants like Wheat as well as Melon and Pumpkin stalks.
This Trigger fires when water and lava mix to form a solid block.
This Trigger fires when the player attempts to use a bed at night. If the Trigger is successful (passess random chance, but does not check if a mob actually spawns), the player is stopped from sleeping.
-
Extends Block Type
This type uses the same properties as the Block Type where the block to filter by is the bed block that was used, handy for reacting to beds from other mods such as adding in 'safe beds'.
-
int cooldown
How long (in ticks) until this trigger can be started again, this is done per player. Default 1200 (10 minutes).
This Trigger fires when the player kills another mob.
-
array[string] entityTypes
A list of entity types to filter by, can be: "UNDEAD" (zombies, phantoms, etc), "UNDEFINED" (most mobs), "ARTHROPOD" (insects, arachnids, etc). Default empty.
-
string entityTypesListType
Determines if the entity types list is a blacklist or whitelist. Default "whitelist".
-
array[string] entityIds
A list of entity ids to filter by, you can get a mob's id from the creature page, but it usually follows a pattern like: "mountainmobs.jabberwock" or "minecraft.zombie", modded mobs may also work. Default empty.
-
string entityIdsListType
Determines if the entity ids list is a blacklist or whitelist. Default "blacklist".
This Trigger fires when the player fishes up an item. This has no special properties of its own.
This Trigger fires when an explosion occurs. Usually there is no player object involved with this so any player conditions will make the spawner fail.
-
int strength
How strong the explosion has to be to trigger this spawner. Default 4 (TNT's strength).
-
array[string] entityTypes
A list of entity types to filter by for explosion starters, can be: "UNDEAD" (zombies, phantoms, etc), "UNDEFINED" (most mobs), "ARTHROPOD" (insects, arachnids, etc). Default empty.
-
string entityTypesListType
Determines if the entity types list is a blacklist or whitelist. Default "whitelist".
-
array[string] entityIds
A list of entity ids to filter by for explosion starters, you can get a mob's id from the creature page, but it usually follows a pattern like: "mountainmobs.jabberwock" or "minecraft.zombie", modded mobs may also work. Default empty.
-
string entityIdsListType
Determines if the entity ids list is a blacklist or whitelist. Default "blacklist".