🛠️ ArmorStandEditor

ArmorStandEditor (ASE) 是一款允许玩家在生存模式下轻松编辑盔甲架姿势和属性的 Minecraft 插件。它旨在提供一种无需命令方块或复杂命令即可编辑盔甲架的简便方法。ASE 支持多种 Minecraft 版本，并不断更新以适应新的游戏功能。

✨ 功能特性

• 无需命令即可轻松编辑盔甲架。
• 快速上手，操作简单。
• 沿各个轴旋转盔甲架的各个部位。
• 放置后旋转整个盔甲架。
• 打开盔甲架的物品栏，放置通常无法放置的物品（例如双持、头顶放置旗帜、头戴南瓜等）。
• 按下 Shift 键并滚动鼠标滚轮即可快速切换轴。
• 微调模式可以精细调整身体部位的位置，而粗调模式可以快速将身体部位移动到大致位置。
• 可以切换显示手臂、隐身、底座、正常/小尺寸和重力等属性。
• 移动盔甲架到所需位置。
• 复制一个盔甲架的设置并粘贴到另一个盔甲架。
• 生存模式友好型粘贴：除非玩家处于创造模式，否则不会复制/粘贴/复制物品。
• 将复制的设置存储在 9 个复制槽中。
• 像原版生物一样，使用命名牌命名盔甲架，并支持彩色名称！
• 支持发光物品展示框（1.17+）。
• 兼容大多数保护插件，包括 WorldGuard、Towny、GriefPrevention、PlotSquared v6/7 等。
• Towny 支持 (1.18)。
• Folia 支持 (1.19.4)。
• 支持单世界 (1.20.2)，发光盔甲架支持，盔甲架属性。
• 预设姿势 (1.20.4)。

🎮 使用方法

• 将编辑工具（默认为燧石）握在主手中。
• 左键/右键点击盔甲架以外的区域以打开菜单。
• 选择菜单选项。
• 手持工具左键/右键点击盔甲架以应用这些选项。

💡 提示

• Shift + 滚轮向上/向下滚动可快速更改轴。
• 请记住，旋转身体部位时，左键单击向一个方向旋转，右键单击盔甲架则向相反方向旋转。
• 粗调模式可以快速旋转身体部位，而微调模式可以在身体部位接近所需位置后进行精细调整。
• 复制盔甲架设置后，工具会自动切换到粘贴模式。
• 如果其他盔甲架挡住了视线，请按切换物品键（默认为 F）以定位特定盔甲架。

🐛 问题反馈与功能建议

您可以在 Wolfieheart/ArmorStandEditor/Issues 上报告任何问题并提交新的功能请求。请注意：您需要一个 GitHub 帐户才能执行此操作。

🌍 翻译贡献

欢迎提交翻译！请以功能请求的形式提交。

📜 插件历史

您可以在 https://github.com/Wolfieheart/ArmorStandEditor/releases 上找到插件的完整历史记录。

⚙️ 权限

permissions:
  asedit.*:
    description: All ArmorStandEditor Commands
    default: op
    children:
      asedit.permpack.admin: true
      asedit.ignoreProtection.*: true
      asedit.head: true

  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: true
  asedit.equipment:
    description: Access armorstand equipment GUI
    default: true
  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: true
  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: true
  asedit.rotation:
    description: Allows player to rotate the ArmorStand
    default: true
  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: true
  asedit.togglearmorstandvisibility:
    description: Toggles ArmorStand visibility.
    default: true
  asedit.toggleitemframevisibility:
    description: Allows setting of ItemFrame Visibility
    default: true
  asedit.toggleInvulnerability:
    description: Allows players to toggle the vulnerability state of an ArmorStand.
    default: true
  asedit.togglebaseplate:
    description: Allows the toggling of the Baseplate of an ArmorStand.
    default: true
  asedit.togglearms:
    description: Allows the toggling of the Arms of an ArmorStand.
    default: true
  asedit.togglesize:
    description: Allows the toggling of the size of an ArmorStand.
    default: true
  asedit.togglegravity:
    description: Changes whether the armor stand has gravity
    default: true
  asedit.togglearmorstandglow:
    description: Allows toggling of the Glowing State of an ArmorStand.
    default: true
  asedit.stats:
    description: Ability to view ArmorStand Stats.
    default: true

  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.*:
    description: Ignore all Protection Limitations
    default: op
    children:
      asedit.ignoreProtection.towny: true
      asedit.ignoreProtection.griefProtection: true
      asedit.ignoreProtection.plotSquared: true
      asedit.ignoreProtection.worldGuard:  true
      asedit.ignoreProtection.skyblock: true
      asedit.ignoreProtection.griefDefender: true
      asedit.ignoreProtection.lands: true
      asedit.ignoreProtection.bentobox: true

  asedit.permpack.dontIgnoreProtections:
    children:
      asedit.ignoreProtection.towny: false
      asedit.ignoreProtection.griefProtection: false
      asedit.ignoreProtection.plotSquared: false
      asedit.ignoreProtection.worldGuard:  false
      asedit.ignoreProtection.skyblock: false
      asedit.ignoreProtection.griefDefender: false
      asedit.ignoreProtection.lands: false
      asedit.ignoreProtection.bentobox: false

  asedit.permpack.basic:
    default: true
    children:
      asedit.basic: true
      asedit.equipment: true
      asedit.gravity: true
      asedit.movement: true
      asedit.disableSlots: true
      asedit.rename: true
      asedit.update: false
      asedit.give: false
      asedit.reload: false
      asedit.head: false
      asedit.rotation: true
      asedit.copy: true
      asedit.paste: true
      asedit.reset: true
      asedit.toggleInvulnerability: true
      asedit.togglebaseplate: true
      asedit.togglearms: true
      asedit.togglesize: true
      asedit.togglearmorstandvisibility: true
      asedit.toggleitemframevisibility: true
      asedit.togglearmorstandglow: true
      asedit.permpack.dontIgnoreProtections: true

  asedit.permpack.admin:
    default: op
    children:
      asedit.ignorePermissions.*: true
      asedit.basic: true
      asedit.equipment: true
      asedit.movement: true
      asedit.disableSlots: true
      asedit.rename: true
      asedit.update: true
      asedit.reload: true
      asedit.head: true
      asedit.give: true
      asedit.rotation: true
      asedit.copy: true
      asedit.paste: true
      asedit.reset: true
      asedit.togglebaseplate: true
      asedit.togglearms: true
      asedit.togglesize: true
      asedit.toggleInvulnerability: true
      asedit.togglegravity: true
      asedit.togglearmorstandvisibility: true
      asedit.toggleitemframevisibility: true

⚙️ 配置

#-----------------------------#
#   ArmorStandEditor-Reborn   #
#-----------------------------#

#DO NOT CHANGE THIS - CHANGES AUTOMATICALLY PER UPDATE
version: "1.20.2-44.1"

#----------- LANGUAGE
#Name of the language file you wish to use

#NOTE: If you are editing en_US.yml, it will not persist across restarts due to it being overwritten
#Please read the comments at the top of that file before editing/changing/modifying.
lang: en_US.yml

#----------- UPDATE NOTIFICATIONS
# Enable or Disable the Update Checker
runTheUpdateChecker: true

# When runTheUpdateChecker is true, we will also check every X hours
check-interval: 24

# Set this to allow your operators to get messages in game w.r.t Plugin updates
opUpdateNotification: false

#----------- WORLD SETTINGS
# Enable Per World Support for ArmorStandEditor - Not Enabling this
# means it will work for all worlds by default
enablePerWorldSupport: false

# Add in a list of Worlds where ArmorStandEditing is allowed to happen
# Please add your own worlds to this list. All Default Worlds are supported.
allowed-worlds:
  - world
  - world_nether
  - world_the_end

#----------- TOOL SETTINGS

#Name of the edit tool's item Material.
#You can find a full list at https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
tool: FLINT

#(Optional) data that the plugin looks for to identify the edit tool, such as the damage value of a sword or the pattern of sandstone.
requireToolData: false
toolData: 0

#(Optional) data that the plugin looks for to identify the name of the Edit Tool. Useful for Public Servers that do not want
#normal use of Flint to be impacted.
requireToolName: false
toolName: Example Name here

#(Optional) The first "Lore" entry that the plugin looks for to identify the edit tool. - Now has MultiLine Support
#NOTE: If you wish to make use of single line tool lore, please remove the 2nd item in the list and replace the first
#     text with what you want your ToolLore to be
requireToolLore: false
toolLore:
  - "TIME TO GET REALLY" #Replace if you want SingleLine ToolLore
  - "REALLY DANGEROUS!"  #Remove if you don't want MultiLine ToolLore

#(Optional) Allow the use of CustomModelData - NOTE: This looks at the editTool set by Config
#and at the Int set here to know what to set.

#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

#----------- ARMOR STAND SPECIFICS

#How many rotations to make a full circle in Coarse adjustment mode
coarse: 12

#How many rotations to make a full circle in Fine adjustment mode
fine: 120

#Allow the option to toggle invisibility for ItemFrames and ArmorStand
#You can either use this or the below permissions to allow visibility changes
#asedit.togglearmorstandvisibility
armorStandVisibility: false
#asedit.toggleitemframevisibility
invisibleItemFrames: false

#------ GUI Options

#If true, the GUI will only open if the player is sneaking
requireSneaking: false

#Sends messages to the ActionBar
sendMessagesToActionBar: true

#------ Misc Options

#(Optional) Glowing Item Frames Support for Item Frames in 1.17 - WILL NOT WORK IN 1.16 OR LOWER AND 1.17.1 OR HIGHER
#If true, players can make itemFrames glow by right-clicking with a Glow Ink Sac
glowingItemFrame: true

#(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