Bukkit

THIS PAGE IS NO LONGER USED. CONSIDER IT INACTIVE. GO TO THE MAIN CONFIG FILE PAGE INSTEAD.

Config

This is the most important part of the entire plugin and it is very important to explain this just right so I have tried to make this as simple and to the point as possible. This should go over every bit of the config and make it easy to understand. If I fail to mention something please feel free to notify me in the comments below and I will explain it to the best of my ability. For this example, I will be using the skeleton mob.

The Config:

Config options:

UseCustomDamage: true

The above line turns on or off the use of custom damage for all mobs. It is the first line in your conifg. If set to “false” all the mobs will do the normal amount of damage that they always do.

Normal Config Options

The below are available for most if not all custom entity types. I will use Skeleton for the purpose of this example, but you can set these for multiple mob types, such as blaze or ghast or spider etc.

SkeletonSpawnNatural: true

The above line sets if you want the mob to spawn naturally around the world. This does not set the rate at which it will spawn, that is later on.

SkeletonCommand: true

If set to true, custom skeletons will be spawnable by command (if you have the permission). If false, they will not spawn by command even if you have the permission. If you set SkeletonCommand and SkeletonSpawnNatural to false, the mobs will not spawn and skeletons will stay completely normal in your server as they were before. (This can be doable for any mob.)

SkeletonEdit:

Do not touch this line or delete it.

spawnrate: 100

This is the rate at which the skeleton will spawn instead of its respective entity. For this case, every 100 skeletons that spawn will be turned into a Custom Skeleton (the one you define in the config). This does not effect SkeletonCommand, and only effects SkeletonSpawnNatural. If you want every mob in your world to spawn as a custom mob, set this to 1. If you wanted 1 in 50 skeletons that spawn to be your custom skeleton, turn it to 50 etc.

dropchancehelmet: 0.1

dropchancechestplate: 0.1

dropchanceboots: 0.1

dropchanceiteminhand: 0.1

dropchancelegs: 0.1

This is the chance the mob has of dropping its respective armor pieces (setting what the head gear is, is below). 1.0 is a 100% chance of drop, and 0.5 would be a 50% chance of drop etc.

health: 25

This sets the amount of hitpoints the actual entity can take before death. Should be relatively self explanatory. The more health, the more hits it can take before dying.

removewhenfaraway: true

This in essence makes the mob never despawn. If you spawn the mob, its not going anywhere basically, or if it spawns naturally.

usecustomnameatall: true

This has one basic purpose, if this is true, the name of the mob and whether it is visible will be determined by name and namevisible. If this is false, there will be no custom name on the mob at all and in regards to it’s name, it will be like any other mob of its respective type.

name: SkeletonName

This is the name of the Custom Mob. It will appear above it’s head and can be configured to always be there with the below config option.

namevisible: true

This will make the name you defined in the above config option always visible, even if you are not looking at the mob. Just like a players name tag basically, except on a mob.

fireticks: 0

This sets how many ticks the mob will be on fire after spawning.

boots: 301

chestplate: 299

legs: 300

helmet: 298

iteminhand: 283

The above options pick what items the entity is wearing and has in its hand. The above would make it have full leather armor and a gold sword in its hand. You can pick which items you would like it to wear/have in its hand by entering the item id. You can find the id list of all items here.

alertplayersonspawn: true

This will send a message to your server that the custom mob has spawned! The message that is sent to the server is configurable in the config option below.

alertplayersmessage: A Custom Skeleton has Spawned!

This config option is what message will be displayed when the Custom mob spawns, it will only be displayed if alertplayersonspawn is set to true.

damage: 10

This is how much damage the entity (Skeleton or any mob) will do to players when it hits them. If UseCustomDamage is set to false, this will do nothing. If UseCustomDamage is set to true, it will do the custom damage amount. Only the custom respective entity type will deal that custom damage amount, normal mobs will do their normal damage amount.

Unique Config Options

These are available for certain entities only, such as setting custom creepers to be charged and super.

baby: false

This config option is available for Zombies, and you can choose to make the custom zombies spawn as babies.

size: 4

This option is available for Slimes and MagmaCubes. You can set the size at which they will spawn. I default at 4, which means basically the normal/large size. But you can change this option to 20 or higher is you want a massive MagmaCube/Slime!

Custom Deaths

These options are available individually for all entities, letting you set custom exp drops, and up to 5 custom item drops for each mob! For the purpose of this example I will use skeleton, but these options are available for all mob types I offer.

UseCustomDeaths: true

If this is set to false, custom deaths will not be used at all no matter what happens or what your further config options are. In other words, mobs will drop the same items they usually do (in addition to your armor drop percentages if you choose to set those in the above config options for each mob).

CustomDeath:

Do not do anything to this config option line and do not delete it.

SkeletonDeathUse: true

If set to true, the Custom Skeleton (only the custom skeleton, not normal skeletons that spawn, if you choose to still have normal skeletons spawn) will have a custom death event. This is available for each mob so if you want only certain mobs to have a custom death event you can turn it off for certain ones and on for others.

ExpAmountDropped: 10

This is the amount of exp the mob will drop upon death.

itemdrops1: 1

itemdrops2: 1

itemdrops3: 1

itemdrops4: 1

itemdrops5: 1

Set these above options to the item you want the mob to drop upon death. You use the item id number, which you can find a list of HERE. These items will then be dropped on death from the entity. Keep in mind, you have to have SkeletonDeathUse set to true (or whatever the respective mob is) and UseCustomDeaths set to true for these to be active. If you only want it to drop 1-4 items, just simply set one of the items to be 0.