Lib's Disguises

Lib's Disguises

View documentation here!

Yes. This plugin supports older versions of minecraft. However, the further back you go. The more chance that you find something that breaks.
This should be limited only to disguise options. Such as disguising as a baby cow

So you tried iDisguise and DisguiseCraft and decided they were just plain buggy..
Or includes features you don't want.

Or maybe they don't have enough disguises!
iDisguise: 35 disguises supported
DisguiseCraft: 36 disguises supported
Lib's Disguises: 62 disguises supported

Maybe you heard that a large server network was running it!
The Hive!

They are all using it, from performance increases to a better control over each disguise!

Or maybe you want to just run a disguise plugin by me!
Or maybe you just need this plugin because Lib's Hungergames, BlockHunt or ZombieGame demands it!
Or maybe you know you can see yourself disguised!
Or maybe. Just maybe. You are a developer and you heard about the fact you can disguise any entity as any entity!
Disguise a zombie as a player!
Disguise a enderman as Herobrine!
Disguise all mobs as a item drop!
Disguise experience orbs as a enderdragon!

Well that's fine. There's only one limitation I know this plugin has.
And that is that it requires ProtocolLib as it uses that to edit packets.

Because it uses ProtocolLib, the observers will NEVER see the real player.
Its impossible. Unless you, as the end user. Somehow screw up.
Or if either this plugin or ProtocolLib bugs out.

Due to the fact that I mainly mean to keep this as a developer API. I will not be extending its features for quite a few things.

Basically summarized. I have no intentions to bloat this plugin with things which I don't need.

I am not going to stick in code just in-case a developer is lazy in the off-chance they might need it.
Especially since they could easily stick the code in themselves.

One example is mob sounds. I allow you to disguise as a mob. But I'm only changing the step sound. And the damage sounds. And all the other sounds needed to stabilize a disguises illusion.

Want to play the idle sounds? Such as a zombie moaning?
I don't cover that for mobs which do not 'moan' by default.
You better get coding.

It gives tons of control to the developer as well!
Which is something I'm big on.

I do not want to put a config in as that would turn this from a Drag & Drop into a Drag & Drop & Configure.

I developed this as a developer API which you can depend on.
Without the fear of forgetting to do something.

Hate the DisguiseCraft plugin and its permissions hell. Spent 30min trying to get it perfect..
Failed at it too

I just don't want to see the real players.. Was that so hard to ask?!

For those wondering about seeing yourself disguised.
It does that and there is almost no problems.
The 2 problems are: Lag and sometimes the disguise 'gets in the way'


This plugin checks for updates when it loads, and every 12 hours after this.
If there is a update found, it notifies you.
You can disable it in the config.

If you downloaded Lib's Disguises from a site other than BukkitDev.
Such as from the development builds or from the site which this plugin was originally exclusive to.

Then you will see the updates before they come on here.
It is not because BukkitDev is bugging out, but rather because the update checker is checking another site first.

The single unique reason this plugin is on BukkitDev is so that plugin developers can link to the disguise plugin.
Without having their projects taken down without warning.


If you want to use this plugin to replace DisguiseCraft.
But you have plugins dependent on that. Then there is a alternative option you can use.

Just go into google and search "Lib's Disguisecraft"
This plugin is not on BukkitDev, will never be on BukkitDev.
And is not guaranteed by BukkitDev to be safe.

Its safe tho.

Dev builds

Development builds of this project can be acquired at the provided continuous integration server.
These builds have not been approved by the BukkitDev staff. Use them at your own risk.

Developement builds

Maven Repository


Both of these are hosted by md_5! Ain't he nice.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of libraryaddict libraryaddict Apr 24, 2014 at 04:14 UTC - 0 likes

    @catprowler: Go

    You can't do disguise options per block currently


  • Avatar of catprowler catprowler Apr 23, 2014 at 20:31 UTC - 0 likes

    @libraryaddict: Go

    Hi there, do I add this to my permissions folder? Thank you.

  • Avatar of libraryaddict libraryaddict Apr 23, 2014 at 19:24 UTC - 0 likes

    @catprowler: Go

    To disguise someone as a painting.
    You would do

    DisguiseAPI.disguiseToAll(player, new MiscDisguise(DisguiseType.PAINTING));

  • Avatar of catprowler catprowler Apr 23, 2014 at 17:23 UTC - 0 likes

    Hi there, I really need to add a jack-o-lantern or pumpkin to the disguise list. I looked at your creating a disguise info, but I'm still confused. I'm not sure if this is just a Misc disguise or if I have to do Disguise Type with it. I'm not sure if this goes in the config file or group managers folder. Some of the info uses spaces (ex: MiscDisguise miscDisguise = new MiscDisguise(DisguiseType.PAINTING);), but I can not use spaces in group manager permissions. If this goes into the config file, I'm not sure if I have to add a new title (ex: DiguiseType:) and then underneath, space a few times and type (- DisguiseType.JACK-O-LANTERN)? Is there maybe a tutorial you can suggest for me. I looked it up in google and couldn't find anything on creating or adding disguises, just how to disguise as one. Thank you.

    Last edited Apr 23, 2014 by catprowler
  • Avatar of libraryaddict libraryaddict Apr 21, 2014 at 07:07 UTC - 0 likes

    @Deadlysiner666: Go

    Do you have any errors when the plugin is loading

  • Avatar of Deadlysiner666 Deadlysiner666 Apr 21, 2014 at 01:36 UTC - 0 likes

    Okay so i'm really new to this, but when i try and use /disguise it doesnt do anything, in /help libsdisguise it shows all the commands, but with "Null" beside them all, i am running a 1.7.2 server, i have the latest protocol and Libsdisguise, what is going on?

  • Avatar of libraryaddict libraryaddict Apr 17, 2014 at 13:47 UTC - 0 likes

    @minebuild3543: Go

    The latest version should work up to 1.5.2 without problems

  • Avatar of minebuild3543 minebuild3543 Apr 17, 2014 at 12:09 UTC - 0 likes

    Did the 1.7.2 version works for CraftBukkit 1.7.2-R0.2? I will try and tell you if don`t tested.

    Last edited Apr 17, 2014 by minebuild3543
  • Avatar of libraryaddict libraryaddict Apr 17, 2014 at 11:57 UTC - 0 likes

    @xXAgenTXx: Go

    I do not comprehend

  • Avatar of xXAgenTXx xXAgenTXx Apr 17, 2014 at 11:14 UTC - 0 likes

    i can activate it i am at mc1.7.2


Date created
Jan 14, 2014
Last update
Apr 16, 2014
Development stage
All Rights Reserved
Curse link
Lib's Disguises
Recent files