repository·master·Indexed 43 days ago
https://github.com/libraryaddict/libsdisguisesA Minecraft plugin for version 1.12 or newer that allows entities to take on the appearance of other entities or items. It provides an API for programmatic disguise modification and supports command-based usage, including animation triggers via /disguise animate and entity selectors for version 1.13 or newer. Available as a free version with restrictions for non-operators and a premium version with expanded player command access.
To include Libs Disguises in your Gradle project, add the https://mvn.lib.co.nz/public repository to your repositories block and add the libsdisguises dependency to your dependencies block. Note that this plugin requires Minecraft version 1.12 or newer.
repositories {
maven {
url "https://mvn.lib.co.nz/public"
}
}
dependencies {
implementation group: 'me.libraryaddict.disguises', name: 'libsdisguises', version: '11.0.13'
}To include Libs Disguises in your Maven project, add the libsdisguises-public repository to your pom.xml and add the libsdisguises dependency with provided scope. Note that this plugin requires Minecraft version 1.12 or newer.
<repository>
<id>libsdisguises-public</id>
<url>https://mvn.lib.co.nz/public/</url>
</repository>
<dependency>
<groupId>me.libraryaddict.disguises</groupId>
<artifactId>libsdisguises</artifactId>
<version>11.0.13</version>
<scope>provided</scope>
</dependency>The entity selector command allows you to apply a disguise to multiple entities at once using Bukkit entity selectors (e.g., @a, @e[type=zombie]).
Requirements:
Usage Pattern:
[command] <selector> <disguise_details> [options]
<selector>: A standard Bukkit entity selector (e.g., @p, @e, @a).<disguise_details>: The configuration for the disguise you wish to apply (parsed via the DisguiseParser).[options]: Specific flags such as setSelfDisguiseVisible can be used to modify how the entity perceives its own disguise.The entity selector animation command allows you to play specific animations on disguises for a group of entities selected via Minecraft entity selectors (e.g., @a, @e[type=zombie]).
Requirements:
Usage Pattern: To use this command, you must provide an entity selector followed by one or more animation names. The command will attempt to find all entities matching the selector and, for each entity, play the specified animations on any active disguises that support them.
Command Structure:
[command] <selector> <animation1> <animation2> ...
Note: The exact command name is not explicitly defined in this class but is part of the animate command group. The command logic expects the selector as the first argument after the base command.
# Example usage (conceptual):
/disguise animate @a dance
/disguise animate @e[type=cow] eatThe disguise help command provides documentation for available disguises, parameters, and their specific options. The command behavior changes based on the arguments provided:
disguise help <parameter>): Displays help for a specific parameter, including its description and valid enum values if applicable.disguise help <disguise>): Displays the available options/methods for that specific disguise.disguise help <disguise> show): Displays all available options for a disguise, including those the user might not have permission to use (noted as ignored options).Note: Parameter names in help commands are case-insensitive and can be used in singular or plural forms (e.g., help <param> or help <params>).
### Examples
# Get general help and parameter list
/disguise help
# Get help for a specific parameter
/disguise help <parameter_name>
# Get help for a specific disguise
/disguise help <disguise_name>
# Get exhaustive help for a disguise (including hidden/restricted options)
/disguise help <disguise_name> showThe /disguise command allows players to change their appearance using various disguise types. The command parses the provided arguments to determine the disguise type and its specific properties.
To use the command, provide the disguise type and any necessary parameters as arguments. The command is processed by DisguiseParser based on the permissions the sender possesses.
DisguiseConfig, the player's name can be hidden or shown above the disguise. If isNameOfPlayerShownAboveDisguise is true and the player has the libsdisguises.hidename permission, the name is managed via the LivingWatcher.setSelfDisguiseVisible argument.DisguiseConfig.Entity (typically a player); it cannot be run from the console.# Example usage (exact syntax depends on the disguise type being parsed)
/disguise <disguise_type> [options]If you run the /disguise command without any arguments, the plugin will display usage information and a list of disguise types you are permitted to use.
NO_PERM message.allowedDisguises based on your DisguisePermissions.player is an allowed disguise, additional help instructions (DISG_HELP2) are shown.dropped_item or falling_block are allowed, additional help instructions (DISG_HELP4) are shown.When reporting issues or troubleshooting, follow these steps:
The following subcommands are available via the /libsdisguises command. Note that availability and tab-completion may vary based on your permissions.
LDHelp
LDReload
LDUpdate
LDChangelog
LDCount
LDConfig
LDPermTest
LDScoreboard
LDJson
LDMods
LDMetaInfo
LDDebugPlayer
LDUploadLogs
LDUpdatePacketEvents
LDDebugMineSkin
LDDebugDisguiseLoop
LDMissingDescription
LDDebuggingThe disguise help command supports tab completion to assist in discovering available commands and parameters:
cow_disguise) and available parameter names.show keyword to help with detailed option lookups.To use the /ldmods command, the executing user must possess the following permission node:
libsdisguises.mods
The disguise entity command has several constraints:
Player sender.sendIfNotPremium).player, dropped_item, and falling_block.