creaturebox

Why creaturebox?

• Have you ever thought "I'd love to dig this dungeon out, and move it somewhere more useful."?
  
• Have you ever thought "I'd really like to /give myself a spawner, and make it produce something other than pigs."?
  
• Have you ever thought "I'd really like to turn this spawner on and off with a switch"?
  
• Have you ever thought "I'd like these critters to spawn on something other than grass"?
  
• Have you ever thought "I wish monsters would spawn in lit rooms too"?

If you answered "yes" to any of these, then creaturebox is the plugin for you.

creaturebox was first developed and deployed on our server when we wanted better control over spawners. creaturebox also fixes several issues with creature spawners, so that they can be altered, and traded between players via shop plugins.

Features & Commands:

• When a creature spawner is broken, it is dropped as an item.
  
• When a creature spawner is placed, it retains its original creature type.
  
• The creature type which is created by a creature spawner can be changed using the /creaturebox set command. To alter a mob spawner, look directly at it (through glass is fine), then type /creaturebox set {creaturename}, where {creaturename} is the name of a creature.
  
• The frequency at which a creature spawner generates creatures can be changed using the /creaturebox period {period} command, where {period} is the number of seconds between spawns. A period of -1 gives a random period between 10 and 20 seconds. A period of zero puts the creature spawner into "pulsed redstone" mode, where creatures are generated only when the redstone power of the spawner switches from high to low.
  
• The number of creatures generated at a time can be changed using the /creaturebox count {count} command, where {count} is the number of creatures to generate. A count of -1 generates a random number of creatures (from 1 to 4), while a count of 0 disables the spawner.
  
• The maximum number of live mobs that a spawner will maintain can be changed using the /creaturebox limit {limit} command, where {limit} is the desired maximum. A limit of -1 sets the default, which is 10 for a managed spawner, and unknown for a natural spawner.
  
• The requirements for spawning a creature can be adjusted using the /creaturebox requires {requirements} command, where {requirements} is a space separated list any number of:
  
  • player - require a player to be within 20 blocks of the spawner.
    
  • surface - require grass for critters.
    
  • light - require light for critters, dark for monsters.
    
  • space - requires only an area to spawn mobs.
    
• A creature spawner's settings can be displayed using the /creaturebox info command.
  
• A creature spawner can be given to a player using the /creaturebox give {player} {creaturename} {count} command.
  
• Supports any permissions manager using the Bukkit API
  
• A creature spawner can be turned off by powering it with redstone.
  
• You can see what type of spawner you're holding with /creaturebox holding command.

Permissions:

• creaturebox.set - Allows use of the /creaturebox set command.
  
• creaturebox.give - Allows use of the /creaturebox give command.
  
• creaturebox.creature.{creaturename} - Allows the player to set or give {creaturename} spawners, where {creaturename} is a valid creature name (pig, cow, etc...).
  
• creaturebox.period - Allows use of the /creaturebox period command.
  
• creaturebox.count - Allows use of the /creaturebox count command.
  
• creaturebox.limit - Allows use of the /creaturebox limit command.
  
• creaturebox.requires - Allows use of the /creaturebox requires command.
  
• creaturebox.dropspawner - When a creature spawner is broken, it is dropped as an item. (They will need also the relevant creature permission for each spawner type)
  
• creaturebox.placespawner - When a creature spawner is placed, it retains its original creature type. (They will need also the relevant creature permission for each spawner type)

Configuration:

creaturebox now creates a config.yml file in .../Plugins/creaturebox.

• debugPriority: {integer range 0-3, default 2} - Sets the "noise level" for debugging messages - lower numbers = less noise. In general, you can ignore this because you have to set yourself as a debugger to see debugging messages.
  
• messagePriority: {integer range 0-3, default 3 } - Sets the "noise level" for messages which are displayed when a player types a command.
  
• enableRedstone: {boolean, default true} - Enables or disables redstone control of creature spawners.
  
• operatorPermissions: {boolean, default true} - Enables separate operator permissions. If set to false, players are given the same permissions as operators. This setting will do nothing if a permissions plugin is installed.
  
• showPlacements: {boolean, default false} - Shows the coordinates where spawners are placed or broken on the console.
  
• legacyData: {boolean, default false} - Enable the old metadata storage method (does NOT work after Craftbukkit 1525)

Notes:

• creaturebox runs spawners in two different modes. "Natural" mode, where the spawner is run entirely by minecraft (and thus won't stop working, or change behavior when the map is loaded on a vanilla server), and "Managed" mode, where the spawner is run entirely by creaturebox. A spawner is switched to managed mode if any of its settings are changed from default. Squid, Slime, Monster and Giant spawners are always run in managed mode.
  
• You can trade mob spawners with shop plugins (like ChestShop) but you need the correct spawner type id for that creature. How this is done can be read at: Trading Mob Spawners.

Credits:

• Developer: Spathizilla
  
• Developer: Lodran (Missing in action)