AdvancedArmor - 高级护甲插件

AdvancedArmor 是一款强大的 Minecraft 服务器插件，允许玩家通过穿戴自定义盔甲来提升货币、经验等多种资源的获取效率。它提供了高度可配置的盔甲套装、丰富的增益类型，并与众多主流经济插件兼容。

💡核心特性

• 完全可配置的盔甲套装：从物品名称、描述到属性增益，均可自定义。
• 丰富的物品属性：
• 可配置物品标签（在 1.12+ 版本中可设置为“无法破坏”）。
• 可配置物品名称与描述（Lore）。
• 支持自定义 RGB 与 HEX 颜色代码。
• 支持原版附魔。
• 可自定义材质与头颅纹理。
• 灵活的增益系统：
• 每件盔甲均可独立配置增益效果。
• 内置金钱、经验、宝石、代币、精华和硬币等多种增益类型。
• 提供 API 以支持创建自定义增益类型。
• 强大的兼容性与扩展性：
• 支持 PlaceholderAPI。
• 兼容超过 9 种经济/售卖插件（详见下方依赖列表）。
• 消息、语言文件完全可翻译。
• 包含 5 套预设盔甲套装。

🎮增益类型说明

金钱 (Money)

金钱增益依赖于经济插件。当玩家通过 /sell 命令或其他方式获得金钱时，增益会按倍数提升收入。

支持的插件：Essentials、ShopGUI+、InfiniteChestPro、Clip AutoSell、Scyther、RevEnchants、WildTools、UltraPrisonCore。

经验 (EXP)

当玩家获得经验时，穿戴经验增益盔甲会按倍数提升经验获取量。

硬币 (Coins)

当玩家获得硬币时，穿戴硬币增益盔甲会按倍数提升硬币获取量。

需要的插件：SuperMobCoins、KrakenMobCoins、TheOnly-MobCoins、QuadrexCoins 或推荐的 AquaCoins。

代币 (Tokens)

当玩家从幸运方块、玩家捐赠或挖掘代币中获得代币时，穿戴代币增益盔甲会按倍数提升代币获取量。

需要的插件：UltraPrisonCore、RevEnchants、Tokens by GC 或 DeluxeSellwands。

宝石 (Gems)

当玩家获得宝石时，穿戴宝石增益盔甲会按倍数提升宝石获取量。

需要的插件：UltraPrisonCore。

精华 (Essence)

当玩家获得精华时，穿戴精华增益盔甲会按倍数提升精华获取量。

需要的插件：RivalHarvesterHoes、RivalMobSwords 或 RivalFishingRods。

🔧命令与权限

命令

• /armor - 主命令。
• /armor reload - 重载插件配置。
• /armor types - 列出所有已挂钩的盔甲增益类型。
• /armor give <玩家名> <盔甲类型> <部位> - 给予指定玩家一件特定盔甲。
• 部位可选：helmet、chestplate、leggings、boots。

权限

• /armor - advancedarmor.command
• /armor reload - advancedarmor.command.reload
• /armor types - advancedarmor.command.types
• /armor give - advancedarmor.command.give

✨占位符 (Placeholders)

插件自动安装以下占位符，无需额外命令激活。

• 盔甲套装名称：
• %advancedarmor_helmet_type%
• %advancedarmor_chestplate_type%
• %advancedarmor_leggings_type%
• %advancedarmor_boots_type%

• 单件盔甲增益百分比：
• %advancedarmor_helmet_boost%
• %advancedarmor_chestplate_boost%
• %advancedarmor_leggings_boost%
• %advancedarmor_boots_boost%

• 特定类型总增益：
• %advancedarmor_boost_{BOOST-TYPE}%
• 示例：%advancedarmor_boost_MONEY%

❓使用教程：颜色与渐变

如何添加渐变颜色

在物品名称或描述（Lore）中使用以下格式

<GRADIENT:hexcode>你的文字</GRADIENT:hexcode>

如何添加彩虹色

使用以下格式，其中的数字代表饱和度（1-100），数字越大颜色越鲜艳（浅）：

<RAINBOW1>你的文字</RAINBOW>

如何添加单一 HEX 颜色

使用以下格式，注意无需闭合标签

<SOLID:hexcode>你的文字

HEX 颜色代码示例：#FF5733

⭐可选依赖（软依赖）

以下插件非必需，但启用对应功能时需要安装。

• 经济/售卖插件：Essentials, ShopGUI+, InfiniteChestPro, UltraPrisonCore, Clip AutoSell, Scyther, RevEnchants, WildTools, DeluxeSellwands
• 硬币插件：SuperMobCoins, QuadrexCoins, KrakenMobCoins, TheOnly-MobCoins, TMMobCoins, AquaCoins (推荐)
• 代币插件：Tokens by GC
• 精华插件：RivalHarvesterHoes, RivalFishingRods, RivalMobSwords

🔧支持与信息

• Discord 支持服务器：https://discord.gg/GquPc7h
• Wiki 文档：https://github.com/iLucaH/AdvancedArmor/wiki
• 已测试版本：1.8.8, 1.9.0, 1.12.0, 1.12.2, 1.16.0, 1.16.5, 1.17, 1.17.1, 1.18.0, 1.18.1

请注意：请勿在评论区域报告漏洞，请使用插件页面的讨论功能或加入 Discord 服务器进行反馈。开发者活跃于 Discord 并提供及时支持。

AdvancedArmor 是一款功能强大的 Minecraft 插件，允许你创建自定义的皮革盔甲套装。这些盔甲不仅能改变外观，还能为玩家提供经验、金钱、代币或游戏币的增益效果。通过简单的 YAML 配置，你可以轻松定义盔甲的属性、附魔、颜色和增益效果。

💡创建新盔甲套装类型

以下是一个创建名为 Helix 的盔甲套装的详细示例。

配置示例 (YAML)

Armor:
  Types:
    Helix: # 这是盔甲类型的名称，我们将添加一个名为 Helix 的套装
      Name: '&2&lHelix &f&l%armor_type%' # 盔甲的显示名称
      ArmorColor: 'LIME' # 盔甲颜色（所有盔甲均为皮革材质）
      Lore: # 物品描述，可以添加多行
        - '&aLine 1'
        - '&r' # &r 用于在描述中创建空行
        - 'Line 2'
        - 'Line 3'
        - 'Line 4'
        - 'Line 5'
        - 'Can add as many as you want to!'
      Enchants: # 附魔部分
        Unbreaking: 10 # 添加耐久度 10（经验修补）
      Flags: # 物品标签设置
        Unbreakable: false # 设置为 true 可使物品无法损坏（1.12+ 版本功能）
        HIDE_UNBREAKABLE: false # 设置为 true 可隐藏“无法损坏”属性
        HIDE_ATTRIBUTES: false # 设置为 true 可隐藏所有属性标签
        HIDE_ENCHANTS: false # 设置为 true 可在物品描述中隐藏附魔信息
      Boost: # 增益效果设置
        Type: 'EXP' # 类型可以是 EXP（经验）、MONEY（金钱）、COIN（游戏币）或 TOKEN（代币）
        Helmet-Percentage: 10 # 头盔增益百分比
        Chestplate-Percentage: 20 # 胸甲增益百分比
        Leggings-Percentage: 30 # 护腿增益百分比
        Boots-Percentage: 40 # 靴子增益百分比

可用的附魔名称

在 Enchants 部分，你可以使用以下名称（不区分大小写）：

• Fireaspect
• Sharpness
• Smite
• Punch
• Looting
• Fortune
• Baneofarthropods
• Power
• Flame
• Infinity
• Unbreaking
• Efficiency
• Thorns
• Projectile_protection 或 Projectile
• Protection
• Blast_Protection 或 Blast
• Fire_Protection 或 Fire
• Mending

关于颜色

你可以在物品名称和描述中使用 RGB/Hex 颜色代码。具体方法请参考相关文档。

🎮命令

插件的主命令是 `/armor`，其子命令如下

• /armor reload - 重新加载配置文件。
• /armor types - 列出所有已配置的盔甲类型。
• /armor give <玩家名> <盔甲类型> <部位> - 给予玩家指定的盔甲部件。

- 部位必须是：`HELMET`、`CHESTPLATE`、`LEGGINGS` 或 `BOOTS`。

✨权限

• /armor - advancedarmor.command
• /armor reload - advancedarmor.command.reload
• /armor types - advancedarmor.command.types
• /armor give - advancedarmor.command.give

🔧配置文件详解

配置文件主要包含以下几个部分

经济依赖设置

此部分用于启用与不同经济插件的联动。

Money-Armor:
  Economy-Dependencies:
    Essentials-Enabled: false
    ShopGUIPlus-Enabled: false
    UltraPrisonCore-Enabled: false
    ClipAutoSell-Enabled: false
    InfiniteChestPro:
      Enabled: false
      HookType: 'Essentials' # 可选项：'Essentials', 'ShopGUIPlus' 等

Coin-Armor:
  Economy-Dependencies:
    SuperMobCoins-Enabled: false
    KrakenMobCoins-Enabled: false
    TheOnlyMobCoins-Enabled: false
    QuadrexMobCoins-Enabled: false

Token-Armor:
  Economy-Dependencies:
    UltraPrisonCore-Enabled: false

盔甲定义

这是定义所有自定义盔甲的核心部分。你可以参考上面的示例创建多个套装，如 Helix、Ocean、Ravanger、Santa、Grinch、Rainbow、Fire、PiggyBank、Coin、Sunkist 等。

颜色调色板

你可以在 ArmorColor: 部分预定义 RGB 颜色，方便在盔甲配置中引用。

ArmorColor:
  RED:
    R: 255
    G: 0
    B: 0
  GREEN:
    R: 0
    G: 255
    B: 0
  # ... 其他颜色

消息自定义

你可以修改插件发送的所有提示信息。

Messages:
  Console-Name: 'Server' # 控制台发送物品时显示的名称
  No-Permission: # 无权限时的提示
    - '&cYou do not have permission to execute this command.'
  Armor-Correct-Usage: # 命令使用错误时的提示
    - '&cCorrect Usage:'
    - '&c* &7/armor give    - Give someone an armor piece.'
    - '&c* &7/armor types - List the armor types.'
    - '&c* &7/armor reload - Reloads the config.'
  # ... 其他消息（如 Command-Info, Player-Not-Online 等）

增益效果消息

当玩家因穿戴盔甲获得增益时，可以发送提示消息。

BoostMessages:
  EXP:
    Enabled: false # 是否启用经验增益提示
    Message:
      - '&a&l+ %amount% Experience &7(EXP Armor)'
  Money:
    Enabled: true # 是否启用金钱增益提示
    Message:
      - '&a&l+ $%amount% &7(Money Armor)'

调试模式

开发者工具，用于检查盔甲功能是否正常工作。

Debug:
  Enabled: false # 启用调试模式
  Cosole: false # 在控制台显示调试信息
  Player: false # 向玩家显示调试信息