iDisguiseGUI

TESTED ON CraftBukkit/Spigot 1.8 - 1.12

PLEASE DON'T FORGET TO RATE THIS PLUGIN ! ;)

Description:-

Customizable Inventory Style GUI menu system for iDisguise v5.5+ Mob & Player Disguises

(Install Latest version of iDisguise, available from https://www.spigotmc.org/resources/idisguise.5509/)

Brief Intro/Tutorial by Numero Uno

Aliases:-

/ig, /idg
(Default values, edit config.yml to add/change)

Commands:-

/idisguisegui
Permission Node Required: iDisguiseGui.main or iDisguiseGui.admin

Opens iDisguiseGui main menu, defaults with upto 9 options:-
a) Player Disguise
b) Mob Disguise
c) Falling Block Disguise
d) Item Disguise
e) Armor Stand Disguise
f) Boat Disguise
g) Ender Crystal Disguise
h) Minecart Disguise
i) Undisguise

/idisguisegui mob
Permission Node Required: iDisguiseGui.mob or iDisguiseGui.admin

Opens iDisguiseGui Mob sub-menu allowing player to select respective mob disguise available to their specific CraftBukkit/Spigot version

/idisguisegui player
Permission Node Required: iDisguiseGui.player or iDisguiseGui.admin

Opens Player sub-menu allowing player to select an online or offline (previously logged on to that server) player's skin disguise.

/idisguisegui help [<sub-command>]
Permission Node Required: iDisguiseGui.help or iDisguiseGui.admin

Display specific help on iDisguiseGui sub-command or lists help on all commands with brief help/description

/idisguisegui reload
Permission Node Required: iDisguiseGui.reload or iDisguiseGui.admin

Reloads iDiguiseGui plugin (re-loads all config files)

Menu Permission Nodes:-

1. Main Menu - iDisguiseGui.main
2. Player Menu - IDisguiseGui.player
3. Mob Menu - IDisguiseGui.mob
4. Falling Block Menu - IDisguiseGui.fallingblock
5. Item Menu - IDisguiseGui.item
6. Armor Stand Menu - IDisguiseGui.armorstand
7. Boat Disguise Menu - IDisguiseGui.boat
8. Ender Crystal Disguise Menu - IDisguiseGui.endercrystal
9. Minecart Disguise Menu - IDisguiseGui.minecart
10. Undisguise Menu Option - IDisguiseGui.undisguise

Mob Sub-Menu Item permission nodes defined by MobPermNode key in config.yml (see config.yml)

Player Sub-Menu Item permission nodes defined by PlayerPermNode key in config.yml (see config.yml)

config.yml

#
#Master Enable/Disable Switch for this plugin!
#
Enable: true
#
# Enable/Disable plugin update check from spigotmc.org
#
CheckUpdates: true
#
# Worlds to disable iDisguiseGui
#
DisabledWorlds:
- world1
- world2
#
# Aliases for iDisguiseGui command
#
Aliases:
- ig
- idg
#
# Mob Menu Item Permission Node
# =============================
# To grant individual mob menu item permissions, use:-
# <MobPermNode>.<mob>
#
# e.g. iDisguise.mob.bat
#      iDisguise.mob.creeper
#
MobPermNode: iDisguise.mob
#
# Player Menu Item Permission Node
# ================================
# To grant individual player menu item permissions, use:-
# <PlayerPermNode>.<player>
#
# e.g. iDisguise.player.name.lozz
#      iDisguise.player.name.robingrether
#
PlayerPermNode: iDisguise.player.name
#
# Filler/Blank Item's Used on Menu's with Navigation Buttons
#
MainMenuNavEmptyItem: STAINED_GLASS_PANE:15
PlayerMenuNavEmptyItem: STAINED_GLASS_PANE:4
MobMenuNavEmptyItem: STAINED_GLASS_PANE:5
MobSubMenuNavEmptyItem: STAINED_GLASS_PANE:5
ArmorStandMenuNavEmptyItem: STAINED_GLASS_PANE:3
FallingBlockMenuNavEmptyItem: STAINED_GLASS_PANE:7
ItemMenuNavEmptyItem: STAINED_GLASS_PANE:4
HoldingMenuNavEmptyItem: STAINED_GLASS_PANE:0
#
MainMenu:
  MenuTitle: "&2&liDisguise&a&lGUI"
  PlayerMenuItem: PLAYERSKULL:LozzTheDev
  PlayerMenuLabel: "&e&lPlayer &fDisguise"
  MobMenuItem: MOBEGG:Creeper
  MobMenuLabel: "&2&lMob &fDisguise"
  FallingBlockMenuItem: GRASS
  FallingBlockMenuLabel: "&7&lFalling Block &fDisguise"
  ItemMenuItem: DIAMOND
  ItemMenuLabel: "&6&lItem &fDisguise"
  ArmorStandMenuItem: ARMOR_STAND
  ArmorStandMenuLabel: "&3&lArmor Stand &fDisguise"
  BoatMenuItem: BOAT
  BoatMenuLabel: "&1&lBoat &fDisguise"
  EnderCrystalMenuItem: END_CRYSTAL
  EnderCrystalMenuLabel: "&5&lEnder Crystal &fDisguise"
  MineCartMenuItem: MINECART
  MineCartMenuLabel: "&c&lMinecart &fDisguise"
  UnDisguiseItem: PLAYERSKULL
  UnDisguiseLabel: "&4&lUndisguise"
  ExitItem: BARRIER
  ExitLabel: "&cCancel/Exit &2&liDisguise&a&lGUI"
  PlayerMenu:
    MenuTitle: "&e&lPlayer &0Disguise&0-{menunum}/{totalmenus}"
    ItemName: "&f&l{itemname}"
    ItemLabel: "&aPlayer &e{itempos}&a Of &e{totalitems}"
    PrevPageItem: DIAMOND
    PrevPageLabel: "&fPrevious Player Page"
    NextPageItem: DIAMOND
    NextPageLabel: "&fNext Player Page"
    ReturnItem: IRON_DOOR
    ReturnLabel: "&6Return To &f&lMain Menu"
    ExitItem: BARRIER
    ExitLabel: "&cCancel/Exit &2&liDisguise&a&lGUI"
  ArmorStandMenu:
    MenuTitle: "&3&lArmor Stand &0Disguise"
    NoArmsItem: BARRIER
    NoArmsLabel: "&e&lNo Arms"
    ArmsItem: ARMOR_STAND
    ArmsLabel: "&e&lWith Arms"
    ReturnItem: IRON_DOOR
    ReturnLabel: "&6Return To &f&lMain Menu"
    ExitItem: BARRIER
    ExitLabel: "&cCancel/Exit &2&liDisguise&a&lGUI"
  FallingBlockMenu:
    MenuTitle: "&8&lFalling Block &0Disguise-{menunum}/{totalmenus}"
    AllCoordsItem: DIAMOND_BLOCK
    AllCoordsLabel: "&e&lAll Coordinates"
    BlockCoordsItem: REDSTONE_BLOCK
    BlockCoordsLabel: "&e&lBlock Coordinates"
    ItemName: "&f&l{itemtype}"
    ItemLabel: "&aFalling Block &e{itempos}&a Of &e{totalitems}"
    PrevPageItem: DIAMOND
    PrevPageLabel: "&fPrevious Falling Blocks Page"
    NextPageItem: DIAMOND
    NextPageLabel: "&fNext Falling Blocks Page"
    ReturnItem: IRON_DOOR
    ReturnLabel: "&6Return To &f&lMain Menu"
    ExitItem: BARRIER
    ExitLabel: "&cCancel/Exit &2&liDisguise&a&lGUI"
  ItemMenu:
    MenuTitle: "&6&lItem &0Disguise-{menunum}/{totalmenus}"
    AmountItem: AMOUNTTYPE
    AmountLabel: "&fAmount: &e&l{itemtype}"
    ItemName: "&f&l{itemtype}"
    ItemLabel: "&aItem &e{itempos}&a Of &e{totalitems}"
    PrevPageItem: DIAMOND
    PrevPageLabel: "&fPrevious Items Page"
    NextPageItem: DIAMOND
    NextPageLabel: "&fNext Items Page"
    ReturnItem: IRON_DOOR
    ReturnLabel: "&6Return To &f&lMain Menu"
    ExitItem: BARRIER
    ExitLabel: "&cCancel/Exit &2&liDisguise&a&lGUI"
#
# HoldingMenu Used by Enderman & Minecart Disguise Menu Options
#
  HoldingMenu:
    MenuTitle: "&c&l{itemname} &0Disguise&0-{menunum}/{totalmenus}"
    ItemName: "&fHolding &e&l{itemtype}"
    ItemLabel: "&aItem &e{itempos}&a Of &e{totalitems}"
    PrevPageItem: EMERALD
    PrevPageLabel: "&fPrevious Page"
    NextPageItem: EMERALD
    NextPageLabel: "&fNext Page"
    ReturnItem: IRON_DOOR
    ReturnLabel: "&6Return To &f&lPrev. Menu"
    ExitItem: BARRIER
    ExitLabel: "&cCancel/Exit &2&liDisguise&a&lGUI"
  MobMenu:
    MenuTitle: "&2&lMob &0Disguise&0"
    ItemName: "&e&l{itemname} &fDisguise"
    ItemLabel: "&aMob &e{itempos}&a Of &e{totalitems}"
    PrevPageItem: EMERALD
    PrevPageLabel: "&fPrevious Mobs Page"
    NextPageItem: EMERALD
    NextPageLabel: "&fNext Mobs Page"
    ReturnItem: IRON_DOOR
    ReturnLabel: "&6Return To &f&lMain Menu"
    ExitItem: BARRIER
    ExitLabel: "&cCancel/Exit &2&liDisguise&a&lGUI"
    MobSubMenu:
      MenuTitle: "&3&l{itemname}&0 Sub-Types-{menunum}/{totalmenus}"
      ConfirmItem: WOOL:10
      ConfirmLabel: "&aSet/Confirm &f&lDisguise"
      ConfirmLore1: "&f&l{itemname}"
      ConfirmLore2:  "&e&l{itemtype}"
      ReturnItem: IRON_DOOR
      ReturnLabel: "&6Return To &f&lMob Menu"
      ExitItem: BARRIER
      ExitLabel: "&cCancel/Exit &2&liDisguise&a&lGUI"
      AdultItem: MOBSKULL
      AdultItemLabel: "&e&lAdult &f{itemname}"
      BabyItem: MOBEGG
      BabyItemLabel: "&e&lBaby &f{itemname}"
      PoweredItem: TNT
      PoweredItemLabel: "&e&lPowered &f{itemname}"
      NotPoweredItem: BARRIER
      NotPoweredItemLabel: "&e&lNot-Powered &f{itemname}"
      SaddledItem: SADDLE
      SaddledItemLabel: "&e&lSaddled &f{itemname}"
      NotSaddledItem: BARRIER
      NotSaddledItemLabel: "&e&lNot-Saddled &f{itemname}"
      ChestItem: CHEST
      ChestItemLabel: "&e&lChested &f{itemname}"
      NotChestItem: BARRIER
      NotChestItemLabel: "&e&lNot-Chested &f{itemname}"
      HorseArmorItem: HORSEARMOR
      HorseArmorItemLabel: "&e&l{itemtype} &fHorse Armor"
      HorseStyleItem: HORSESTYLE
      HorseStyleItemLabel: "&e&l{itemtype} &fMarkings"
      HorseColorItem: HORSECOLOR
      HorseColorItemLabel: "&e&l{itemtype} &fColor"
      LlamaColorItem: LLAMACOLOR
      LlamaColorItemLabel: "&e&l{itemtype} &fColor"
      LlamaSaddleItem: LLAMASADDLE
      LlamaSaddleItemLabel: "&e&l{itemtype} &fSaddle"
      SizeItem: MOBSIZE
      SizeItemLabel: "&fSize: &e&l{itemtype}"
      OcelotTypeItem: OCELOTTYPE
      OcelotTypeItemLabel: "&e&l{itemtype} &f{itemname}"
      RabbitTypeItem: RABBITTYPE
      RabbitTypeItemLabel: "&e&l{itemtype} &f{itemname}"
      ColorTypeItem: COLORTYPE
      ColorTypeItemLabel: "&e&l{itemtype} &fColor"
      VillagerTypeItem: VILLAGERTYPE
      VillagerTypeItemLabel: "&e&l{itemtype} &f{itemname}"
      TamedItem: NAME_TAG
      TamedItemLabel: "&e&lTamed &f{itemname}"
      NotTamedItem: LONG_GRASS:1
      NotTamedItemLabel: "&e&lUn-Tamed &f{itemname}"
      AngryItem: BLAZE_POWDER
      AngryItemLabel: "&e&lAngry &f{itemname}"
      NotAngryItem: MOBSKULL:MHF_Wolf
      NotAngryItemLabel: "&e&lNot-Angry &f{itemname}"
      CollarColorItem: COLORTYPE
      CollarColorItemLabel: "&e&l{itemtype} &fCollar"

mobtypes.yml
This file defines all mob type descriptions and mob skull/head used on the mob sub-menu, and for the MOBSKULL variable.
Do not change the key value (text preceeding the colon :)) ), but you can change the text between the inverted commas (") to whatever you want.

holditemlist.yml
This file contains items that can be used by Mobs that hold items, such as an Enderman & by disguises that use Block/Item's (i.e. falling block, item & minecart).

I've included the majority of items available from different versions of Minecraft for completeness. You can however either add or remove Hold Items (for the relevant version of Minecraft) in this file in the correct format:-

e.g.
- "SOIL:0,Farmland Block"

First two spaces, then minus/dash (-), then a space.
Next an Inverted comma ("), followed by the correct minecraft Material name, then followed by a colon (:) and the data id (0 means no data).
Then add a comma (,) and a textual description of your choice and finally another inverted comma (") to end the line.

Minecraft material names can be found @ https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html

Messages.yml
All message values can be change, but do not change the keys (text preceeding the colon :)).
Ensure each key value text (after the colon (:) has same number of placeholder variables (surrounded by % characters).


IF YOU THINK YOU'VE MESSED UP ONE OF THESE .YML CONFIGURATION FILES, AND YOU DON'T HAVE A WORKING BACKUP OF THE FILE, THEN DELETE IT AND THE PLUGIN WILL CREATE A NEW ONE WITH DEFAULTS WHEN IT IS NEXT RELOADED/ENABLED.


Future Ideas/Additions:-

I have some new ideas in mind, depending on feedback :)

• Permissions to limit mob/player menu items accessible.
  
• Support armor_stand,boat, ender_crystal,falling_block,item,minecart disguise types
  
• External plugin place holder / variable support
  
• Add variable support for held items in holditemlist.yml e.g. Mob Eggs/Mob Skulls etc.
  
• Add iDisguise visibility options to menus

Let me know if you have any sensible and great ideas with regards to what you'd like to see added to this plugin o_O

Also, If you like my work please consider donating to me (via PayPal), by clicking the Donate button below.

MANY THANKS :p
-Lozz