Mirrors/ArmorStandTools
3
0
Fork 0
Mirror von https://github.com/St3venAU/ArmorStandTools.git synchronisiert 2024-12-27 12:00:07 +01:00
Code Issues Pakete Projekte Releases Wiki Aktivität
1e7a868862
ArmorStandTools/README.md
Steven 42b6b66f63 v4.0.0
2021-07-10 20:38:15 +08:00

5.4 KiB
Originalformat Blame Verlauf

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

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.

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.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.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.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 of 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.