Disguise
The disguise system is very advanced and might be difficult to understand at first.
Note: The disguise system is not 100% coded by me. I use a Disguise API that you can find here
Commands
/disguise
it will open a menu where you can select your skin.
/disguise (name)
This opens the same menu, but with the name you have chosen.
/disguise groups load
This will load all the luckperms groups. When you disguise and after you have chosen a skin you can select a prefix. It will get all the prefixes from the Luckperms groups. You can disable specfic groups in the config. See more here
/disguise names add
Add a name to the name list in the config.yml
/disguise names remove
Remove a name from the name list
/disguise names list
Get a list of all disguise names
/undisguise
Undisguise yourself
/undisguise (Player)
Undisguise a player.
Permissions
easycore.disguise.addname
Add a name to the name list
easycore.disguise.custom
Disguise with a custom name
easycore.disguise.luckperms.load
Load all luckperms groups
easycore.disguise.removename
Remove a name from the name list
easycore.disguise.others
Undisguise other players
easycore.disguise.entity
Disguise as an entity (mob)
Groups
The plugin uses LuckPerms groups, which is why LuckPerms is required for it to work.
When the plugin loads it will check the list if it has all luckperms groups on the list. If there are groups that aren't on that list it will add them. You can disable groups if you don't want players to disguise as such as staff ranks. As you can see in the example config below you can see that I have disabled the owner rank and the testing rank. The disguise menu with the prefixes will now only have 2 items instead of 4.
prefix:
owner: false
default: true
testing: false
member: true

Names
If you only do /disguise
it will open a menu and when you select your skin and the prefix you will be given a random name. You can add/remove names to/from the list in the config or you can do it in the config.yml.
Entity
If you want to disguise as an entity you can do /disguise and click on the hopper. Then it will open a menu with all the entities in the game you can select one and you will be disguised. Since you are an entity, you won't have a skin or prefix—just your regular name.
Join/Leave message
If you have the join/leave message enabled in the config it will send a leave message and after 10 seconds that you disguised it will send the join message with your disguise name. You can disable this or change the messages in the config.yml
join:
enabled: true
message: "&a%player% has joined the server"
leave:
enabled: true
message: "&a%player% has left the server"
Extra info
When you want to disguise as a custom name you still have to follow the minecraft IGN rules.
It has to be longer than 3 characters and cannot be more then 16 characters
It cannot have illegal characters such as #, !, ^ etc.
When you select a group/prefix you will only get the prefix you will not get the permissions from the group.
Examples
example 1
So lest disguise as a player. I want to have the Technoblade skin, have the member prefix and my name will be billy_bob_2.
Lets start by just doing /disguise billy_bob_2

Now lets choose the skin. As I said I want the technoblade skin.

There are only 2 groups I can choose since I removed the owner group and the testing group.
I will get a message that I disguise as billy_bob_2. And that I left the server
I am now fully disguised as billy_bob_2
example 2
I want to disguise as a Giant.
/disguise

I click on the hopper

Now I search for the giant

and boom, I am disguised as a giant.
NOTE: You will not see yourself as a giant, but other players will.
Last updated