ArmorStandTools

A full suite of Armor Stand tools for CraftBukkit/Spigot

Spigot resource page with plugin download: http://www.spigotmc.org/resources/armor-stand-tools.2237/

Inspiration

I wanted to create an armor stand for each kit in my mini-game, and I quickly became frustrated with trying to use commands and numeric values to position the legs, arms, body and head of each armor stand, so I created this plugin which allows you to do all of this with ease. Simply couch/sneak while right clicking an armor stand to open the tools. The plugin can also generate a summon command that will re-create the armor stand at any time.

Compatibility

• Armor Stand Tools v4.x.x - Spigot/CraftBukkit 1.17+
• Armor Stand Tools v3.x.x - Spigot/CraftBukkit 1.13 - 1.16
• Armor Stand Tools v2.4.3 - Spigot/CraftBukkit 1.8, 1.9, 1.10, 1.11, 1.12 (https://www.spigotmc.org/resources/armor-stand-tools.2237/download?version=175162)

Features

• Summon armor stands.
• Name armor stands.
• Toggle: Gravity, Visibility, Arms, Base, Size, Invulnerability, Equipment Lock.
• Manipulate the rotations of the Head, Body, Arms and Legs.
• Full control over armor stand's inventory (armor & items in hands).
• Pick up and move armor stands.
• Armor stand cloning tool.
• Save tool: Automatically generate a command block with the command to summon that armor stand in its current state.
• Player head tool: Give an armor stand the head of a specific player.
• WorldGuard region support, including a custom WorldGuard flag. Set the 'ast' flag for a region to deny to turn off AST use in that region.
• Customizable language config file.
• Assign commands to armor stands that are run when a player right clicks that armor stand (see below).

Assigning Commands

• Use /ascmd to assign a command to an armor stand (see usage and permissions below)
• When using /ascmd assign player , the command will be run by the player
• When using /ascmd assign console , the command will be run by the console (see Warning below!)
• When a player with the astools.ascmd.execute permission right-clicks on an armor stand, it's command is run.
• If a player is crouching when they right-click the armor stand, the command will not be run.
• Warning: Make sure you are careful when assigning console commands. Any player with the astools.ascmd.execute permission will be able to execute the command.
• By default, any command assigned to an armor stand will use the default cooldown set in config.yml. This can be set on an individual basis using the /ascmd cooldown command.

Commands

• /ascmd assign console : Assign a console command to the nearest armor stand (within 4 blocks)
• /ascmd assign player : Assign a player command to the nearest armor stand
• /ascmd remove : Remove the command assigned to the nearest armor stand
• /ascmd view : View the command assigned to the nearest armor stand
• /ascmd cooldown : Sets the cooldown (in ticks) for the command on nearest armor stand (Setting this overrides the default cooldown from config.yml)
• /ascmd cooldown remove : Removes the cooldown for the command on nearest armor stand (Default cooldown set in config.yml will be used)
• /astools or /ast : Legacy command - instructs player to crouch right-click an armor stand to use AST.
• /astools new : Create a new armor stand - will spawn being carried by the player
• /astools reload : Reload the plugin (use when changing config files)

WorldGuard Integration

• If a player does not have build permission for the region, that player will also be denied the use of AST in that region.
• Additionally, there is a custom region flag named 'ast' which defaults to Allow, this can be changed to Deny if you wish to have a region in which players have build permission, but not permission to use AST.
• The ast worldguard flag is ignored for any player with the permission node 'astools.bypass-wg-flag'. This means that a player with this permission can use AST in worldguard regions even if the ast flag for that region is set to Deny.
• The ast worldguard flag is also ignored for players that have op.

Permissions

• astools.use: Permission for using any of the tools, except for those that have a custom permission below
• astools.new: Permission to use "/astools new" command to summon a new armor stand
• astools.clone: Permission to use the clone tool
• astools.head: Permission to use the player head tool (Ability to specify a player head for an armor stand)
• astools.summon: Permission to use the summon tool (Summons an armor stand without requiring the materials)
• astools.cmdblock: Permission to use the save tool (Creates a command block)
• astools.reload: Permission to reload the plugin
• astools.ascmd.assign.console: Permission to assign a console command to an armor stand
• astools.ascmd.assign.player: Permission to assign a player command to an armor stand
• astools.ascmd.remove: Permission to remove a command from an armor stand
• astools.ascmd.view: Permission to view the command assigned to an armor stand
• astools.ascmd.cooldown: Permission to add a cooldown to commands assigned to an armor stand
• astools.ascmd.execute: Permission to execute a command assigned to an armor stand by (on right click)
• astools.bypass-wg-flag: Permission to bypass the WorldGuard ast flag, allowing the player to use AST even in regions that ast flag is set to deny.

Config

• config.yml - The main config file allows you to set the default starting settings for newly summoned armor stands. This is useful if you plan on creating a lot of armor stands with similar equipment.
• language.yml - Contains all the strings of text that the player will see. Edit this file if you wish to change the text or translate it into a different language.