ArmorStandTools - Tools for manipulating armor stands


#1

This is a discussion topic for the Ore project, ArmorStandTools. View the full project on Ore for downloads and more information.


ArmorStandTools

Faithfully cloned from St3venAU’s Spigot plugin


PLEASE REPORT ALL BUGS TO THE BUG TRACKER!


An easy to use utility plugin for creating, configuring, positioning, and tweaking armor stands.

Features:

  • Perfectly position and rotate every armor stand element. The rotation is measured by how far up on the body you click.
  • Perfectly position and rotate the armor stand itself. Body rotation is done via vertical click point as well, while using the motion tool moves the stand by 0.1 on a given axis.
  • Pick up and carry armor stands around with you for quick and easy placement.
  • Set a default armor stand template which will be used for every new armor stand created.
  • Clone existing armor stands with one click.
  • An easy to use GUI that lets you do several things with an armor stand.
    • Change the name, the size, the gravity, and every other property about the armor stand.
    • Edit the equipment and held items.
    • Convenient player head spawning.
    • Create a command block item to summon this armor stand.
  • Permissions are set up so you could conceivably give this to survival mode players.

For users of the Spigot version

  • Inventory saving now persists across server restarts.
  • Command block spawning will include any custom data from other plugins or mods on the armor stand.
  • Multiple players can edit the same armor stand concurrently, and the GUIs will update in real-time.
  • Text input is done through chat; no more sign limitations.
  • Other plugins or the /give command can create items which act like a particular tool.
  • Stands can have multiple commands stored, and individual stands can be specified in the command. Coupled with point #2 this means that command blocks can spawn stands with commands already on them.

Commands

/armorstandtools or /ast: Give yourself the set of tools. Comes with element positioners, stand positioners, a stand rotator, a stand summoner, and the GUI opener. This will back up your inventory and clear it, so as to make way; running the command again will restore your inventory.
/ast reload: Reloads the config.
/ascmd assign player|console [<stand>] <command>: Adds command to the armor stand. This command, along with all the other ones on the stand, will be run when someone right-clicks the armor stand, unless they are sneaking. If stand is not specified, the closest one is used instead.
/ascmd view [<stand>]: Views all commands stored on stand. If stand is not specified, the closest one is used instead.
/ascmd remove [<stand>] [<index>]: Removes command index from stand. If stand is not specified, the closest one is used instead. If index is not specified, all commands are removed instead.

This plugin supports /sponge plugins reload.

Permissions

astools.command: Allows usage of the /ast command.
astools.reload: Allows usage of the /ast reload command.
astools.use: Allows usage of non-spawning tools.
astools.clone: Allows usage of the clone tool.
astools.summon: Allows usage of the summoning tool.
astools.head: Allows usage of the head spawning tool.
astools.cmdblock: Allows usage of the command block creation tool.
astools.ascmd.assign.console: Allows use of /ascmd assign console.
astools.ascmd.assign.player: Allows use of /ascmd assign player.
astools.ascmd.view: Allows use of /ascmd view.
astools.ascmd.remove: Allows use of /ascmd remove.
astools.ascmd.execute: Allows use of stored commands on an armor stand.

Configuration

# The default gear on a newly summoned armor stand.
# Each item is in the same NBT format that you'd pass to /give.
# Use null (not in quotes) to omit an item. 
default-gear {
  helmet = {
    id: "minecraft:skull"
    Damage: 3
  }
  chestplate = {
    id: "minecraft:iron_chestplate"
  }
  leggings = {
    id: "minecraft:iron_leggings"
  }
  boots = {
    id: "minecraft:iron_boots"
  }
  main-hand = null
  off-hand = null
}
# The default settings on a newly summoned armor stand.
default-settings {
  arms = true
  base-plate = false
  gravity = false
  name = null
  invulnerable = false
  small = false
  # All settings past this point do nothing right now.
  visible = true
  equipment-lock {
    hands = none
    helmet = none
    chestplate = none
    leggings = none
    boots = none
  }
}

Planned features

  • The rotators are perfect analogs, but are difficult to get the hang of. Perhaps a tool that simply points a body part in the same direction you’re looking?
  • Support for region protection plugins.
  • Support for translations. Unlike the original, the plugin will come packaged with all translation files, and players will see messages in the language they’re using.

Changelog

1.0: Initial release.
1.1: Stored commands added.

Statistics collection

This plugin uses bStats to collect metrics. A list of all metrics collected can be found here. This data is unobtrusive, lightweight, and completely anonymized, so there is no reason whatsoever to disable it. However, if you wish to do so anyway, simply set enabled to false in config/bStats/config.conf.


Porting over a Spigot Plugin?
#2

A new version has been released for ArmorStandTools, it is available for download here.


  • Fixed a couple of bugs I didn’t catch before releasing.

#3

no toggle invisibility?


#4

I couldn’t get it to work. If it’s a Sponge bug, visibility will get fixed when the bug gets fixed; otherwise, it’ll be fixed when I figure it out.


#5

@pie_flavor: Using Keys.INVISIBLE on an ArmorStand worked for me.


#6

A new version has been released for ArmorStandTools, it is available for download here.


Added stored commands! Now you can attach commands to armor stands that players will run on right-click.