Anyone who has been active on the main forums in the last few days must surely have already heard the news.
I'm not going to comment on why and how, but the short version is that Bukkit is almost certainly not getting passed this.
Consequently, the future of BukkitDev is very uncertain. Even if the legal matters were resolved tomorrow there isn't really anybody left to deal with file submissions anyway. There's no indication about how long the site will stay up and what will happen to the files.
Anyway, while I will continue updating and developing my plugins you will need to look for updates somewhere else, namely the wiki. I will be updating this wiki in the next few days to facilitate better communication (forums, email, etc.) and adding any documentation that's missing.
I will also, of course, be looking into porting the plugins over to whichever API emerges from the ashes!
Introduction
Mobs gives you the ability to control almost every aspect of the mobs on your server, and a few other things on top.
The concept is simple - as your server is running, things are constantly happening. Players are mining, mobs are spawning, the sun is going down, it's starting to rain, etc.
Behind the scenes, CraftBukkit is sending messages to all interested plugins about these events. Player John broke a block of stone in world at location 55, 23, 137; A sheep died in world at location 209, 77, 22, etc. There are dozens of events, and thousands of these messages are sent every minute.
Most plugins listen for a few of these messages and act upon them. Mob-blocking plugins, for example, listen for new mobs spawning somwehere, and then look at the config to decide whether to allow or block the mob from spawning. Chat filtering plugins listen for the player is chatting messages and block/edit them according to the config.
Mobs listens for most (eventually all) of the mob-related messages, and a few extra ones, and gives you the option to block, allow, or alter the effect of the event.
However, it goes beyond that in that it allows you to use the event to perform one or more actions. So, while you may not want to interfere with creepers spawning, you can use this event to change the weather, set the time, drop an item somewhere, give someone some experience points, or as many of the dozens of possible actions that you want.
Additionally, it's possible to use conditions to filter the events you act upon. Want to give creepers a 1 in 1000 chance of taking out half your house when it explodes? Not a problem (except for the house).
Config.yml
checkfornewerversion - set to yes to allow the plugin to contact this site and see if there is a newer version available. Note that it onlys checks, and doesn't download anything.
generatetemplates - set to yes to have the plugin create empty config files for every possible event. Alternatively, simply look up the names on the
tutorial and create only the files you want.
worldstoignore - a list of worlds in which the plugin will be effectively disabled, ignoring all events in those worlds.
allow_debug - set to yes to enable other plugins to access the event API (for logging, debugging, etc.)
Commands
There is one only command in the plugin, which is
/reload_mobs, or
/rm. The reloads the config without reloading the plugin itself.
Users need the mobs.can
reloadconfig permission, or to be an op.
Update checking
If you like, you can set the plugin to check for any newer versions that get released. To do this use the check
fornewer_version option in the config file. This only works for release builds so you won't be bothered by any beta or dev builds.
Note that no update will be downloaded even with this set.
Tutorial
Start the tutorial
here to read up on how the plugin works
The tutorial for the old config can be downloaded from
here for offline viewing.
Updates
Updates for all my plugins will be announced via Twitter, which you can find
here.
Dependencies
Mobs has another plugin as a dependency called Extra Events. Read more about it
here.
Make sure you install Extra Events as well otherwise you will get errors on startup!
Donate
Mobs takes a lot of time to maintain, so if your server is enriched by it and you have some spare donations please consider sharing!
If you're penniless or like
Mobs but not that much I'm also partial to TF2 items. Send any you don't want my way! STEAM id: coldntired
If you don't know what TF2 is, then start playing! It's
free and fun!
How to increase mob movement speed?
@bob15691 The spawn reason is CUSTOM, which is what any mob created by command gets. However Mobs overwrites this internally and renames it as SPAWNED.
Plugins using Bukkit only will see CUSTOM, whereas Mobs (or plugins using Mobs API) will see SPAWNED.
Armour would be set boots/leggings/chestplate/helmet item=...
@coldandtired
I found the cause of the console error spam, it's caused by unloading a world with Multiverse.
How to make mob wear armor?
What spawn reason mobs uses when spawns a mob and is there way to spawn mobs in a big area around all players by using timer.txt
@coldandtired
That is the whole error =P
Here's my spawns.txt (It's an eyesore): Link Removed: http://www.mediafire.com/view/?1p700ymee2s5n3r
@6Twisted I would need to see the whole config and the whole error text.
What have I done wrong here? My custom loot doesn't work when using sub.
I'm also getting error spam in the console: [WARNING] [Extra Events] Task #68 for Extra Events v1.5.2 b2 generated an exception 03:15:44 java.lang.NullPointerException
@BlueDwarf D'oh!
Fixed - http://dev.bukkit.org/bukkit-plugins/mobs/files/140-1-5-2-b9/
It was because the item element also accepts the format x to y, so it was getting confused because of the 'to' in 'stone'.
@coldandtired
When I try that it gives me an error about input string "NE_SWORD"... If I change Stone to Wood, it works fine.But for some reason the STO keeps getting chopped off.
Tried with other items types too (ex, stone_hoe) and those gave the same error. The ID for stone swords (272) worked fine as well, just 'stone_whatever' doesn't want to work.
Seems a bit weird.
@bob15691 spawns
I don't understand how to do this, please write a example.
@bob15691 This is because the mob that spawns is not the same one as the one in the event (that's how Bukkit works).
All setting up should be done in the spawns event. You would also need to use set item_in_hand instead of give for mobs.
Thank you for reply.How to give a stone sword to a skeleton and why it does not work,
it spawns skeletons but without swords.
<linked_action name="witherskeleton1" action="spawn" sub="mob" mob="skeleton" amount="1 to 2"/>
<linked_action name="witherskeleton2" action="set" sub="skeleton" value="wither"/>
<linked_action name="witherskeleton3" action="give" item="STONE_SWORD"/>
<action>
<entry if_world="world_nether" if_spawn_reason="Natural" if_mob="pig_zombie" if_percent="below 41" action="witherskeleton1 + witherskeleton2 + witherskeleton3"/>
</action>
@bob15691 They aren't separate mobs so you need to set properties on the base mob to change them
or
How to spawn a wither skeleton or charged creepers, I don't find them in mob list?
I've just written a basic spawns.txt generator for myself because I was sick of typing xP It's here if anyone else would like a template for an RPG server:
Link Removed: http://www.mediafire.com/?n2gaxpp4aozcp1w
Screenshot: http://i.imgur.com/qfw9S5u.png
(It's not a virus, honest xP)
@6Twisted As far as I know you can add potion effects to any mob, but there are fewer effects than for players.
Not sure about item names, I'll look into it.
@BlueDwarf D'oh! That's what I get for not writing it in an XML editor :)
It can branch on every value if you need it to, and will search upwards when it doesn't find a required value (sub could have been at the event level in that example as well).
I updated the link a couple of versions ago but the config files won't update unless the value is removed completely. It should be fine for new installs though.
Set max_hp works exactly like that. According to the docs mobs can be healed sometimes but I mainly intended it to be for lowering current HP without lowering max_hp (a spell to reduce a boss' HP by half, for example). If mobs very rarely (or practically never) get healed it's probably useless.
@BlueDwarf
Thank you, yes, I typed hp_max instead xP And thanks for the full_hp tip, that'll save me some typing =P And no I think the site's somewhat out of date.