ArmorStandEditor-Reborn

Updated for Minecraft 26.3. This release adds head retrieval limits, an admin cleanup tool for invisible empty stands, Dominion support, and a long list of fixes.

Read Before Updating

- New file: playerheads.yml is generated on first load and stores per-server head retrieval counts. - Head limit is on by default: maxNumberOfHeadRetrievals defaults to 5. Raise it in config.yml if you don't want players capped. - Reset with care: the head reset command is admin-only and can zero everyone's retrieval count. - Paper plugin descriptor: ASE now uses paper-plugin.yml. Run it on Paper or a Paper fork. - Java 25 is required (carried over from 26.1).

Config Changes

Add these to your config.yml under Misc Options:

#---- Misc Options

# Limit the number of times that players can get their head on the server
maxNumberOfHeadRetrievals: 5

# Prevents players from leaving invisible armor stands with nothing equipped around the world.
# Stands with a visible custom name (holograms) are ignored.
#   OFF     - Do nothing (default)
#   VISIBLE - Make the stand visible again
#   GLOW    - Keep the stand invisible, but make it glow so it can be found and removed
invisible-empty-stand:
  mode: OFF # OFF | VISIBLE | GLOW

- Head retrieval counts are stored in the new playerheads.yml.

New Commands & Permissions

| Command / Permission | Description | |---|---| | /ase resetHeads | Resets head retrieval counts back to 0, with a confirmation step. Admins/OPs only. | | asedit.resetHeads | Allows resetting the head retrieval count for a player. Admins only. | | asedit.resetHeads.all | Allows resetting the head retrieval count for all players. Admins only. |

New Features

- Invisible empty stand mode: admins can clean up empty invisible stands by making them visible again or glow (see config above). - Player head limits: head gathering is limited per server and persisted in playerheads.yml. - Legacy small size: the legacy small ArmorStand size is back, with menu integration. - Equipment lock copy and paste: copy and paste lock slots between stands. - Dominion protection: support added using DominionAPI 4.7.3. - GriefPrevention protection: reimplemented, with a config option. - MiniMessage support for tool lore, plus legacy color code translation in the language system. - Shelves added to the interactables list.

Improvements

- Updated to Minecraft 26.3. - Permission checks now allow ItemFrame interactions, and ArmorStand permission handling is refined. - Dominion edit privilege flag changed from PLACE to BREAK_BLOCK. - Towny protection: better entity checks and logging (ItemFrames need special handling). - Better glowing handling, highlight method refactor, and menu fixes. - Command handling partially moved to Brigadier. CommandEx return values are no longer always the same. - Language class refactored for thread safety and better config handling. - Conditional config loading now gathers only conditional entries. Item tool validation and config reset fields refactored. - Added debug logging for entity protection, visibility enforcement, empty stand checks, edit permission checks and head resets. Default debug log level changed. - Reduced complexity in onEnable, and cleaned up isEditTool. - Updated the WorldGuard dependency and upgraded Gradle to 9.6.1. - Plugin version is now resolved at build time.

Fixes

- Scheduler not initializing. - ASE not being allowed to interact with some interactables (potentially fixes #865). - Claim protections being ignored for ArmorStand interaction (#881). - ResetWithRange missing from the /ase ? output. - customModelDataValue bug. - Option keys not resolving to their translated value before substitution. - NPE in command handling. - Head reset commands now validate the target player and handle offline players safely. - Removed redundant permission and equipment null checks. - Replaced deprecated code in a debug message. - Reverted the changes that were required for Scale.

New Contributions

- None listed in the changelog. Full Changelog: https://github.com/Wolfieheart/ArmorStandEditor/compare/2…

This is the ASE Update for 26.1 through to 26.1.2. The first of the new numbering scheme cause Mojang decided, following Windows is a good idea. Cheers!

Read this before updating

ASE as of 26.1 is built using Java 25. If you need to update your Java on your Server, please read https://docs.papermc.io/misc/java-install . Failure to do this before updating to 26.1 or higher, and complaining that ASE is giving an error like has been compiled by a more recent version of the Java Runtime (class file version 65.0), this version of the Java Runtime only recognizes class file versions up to 61.0 will result in your issue being closed as NOT A BUG.

Config Changes

ArmorStandEditor now supports a way to block armorStands with given names from being edited. So you can do that by adding the following to your Config.yml

#----------- BLOCKED NAMES
# Armor stands with the following names will not be able to be edited
# Use exact name matching (case sensitive)
enableBlockedNames: false
blocked-names:
  - "BlockedArmorStandName"
  # - "ItemsAdder_furniture"

Also CustomDataModel is now done by using float numbers , not integers as in line with the PaperAPI

#Also please if you are using this, ensure that you also give people the ability asedit.give in
#order to allow them to change their edit tool for the right Custom Model Data
allowCustomModelData: false
customModelDataInt: 0.0

Other Changes

- Better Update Checker - Java 25 Support - CoreProtect Support - Folia is better supported - Maven has been replaced with Gradle - Better Towny Permission Check - Introduction for Bolt Protection (for users of Bolt)

New Contributors

* @Izopropyl made their first contribution in https://github.com/Wolfieheart/ArmorStandEditor/pull/845 Full Changelog: https://github.com/Wolfieheart/ArmorStandEditor/compare/1…

[1.21.11-50.1] Fix for Custom Item Model not working Fix for Folia: #813

This is the newest and biggest update to ArmorStandEditor since I took the project over, this is teh First ever Paper ONLY Update for ArmorStandEditor.

What has changed:

Alot. There is now support for Hex Colors, Versioning, Range ArmorStand Resets. There are also numerous bug fixes for example: Towny's Integration also not working as intended. Size and other features not working.

Config Updates:

You can compare your config to the new one on https://github.com/Wolfieheart/ArmorStandEditor/blob/mast…

What has disappeared:

What sadly has been dropped is Spigot Support buit this means going forward, ASE will work completely with the Paper Architecture.

What's Changed

* Improved Russian translation by @GENIIY in https://github.com/Wolfieheart/ArmorStandEditor/pull/713 * Cache repeated Inventory#getHolder calls by @Warriorrrr in https://github.com/Wolfieheart/ArmorStandEditor/pull/723 * Improve towny integration by @Warriorrrr in https://github.com/Wolfieheart/ArmorStandEditor/pull/722 * Use PaperLib to further avoid holder snapshotting by @Warriorrrr in https://github.com/Wolfieheart/ArmorStandEditor/pull/736 * [CORE] ArmorStandEditor 1.21.6-49 / 1.21.7-49 by @Wolfieheart in https://github.com/Wolfieheart/ArmorStandEditor/pull/728 * [CORE] ArmorStandEditor 1.21.10-49.2 by @Wolfieheart in https://github.com/Wolfieheart/ArmorStandEditor/pull/767 * Update GitHub Artifact Actions to v5 (major) by @renovate[bot] in https://github.com/Wolfieheart/ArmorStandEditor/pull/777 * Fix for Size Menu being Broken

New Contributors

* @GENIIY made their first contribution in https://github.com/Wolfieheart/ArmorStandEditor/pull/713 * @Warriorrrr made their first contribution in https://github.com/Wolfieheart/ArmorStandEditor/pull/723 Full Changelog: https://github.com/Wolfieheart/ArmorStandEditor/compare/1…

New things - [rc2] 1.21.6 and 1.21.7 Support (thanks Mojang) - [rc3] PaperLib Support ( https://github.com/Wolfieheart/ArmorStandEditor/pull/736 ) Bug Fixes: - Fix for https://github.com/Wolfieheart/ArmorStandEditor/issues/720 (See Feature Changes below) - Fix for Team Registration issues regarding the AS-InUse Team. ( java.lang.IllegalArgumentException: Team name 'AS-InUse' is already in use ) will now just continue like with lockedTeam if its already found. - [rc2] Fix for users clicking on a blackPane throwing a Command Issue Feature Changes: - Size Menu will now allow you to do individual armorstands instead of just targetting those in a 1 block radius - PresetPoses will also now allow for individual armorstands (similar as change to size menu) - Running /ase stats will now also report if the ArmorStand is InUse

Contains a fix for the Size Menu not working as intended. TLDR: Fix for Scale not working with the replace in the size menu. Make it depend on the IconName but correctly compute how we get that.

This update introduces ArmorStandEditor to the 1.20.5/1.20.6 update. This versions will work on all APIs until 1.17 (See the changelog for more info as to why we are doing this) and is built using Java 21. Important Change to Player Heads Just a heads-up: starting from version 1.20.6-46, we're waving goodbye to the Old Player Head Command. So, in this update, using "/ase playerhead" will only snag you the current Player's Head. No bugs here, folks! Please do not report it as such! This is the new intended behavior. Why? Short Answer: Because Mojang decided it's time to move on from the way it used to work. Longer Answer: We're just keeping things simple and cutting down on maintenance headaches. What EXACTLY has changed? - The Config Option allowedToRetrievePlayerHead has been renamed to allowedToRetrieveOwnPlayerHead. - asedit.head has not be removed. Retrieving Player Head will work with EITHER/OR Q: I want the old Player Head System Back, how can I enable this? If you're feeling nostalgic and want the old functionality back (and hey, want to share it with everyone), go ahead and fork ASE and shoot us a Pull Request. I will not, at this stage, be investing the time and energy to look at how to implement it. New Permission: asedit.rename.color As was a problem on a few servers, admins wanted the ability to block Color Code Edits on an ArmorStand. Therefore we have now added asedit.rename.color that will block color edits, if not enabled. Please set that permission true to keep the functionality as it is now. Otherwise, you will have players asking why they get the below error message when trying to make their armorstand have a colored name:

Please make sure you have the ability/permission to give your ArmorStand Colored Names.

What else has changed? - Fixed issue when Paper/Folia users were updating to 1.20.5 - Fixed the long overstanding bug where /ase give wouldnt work if you had configuration option enabled but not the permission. Now looks at either/or - Added ItemAdder/Custom Furniture Protection - Fixed Menu to show Blank Slots when users dont have permissions. - Updated the version check to take from the config not the Plugin Description File. Full Changelog: https://github.com/Wolfieheart/ArmorStandEditor/compare/1…

Greetings and Happy Holidays from the team. This will be the last ArmorStandEditor release for the year 2023. This update is a "minor" change that introduces: - Support for 1.20.4 - Fix an issue in BentoBoxProtection when using AOneBlock in place of BSkyBlock - Fix for a minor issue with the UI BUT there is one surprise now added to the Plugin. If you can find it, without reading the below - Props to you! Wishing you a happy holidays, whatever you celebrate, and a safe and healthy start to 2024. Kind Regards, Wolfie <hr /> - NEW: Preset Poses One final update or new feature that managed to slip in last minute before the year end. There is now a list of preset poses in the plugin. This works the same way the /ase stats command does, in which you need to be next to the Armor Stand in order for the preset to take effect. For Server Owners/Admins: This is mapped to the asedit.basic permission as I see this as part of the basic functionality of the plugin. List of Poses can be found below: - Sitting - Greeting (2 Different Poses) - Waving - Cheers - Archer - Dancing - Hanging for Dear Life (probably needs a better name LOL) - Present - Fishing There is also an easy way to get back to the main menu and a short How To message on how to use it. When setting a pose, you will hear a Comparator Click and the Menu will close automatically. This is not a bug so please do not log support tickets on it.

This update is to hotfix some issues in the ASE 1.20(.1)-43 and 43.1 releases. This versions will work on all APIs until 1.14. NOTE: Not all features will work but this has been tested both on 1.19 (Folia) and 1.20.1 (Paper) However this will be the last version to support anything below 1.17, so If you are using 1.16.5 and lower, this is will be my last update for those versions.

Why no more support for below 1.16.5?

Per the statistics/metrics that we get via [BStats](https://bstats.org/plugin/bukkit/ArmorStandEditor/12668), most of the player base are using a version higher than 1.16.5, therefore I don't see a need to keep things backwards compatible to below 1.17. Don't worry, the versions that have been made available previously to those using 1.16.5 and lower, will still be made available to download via Spigot and Here on Github via the Readme File.

What's Changed/been fixed?

- [CORE] Fix the broken permission for ArmorStandVisibilility - #WolfieCantSpell - [CORE] Fix the permission check for being able to edit an ItemFrame - [CORE] Fix for the String Duplication when warning about MC Versions (Internal Refactor) - Some fixes for the Readme File - Mostly fix the Logos for Jetbrains and Shamblecraft. Full Changelog: https://github.com/Wolfieheart/ArmorStandEditor/compare/1…

- [CORE] Implementation for PlayerHeads by Command NOTE: To use this you will need to enable the following in your config.yml (Or regen and you will see the options) + the permission asedit.head in order to use this functionality

#(Optional) Allow Players to get Player Heads from a Command. NOTE: If this is False, this will not work.
#You will also need asedit.head to be set TRUE as well in your Permissions Manager / File
allowedToRetrievePlayerHead: false

#Each time the command is used, the admins will be notified that this has been ran but only
#if this setting is made true
adminOnlyNotifications: false

- [CORE] Console Support for Reloading, Help and Version Commands - [CI] All the Core Version of Plugins for 1.20.1 - [CORE] Invulnerable ArmorStands NOTE: To use this, you will need the permission asedit.toggleVulnerability - [CORE] Permission System Refactor All permissions are now disabled by default and there are ALOT MORE of them.

  asedit.basic:
    description: Allow use armorstand edit functions. If set to false it will override all other functions.
    default: true
  asedit.rename:
    description: Rename armorstands - Now Supports Color
    default: false
  asedit.equipment:
    description: Access armorstand equipment GUI
    default: false
  asedit.disableSlots:
    description: Allows locking and unlocking the contents of an ArmorStand. When locked, armor and equipment can not be added or removed without unlocking it first.
    default: false
  asedit.give:
    description: Gives player the EditTool with Proper CustomModelData
    default: false
  asedit.update:
    description: Allows the checking for updates.
    default: false
  asedit.reload:
    description: Allows Reloading of the ASE Config.
    default: false
  asedit.head:
    description: Allows players to trigger a command to retrieve a player head
    default: false
  asedit.movement:
    description: Changes whether the armor stand can be moved using the item for editing
    default: false
  asedit.rotation:
    description: Allows player to rotate the ArmorStand
    default: false
  asedit.copy:
    description: Allows the players to create copies of their ArmorStand Configurations.
    default: false
  asedit.paste:
    description: Allows the players to apply of a copy of their ArmorStand Configuration.
    default: false
  asedit.reset:
    description: Allows the reset of the ArmorStand back to Default values
    default: false
  asedit.togglearmorstandvisibility:
    description: Toggles ArmorStand visibility.
    default: false
  asedit.toggleitemframevisiblity:
    description: Allows setting of ItemFrame Visibility
    default: false
  asedit.toggleInvulnerability:
    description: Allows players to toggle the vulnerability state of an ArmorStand.
    default: false
  asedit.togglebaseplate:
    description: Allows the toggling of the Baseplate of an ArmorStand.
    default: false
  asedit.togglearms:
    description: Allows the toggling of the Arms of an ArmorStand.
    default: false
  asedit.togglesize:
    description: Allows the toggling of the size of an ArmorStand.
    default: false
  asedit.togglegravity:
    description: Changes whether the armor stand has gravity
    default: false

  asedit.ignoreProtection.towny:
    description: Allows user to ignore Towny's Protection Limitations.
    default: false
  asedit.ignoreProtection.griefProtection:
    description: Allows user to ignore GriefProtection's Protection Limitations.
    default: false
  asedit.ignoreProtection.plotSquared:
    description: Allows user to ignore PlotSquared's Protection Limitations.
    default: false
  asedit.ignoreProtection.worldGuard:
    description: Allows user to ignore WorldGuard's Protection Limitations.
    default: false
  asedit.ignoreProtection.skyblock:
    description: Allows user to ignore Skyblock's Protection Limitations.
    default: false
  asedit.ignoreProtection.griefDefender:
    description: Allows user to ignore GriefDefender's Protection Limitations.
    default: false
  asedit.ignoreProtection.lands:
    description: Allows user to ignore Lands Protection Limitations.
    default: false
  asedit.ignoreProtection.bentobox:
    description: Allows user to ignore Bentobox Protection Limitations.
    default: false
  asedit.ignoreProtection.residence:
    description: Allows user to ignore Residence Protection Limitations.
    default: false

- [API] Introduction of Developer API and Custom Events At the request of Piinnkk there is now a Custom Developer API for ArmorStandEditor -> You can see the example usage of it on: https://github.com/Wolfieheart/ArmorStandEditor/tree/dev/… - [CORE] Removal of Residence Support Full Changelog: https://github.com/Wolfieheart/ArmorStandEditor/compare/1…

What's Changed

* [CORE] Add in Custom Item Name Support - Closes #118 by @Wolfieheart in https://github.com/Wolfieheart/ArmorStandEditor/pull/122 * [CORE] ArmorStandEditor 1.19.2-38: Finalize Release by @Wolfieheart in https://github.com/Wolfieheart/ArmorStandEditor/pull/124 * [CORE] Add Lands protection by @PlanetTeamSpeakk in https://github.com/Wolfieheart/ArmorStandEditor/pull/116 * Update LandsAPI to v6.14.4 by @renovate in https://github.com/Wolfieheart/ArmorStandEditor/pull/117 Full Changelog: https://github.com/Wolfieheart/ArmorStandEditor/compare/1…

What's Changed

* [CORE] ArmorStandEditor 1.19.x-36 by @Wolfieheart in https://github.com/Wolfieheart/ArmorStandEditor/pull/84 * [CORE] Fix Update Notifications for OPs while in Dev and Disable Op on Join Notifications unless enabled in config * [CORE] Remove all the debug output until a better fix comes along for it * https://github.com/Wolfieheart/ArmorStandEditor/pull/97 * https://github.com/Wolfieheart/ArmorStandEditor/pull/100 * [CORE] Change Moving ArmorStands to asedit.placement permission * [CORE] Update to 1.19.1 Full Changelog: https://github.com/Wolfieheart/ArmorStandEditor/compare/1…

[CORE] Changes

Changes to the core of the plugin - Ex: New Features, Bug Fixes, Performance Improvements etc. - [x] [CORE] Re-implementation of PlotSquared, WorldGuard, GriefPrevention and Towny Protections - BREAKING CHANGE - [x] [CORE] Updated Translations - [x] [CORE] Metrics Fixes for Bstats - [x] [CORE] Bug Fixes - [x] [CORE] Permission Improvements for OP Users - BREAKING CHANGE - [x] [CORE] Performance Improvements - [x] [CORE] Introduction of CustomModelData Support - BREAKING CHANGE - [x] [CORE] Update Readme.md for Discord Support - [x] [CORE] More Debug Output - [x] [CORE] 1.19 Update - [x] [CORE] Code Review Remarks from SonarCloud and CodeFactor

[CI] Changes

Changes relating to the Continuous Integration of other Plugin APIs etc. - [x] [CI] Massive Dependency Updates - [x] [CI] Java 18 Builds (futureproofing) - [x] [CORE/CI] Move to PaperMC API - Investigated and not feasible at the moment.

BREAKING CHANGE INFO:

#### Protections:

ASE now has implemented better protection options for the following plugins

- PlotSquared

- GriefDefender and GriefPrevention

- WorldGuard

- SuperiorSkyblock

>

This may or may not break existing functionality but was tested and checked by Wolfieheart before release

#### Permissions:

Overhaul of permissions and introduction of permpacks.

Recommendation of the permissions below:

- asedit.* for all Mods and Admins

- asedit.permpack.basic and asedit.permpack.dontIgnoreProtections for everyone else

#### CustomModelData Support

ASE now supports CustomModelData. If you wish to avail of this, please enable it in the config and give people the permission asedit.give in order to use this

Issues and Questions?

Please report all issues to https://github.com/Wolfieheart/ArmorStandEditor/issues

What's Changed

Full Changelog: https://github.com/Wolfieheart/ArmorStandEditor/compare/1…

What's Changed

* Version: ArmorStandEditor 1.18.2-34 by @Wolfieheart in https://github.com/Wolfieheart/ArmorStandEditor/pull/38

Changes

- Better Fix for the reintroduction of the bug regarding Player Interaction Events being fired Twice (https://github.com/Wolfieheart/ArmorStandEditor-Issues/is… - Alot of fixes in the CI Stage (#28, #29, #34, #36, #39 etc. etc. etc.) - Update Simplified Chinese Translation (https://github.com/Wolfieheart/ArmorStandEditor/pull/33) - Broken Invisiblity Config Option and Debug supposidely being enabled out of box by default. - Crash on Bstats Relocation

Tested on:

What's Changed

* Version: ArmorStandEditor 1.18.1-33 by @Wolfieheart in https://github.com/Wolfieheart/ArmorStandEditor/pull/22

Changes

- Debug Flag fix - Better Debug Output: Now logs to file and Console rather than broadcasting to everyone - Fix for ItemFrameVisibility not being supported in GUI - Fix for armorStandVisibility not being supported in the GUI

Notes from Wolfie:

Sorry for the huge delay with getting this out. The move, Christmas Holidays and a few other things got in the way of this. Next update should hopefully be quicker depending on availability.

Tested on:

Windows 11 Pro Purpur version git-Purpur-1465 Full Changelog: https://github.com/Wolfieheart/ArmorStandEditor/compare/1…

What is new in this update: _Version 1.18-31:_ - 1.18 Caves and Cliffs Part 2 Support - Towny Support - Moved V1_17 to supported but not latest. - Version Command: /ase version - Uses asedit.basic as the permission for it - Code Review remarks from SonarCloud

Version 1.17.1-30: Addition of Disabling Slots with Glowing Effects (Wolfieheart/ArmorStandEditor-Issues#5) Updated ReadMe to include Download Links to Older Versions Addition of bStats Metrics Support Fixes for Incorrectly Translated Strings (Wolfieheart/ArmorStandEditor-Issues#6) Fix for ItemFrame firing 2 events Additions to implement more features for itemFrames in the future. To Be determined.

Original Version as last developed by RypoFalem