main/Config
The config file
Top-level settings
- interval
- The time, in seconds. between spawn occasions. Default is 60.
- min_player_count
- The minimum number of players that need to be on the server for mobs to be spawned. Default is 1.
- burn_mobs
- This has three possibilities
- always - zombies and skeletons burn like normal when the sun comes out
- never - zombies and skeletons won't burn even in the daytime
- sometimes - zombies and skeletons spawned by the plugin won't burn in the day, but the ones spawned naturally will
Default is always.
- spawns
- The list of time conditions and mobs to be spawned
A spawn occasion
- time
- A set of conditions (minutes, hours, and days) that must match the real time to return true. The format is exactly the same as the Mob Spawns and Mob Drops plugins if you have used them.
- mobs
- A list of mobs to spawn if the time section returns true.
- shortcut
- Setting a value here will let you manually activate the spawn occasion whenever you want by using the command spawn_mob <shortcut_value> or sm <shortcut_value>
The time section
- minutes
- A list of minutes in which the mobs can be spawned. Each entry needs the min and max properties. If min is missing it will default to 0, and if max is missing it will default to 59. For a single minute min and max must be the same.
- hours
- The same as for minutes, but with max defaulting to 23 if it's missing. Values must use the 24-hour clock.
- days
- A list of days for which spawning is allowed. Values must be either the first three letters of the day (mon, tue, etc.) or a number from 1 to 7. 1 is Sunday and 7 is Saturday. If any of these sections is missing the plugin will ignore them. So having no minutes section is effectively the same as having min: 0 and max: 59. I.e. every minute will return true.
The mob section
- name
- The type of mob to spawn. Must match one of the supported mobs above (case doesn't matter).
- quantity
- A list of possible values for the number of this mob to spawn. Uses the min and max properties. Default is 1.
- location
- The area of the world to spawn the mob in.
Modifiers
- angry
- Sets whether the mob should spawn angry. Only applies to pigzombies and wolves.
- tame
- Sets whether the mob should spawn tame. Only applies to wolves.
- saddled
- Sets whether the mob should spawn saddled. Only applies to pigs.
- powered
- Sets whether the mob should spawn powered. Only applies to creepers. Each of the above takes three possible values - no (default), yes, or random. If random the plugin will randomly decide between yes and no.
- sizes
- A list of possible sizes in the same format as minutes and hours (but with no default min and max). Only applies to slimes and magmacubes. Be careful of setting this too large as the mob will have huge amounts of HP and the hitspot might not be reachable by swords. If the range is larger than one number the size of each slime/magmacube will be randomly chosen from the range.
The location section
- world
- The name of the world where the mobs should be spawned. Default is world.
- base
- Base has three child values, x, y, and z. These are used to set the starting spawn point.
- range
- Range has three identical child values to base, but in this case they refer to the amount of blocks above and below the base the mob can spawn. So a base.x of 3 with a range.x of 2 means the mob can spawn anywhere between 1 and 5 on the x-axis. Set smaller range number to have more precise control over the location.
If the chosen location turns out to be a solid block the nearest air block will be chosen. If the location is in the middle of the sky the lowest air block will be used. If the mob has a quantity more than 1 each mob will randomly choose a location within the range rather than using the same location for all mobs (unless the range is set to 0, of course).