https://github.com/falyrion/advancedarmorstands

A plugin for spigot, adding more functionality for armor stands
https://github.com/falyrion/advancedarmorstands

armorstand armorstands bukkit bukkit-plugin minecraft minecraft-mod minecraft-plugin papermc plugin spigot spigot-plugin

Last synced: about 7 hours ago
JSON representation

A plugin for spigot, adding more functionality for armor stands

• Host: GitHub
• URL: https://github.com/falyrion/advancedarmorstands
• Owner: Falyrion
• License: mit
• Created: 2021-08-23T21:14:25.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2024-08-04T14:29:29.000Z (3 months ago)
• Last Synced: 2024-08-04T16:20:19.974Z (3 months ago)
• Topics: armorstand, armorstands, bukkit, bukkit-plugin, minecraft, minecraft-mod, minecraft-plugin, papermc, plugin, spigot, spigot-plugin
• Language: Java
• Homepage: https://www.spigotmc.org/resources/advanced-armor-stands.38513/
• Size: 7.25 MB
• Stars: 5
• Watchers: 1
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![Text](images/advanced_armorstands_banner.png "Banner")



    

     

    

     

    

     

    



# Advanced Armor Stands

This is a plugin for Minecraft-CraftBukkit/ Spigot, adding more functionality for armor stands.

- Download from the offical spigot website: [https://www.spigotmc.org/resources/advanced-armor-stands.38513/](https://www.spigotmc.org/resources/advanced-armor-stands.38513/)

- Usage and server statistics (_not representative yet, statistic was added 5 years after plugin release_): [https://bstats.org/plugin/bukkit/AdvancedArmorStands/13743](https://bstats.org/plugin/bukkit/AdvancedArmorStands/13743)

### Contents

- [Overview and Features](#overview)

- [Depencies](#depencies)

- [Commands and Permissions](#commands)

- [Config](#config)

- [Languages](#language)



# ✨ Overview

Access all the hidden vanilla armor stands options with an easy menu. Perfect for decoration on survival servers and builders!

### Features

- Enable arms, invisible baseplates, no gravity and much more for your armorstand.

- Arange all body parts in a fancy pose you want. Or choose one of the various preset poses!

- Colorable names! 

- Invisible armor stands! Perfect for floating letters or items!

- Player heads! Get the head of every player you want and place it on your armor stand (this feature can be fully disabled!)!

- Invulnerable armor stands! Save from accidental punches!

### How to use?

Just stand next to the armor stand you want to modify and type the command `/aa` in chat! A menu will pop up with all available options!

![Text](images/advanced_armor_stands.png "Overview")



# ✨ Dependencies

This plugin was made for Spigot v.1.17 and later versions.

The lastest Version `1.18.0` of this plugin requires java `17` or higher



# ✨ Commands and Permissions

### Pose command cheat sheet

![Text](images/poses_cheat_sheet.png "Cheat Sheet")

### Commands overview

- Overview over all commands available in this plugin. All permissions are set to `true` by default.

- If you want to disable access to player heads in both menu and per command, set the permission `aa.head` to `false`.

| Command                                            | Permission | Description                      |

| -------------------------------------------------- |:----------:|:--------------------------------:|

| /aa                                                |  aa.edit   | Opens the Menu. Some functions inside the menu depend on other permission nodes.|

| /aa help \                            |  aa.edit   | Shows the help page |

| /aa info                                           |  NONE      | Shows general info about this plugin (version number, etc). |

| /aa arms \ \                        |  aa.edit   | Use "on" to give all armor stands arms. Use "off" to remove arms of all armor stands. \ defines the range around the player in which armor stands are affected. |

| /aa base \ \                        |  aa.edit   | Use "on" to give all armor stands a baseplate. Use "off" to remove the baseplate of all armor stands. \ defines the range around the player in which armor stands are affected. |

| /aa gravity \ \                     |  aa.edit   | Use "on" to give all armor stands gravity. Use "off" to remove gravity from all armor stands. \ defines the range around the player in which armor stands are affected. |

| /aa size \ \                  |  aa.edit   | Use "normal" to make all armor stands normal sized. Use "small" to make all armor stands smalls. \ defines the range around the player in which armor stands are affected. |  

| /aa glow \ \                        |  aa.edit   | Use "on" to make all armor stands glow. Use "off" to remove the glow effect. \ defines the range around the player in which armor stands are affected. |

| /aa invulnerable \ \                |  aa.edit   | Makes armor stands unbreakable/ breakable. Note: Players in creative mode can always destroy an armor stand. |

| /aa hp \ \ \ \            |  aa.edit   | Adjusts the head pose of all armor stands in a radius of  blocks around the player. |

| /aa bp \ \ \ \            |  aa.edit   | Adjusts the body pose of all armor stands in a radius of  blocks around the player. |

| /aa rap \ \ \ \           |  aa.edit   | Adjusts the right arm pose of all armor stands in a radius of \ blocks around the player. |

| /aa lap \ \ \ \           |  aa.edit   | Adjusts the left arm pose of all armor stands in a radius of \ blocks around the player. | 

| /aa rlp \ \ \ \           |  aa.edit   | Adjusts the right leg pose of all armor stands in a radius of \ blocks around the player. |

| /aa llp \ \ \ \           |  aa.edit   | Adjusts the left leg pose of all armor stands in a radius of \ blocks around the player. |

| /aa stats                                          |  aa.edit   | Shows all angles of a nearby armor stand |

| /aa visible \ \                     |  aa.visible   | Use "on" to make all armor stands visible. Use "off" to make all armor stands invisible. \ defines the range around the player in which armor stands are affected. |

| /aa name \                                   |  aa.names  | Gives all armor stands in 1 block range a colorable name. Supports all default game color codes. |

| /aa hidenames \                             |  aa.names  | Removes names from all armor stands in a radius of \ blocks around the player. |

| /aa tp \ \ \                              |  aa.tp     | Teleports a nearby armor stand to the coords \ \ \. The coords are the exact coords. To teleport a armor stand in the middle of a block use x.5 and z.5. | 

| /aa clone \ \ \                           |  aa.clone  | Duplicates a nearby armor stand to the coords \ \ \. It copies all settings but names, visibility or equipment. In creative mode equipment will be copied. |

| /aa head \ \                  |  aa.head   | Gives the head of a player. Use \ for the player name and \ for the amount of heads you want.|

| /aa give \                                 |  NONE      | Adds an armor stand to your inventory. Player needs creative mode to use this. | 



# ✨ Config

The config.yml-file contains configuration options for the plugin. To apply any changes, save the file and reload or restart your server.

> ❗ If you are looking to disable player heads, please refer to the Permissions-Section. To disable player heads you have to set the permission `aa.head` to `false`.

    

        

            Config-Path

            Default Value

            Description

        

    

    

          

            spawnWithArms

            1

            

                


                    
0 = Armorstands will NOT spawn with arms

                    
1 = ALL armorstands will spawn with arms

                    
2 = Only armorstands placed by players will spawn with arms

                

            

        

          

            ownershipOfPlacedArms

            false

            If true, only the player who placed the armor stands can modify them via commands or the menu. Armor stands that are spawned by other ways will not be effected by this setting and can be modified by everyone.

        

          

            commandEditRange

            100

            Defines the max range in which commands can effect armor stands

        




# ✨ Languages

AdvancedArmorStands can support multiple languages simultaneously. The language used is the language the user has set in his game settings. If that language is not available, english is the default option.

### Add custom languages

- To add a new language, navigate to the file `AdvancedArmorStands/ressources/lang.yml` in your servers plugin folder. Copy the section "default" and paste it to the bottom of the file. Replace the string "en_us" in your pasted section with your desired language string. After that replace all the english sentences with your own language.

- If you want to add a new language, consider sending it in to be added to the plugin. That way all players can benefit from it.

### Color codes in the language file

- To change the visual color of a sentence, you can use the default game color codes. But note, that you have to use a `§` instead of the `&` you might be used to.