# EasyArmorStands
Armor stand 和展示实体的编辑器。
# 安装
**支持的 Minecraft 版本：** Spigot/Paper 1.8.8 到 1.21.7
下载最新的 `.jar` 文件，并将其放入你的 `plugins` 文件夹。
# 使用
使用 `/eas give` 并按照说明操作。
如果你遇到了问题，请参考下面的详细说明。
## 演示视频
[](https://youtu.be/dQZkB3mez-0)
## 控制
* 右键单击：选择
* 左键单击：返回
* 左键单击：打开菜单
* Q：取消选择实体
* Shift：禁用对齐
* F：在本地/全局/缩放模式之间切换
## 编辑实体
按住工具并右键单击一个实体以选择它。
右键单击一条线以使用 **移动** 工具。
通过行走或环顾四周来移动你的光标，然后右键单击以确认你的更改。
你可以通过左键单击来放弃你的更改并恢复先前的位置。
右键单击一个圆圈以使用 **旋转** 工具。
这就像 移动工具 一样。
某些实体可以通过按 F 键在本地和全局模式之间切换。
本地模式受旋转影响，例如，你可以使用它来沿着盔甲架的胳膊移动它。
全局模式使用全局坐标。
使用 `/eas undo` 和 `/eas redo` 来撤销/重做你的更改。
你可以撤销使用 EasyArmorStands 执行的任何操作，以及手动放置或销毁盔甲架。
## 盔甲架
盔甲架有 7 个部分：
* 头
* 身体
* 左臂
* 右臂
* 左腿
* 右腿
* 位置
在选择盔甲架后，你还需要选择要编辑哪个部分。
位置部分是中间（头下）的黄色点，其他部分是白色的线。
你可以通过选择位置部分然后选择 **拿起** 工具（在中心（线交汇处））来拿起和携带盔甲架。
使用 `/eas name` 编辑盔甲架的自定义名称。
这通常用于全息显示。
使用 [MiniMessage](https://docs.advntr.dev/minimessage/format.html) 格式化名称。
**提示：** 如果你使用的是 1.19.4+ 版本，你应该使用文本显示来进行全息显示，请参见下文。
## 展示实体
展示实体可以像盔甲架部分一样进行编辑。
此外，它们可以进行缩放。
通过右键单击而不看任何东西来进入 **缩放** 模式，
就像在本地和全局模式之间切换一样。
使用菜单将物品放入物品展示中。
使用 `/eas text` 编辑文本展示的文本。
使用 [MiniMessage](https://docs.advntr.dev/minimessage/format.html) 格式化文本。
这个命令也有一些子命令，例如 `/eas text background`，可用于更改背景颜色。
**提示：** 在菜单中将广告模式设置为 `center` 并重置旋转
(`/eas reset`) 以创建一个始终面向玩家的全息显示。
按住 Shift 并左键单击方块以在方块展示中放置一个方块，或使用 `/eas block`。
此命令还支持方块状态，例如 `minecraft:birch_stairs[facing=east]`。
使用 `/eas box` 来调整或移动边界框。
设置边界框对客户端渲染性能很重要。
如果边界框不可见，客户端将不会渲染展示实体。
默认情况下，展示实体没有边界框，因此它们始终被渲染。
使用 `/eas brightness` 设置一个自定义亮度（光照级别）的展示实体。
## FancyHolograms 集成
可以使用 EasyArmorStands 移动和缩放 FancyHolograms 全息显示。
## 群组选择
按住 Shift 并右键单击一个实体以将其添加到你的群组选择中。
选择完要编辑的实体后，右键单击任何位置而无需按住 Shift 以开始编辑群组。
## 菜单
可以通过在没有选择任何部分或工具的情况下左键单击来访问菜单。
群组选择不支持菜单。
在左下方，你可以编辑实体装备槽（盔甲、拿取的物品）。
右下方包含快速选择特定部分的快捷按钮。
可以使用右上角的按钮更改盔甲架设置，例如可见性。
### Head Database 集成
如果安装了 [Head Database](https://www.spigotmc.org/resources/head-database.14280/) 并且你有使用它的权限，
你可以点击左上角的按钮打开其菜单。
选择一个头部后，你将返回 EasyArmorStands 菜单，并可以快速将其放置到装备槽中。
权限：`headdb.open`
### TrainCarts 集成
如果安装了 [TrainCarts](https://www.spigotmc.org/resources/traincarts.39592/)，则会在左上角添加一个按钮以打开 TrainCarts
模型浏览器。
权限：`easyarmorstands.traincarts.model`
## 命令
此列表包含一些无法通过菜单访问的重要命令。
使用 `/eas help` 查看命令和用法的完整列表。
* `/eas give`：给你编辑器工具
* `/eas align`：将所选实体移动到其方块的中心
* `/eas clone`：复制所选实体
* `/eas snap angle`：切换角度对齐（或指定增量）
* `/eas snap move`：切换位置对齐（或指定增量）
* `/eas reset
`：重置属性
# 权限
有两种权限包包含推荐的生存或创造模式服务器的权限。
| 权限 | 描述 |
|-----------------------|----------------------------------------------------|
| `easyarmorstands.survival` | 允许编辑盔甲架及其基本属性 |
| `easyarmorstands.creative` | 允许生成和编辑盔甲架和展示实体 |
例如，要允许玩家在创造性服务器上使用 EasyArmorStands，只需给他们
`easyarmorstands.creative` 权限。
权限的完整列表位于 [wiki](https://github.com/56738/EasyArmorStands/wiki/Permissions)。
## PlotSquared 集成
如果安装了 [PlotSquared v6/v7](https://www.spigotmc.org/resources/plotsquared-v6.77506/)，玩家只能编辑
其被允许建造的图块上的实体。
具有 `easyarmorstands.plotsquared.bypass` 权限的玩家可以绕过此限制。
## WorldGuard 集成
如果安装了 [WorldGuard](https://enginehub.org/worldguard)，玩家只能编辑
其被允许建造的实体。
具有 `easyarmorstands.worldguard.bypass` 权限的玩家可以绕过此限制。
## GriefDefender 集成
如果安装了 GriefDefender，只有可信的建造者才能编辑声明中的实体。
具有 `easyarmorstands.griefdefender.bypass` 权限的玩家可以绕过此限制。
## GriefPrevention 集成
如果安装了 GriefPrevention，玩家只能编辑
其被允许建造的实体。
具有 `easyarmorstands.griefprevention.bypass` 权限的玩家可以绕过此限制。
## HuskClaims 集成
如果安装了 HuskClaims，玩家只能编辑
其被允许执行 `easyarmorstands:edit` 操作的实体。
`easyarmorstands:edit` 操作（标志）应在
[HuskClaims 配置](https://william278.net/docs/huskclaims/config) 中配置。
* 将其添加到 `wilderness_rules` 中 `config.yml` 以允许在荒野中使用 EasyArmorStands。
* 将其添加到 `allowed_owner_operations` 中 `trust_levels.yml` 以允许玩家在自己的图块中使用 EasyArmorStands。
* 将其添加到特定 `trust_levels` 的 `flags` 中 `trust_levels.yml` 以配置哪些信任级别可以使用
EasyArmorStands 在声明中。
具有 `easyarmorstands.huskclaims.bypass` 权限的玩家可以绕过此限制。
## Towny 集成
如果安装了 Towny，只有可信的居民才能编辑声明中的实体。
具有 `easyarmorstands.towny.bypass` 权限的玩家可以绕过此限制。
## Residence 集成
如果安装了 Residence，则 `build` 标志要求玩家才能编辑声明中的实体。
具有 `easyarmorstands.residence.bypass` 权限的玩家可以绕过此限制。
## Lands 集成
如果安装了 Lands，可以在菜单中（*编辑实体*）使用 `easyarmorstands_edit` 角色标志来限制编辑实体。
具有 `easyarmorstands.lands.bypass` 权限的玩家可以绕过此限制。
## BentoBox 集成
如果安装了 BentoBox，则需要 `ARMOR_STAND` 标志才能编辑实体。
具有 `easyarmorstands.bentobox.bypass` 权限的玩家可以绕过此限制。
# 配置
配置文件夹，包括所有菜单布局，都在插件文件夹中自动生成。
最重要的选项记录在 [wiki](https://github.com/56738/EasyArmorStands/wiki/Configuration)。
使用 `/eas reload` 重新加载所有配置文件。
## 本地化
* 复制
[默认消息](https://raw.githubusercontent.com/56738/EasyArmorStands/main/easyarmorstands-plugin/src/main/resources/me/m56738/easyarmorstands/messages.properties)
到 `plugins/EasyArmorStands/messages_XX.properties`。
* 将 `XX` 替换为语言，例如： `messages_de.properties`。
这使得文件仅适用于具有该语言的玩家。
* 为了替换默认消息（如果不存在匹配的 `messages_XX.properties` 文件），
只需将文件命名为 `messages.properties`。
使用 `/eas reload` 重新加载所有消息。
