Mounts - 简易坐骑插件

💡简介

Mounts 是一款高度可配置的坐骑插件，允许你为玩家创建和分发各种自定义坐骑。它非常适合作为任务奖励或活动奖品，并支持与多种 RPG 技能插件集成，为你的服务器增添独特的 RPG 元素。

🎮核心特性

支持的坐骑类型

• HORSE
• ZOMBIE_HORSE
• SKELETON_HORSE
• MULE
• DONKEY

可配置的坐骑属性

• 名称
• 移动速度
• 跳跃强度
• 颜色（仅马匹）
• 样式（仅马匹）
• 盔甲（仅马匹）
• 描述文本
• 分类

主要功能

• 通过命令给予玩家坐骑。
• 供玩家查看和管理坐骑的 GUI 界面。
• 支持购买和出售坐骑的商店 GUI（需 Vault 支持）。
• 基于权限的坐骑获取。
• 可配置的坐骑使用要求。
• 支持快捷命令 /m 骑乘最喜爱的坐骑。
• 支持使用 Vault（经济）或物品堆（钻石、绿宝石等）作为交易货币。
• 可选的世界守卫（WorldGuard）标志，用于控制玩家可使用坐骑的区域。

✨支持的 RPG 插件与要求

Mounts 支持通过以下插件设置坐骑的使用门槛：

mcMMO

• 技能等级
• 能量等级

QuantumRPG (仅限 4.x 版本)

• 职业
• 等级

SkillAPI

• 职业
• 等级
• 技能等级

mmoCore

• 属性（如敏捷）
• 职业
• 等级
• 专业

Minecraft 原生

• 等级
• 进度

🔧权限节点

默认情况下，以下权限会授予所有玩家

• mounts.mount.<mount-name>：允许玩家购买、出售和骑乘指定名称的坐骑。
• mounts.command.mounts：允许玩家使用 /mounts 命令打开坐骑 GUI。
• mounts.command.mount：允许玩家使用 /mount 命令骑乘坐骑。
• mounts.command.mountset：允许玩家使用 /mountset 命令设置当前坐骑为最爱。
• mounts.command.mountdel：允许玩家使用 /mountdel 命令移除最爱的坐骑。

默认情况下，以下权限仅授予 OP 玩家

• mounts.command.give：允许使用 /mountgive 命令给予玩家坐骑。
• mounts.command.buy：允许使用 /mountbuy 命令为玩家打开购买商店 GUI。
• mounts.command.sell：允许使用 /mountsell 命令为玩家打开出售商店 GUI。
• mounts.command.reload：允许使用 /mountsreload 命令重载插件配置。

🔧命令列表

玩家常用命令

• /mounts 或 /m：打开坐骑管理 GUI。
• /mount [坐骑ID] 或 /m [坐骑ID]：骑乘坐骑。不提供 ID 时，骑乘最爱的坐骑。
• /mountset 或 /mset：将当前骑乘的坐骑设置为最爱。
• /mountdel 或 /mdel：取消设置最爱的坐骑。

管理员命令

• /mountsreload 或 /mreload：重载插件配置。
• /mountgive <玩家> <坐骑名称> 或 /mgive <玩家> <坐骑名称>：给予指定玩家一个坐骑。
• /mountbuy <玩家> [坐骑类型]... 或 /mbuy <玩家> [坐骑类型]...：为指定玩家打开购买坐骑的 GUI。此命令通常由服务器（命令方块、CitizensCMD）执行。
• /mountbuycategory <玩家> <分类>... 或 /mbuycat <玩家> <分类>...：为指定玩家打开按分类筛选的购买 GUI。此命令通常由服务器执行。
• /mountsell <玩家> 或 /msell <玩家>：为指定玩家打开出售坐骑的 GUI（需要 Vault）。此命令通常由服务器执行。
• /mountdemo 或 /mdemo：加载坐骑演示数据。

⭐配置说明

全局配置 (`config.yml`)

主要配置选项包括

• debug：控制台调试信息开关。
• dataStore.type：数据存储方式（目前仅 config）。
• messages：自定义所有提示信息。
• sounds：配置各种操作音效。
• mountCooldownSeconds：切换坐骑的冷却时间（秒）。
• unmountOnDamage：受到伤害时是否自动下马。
• lore：定义坐骑在 GUI 中显示的描述文本格式。

坐骑配置文件

每个坐骑都是一个独立的 YAML 文件，位于 plugins/Mounts/mounts/ 目录下。

示例配置：swift_brown_steed.yml

name: Swift Brown Steed
icon: DIAMOND_HORSE_ARMOR # GUI 中显示的图标
speed: 0.2 # 移动速度 (0-2)
jump: 0.3 # 跳跃强度 (0-2)
type: HORSE # 坐骑类型
color: BROWN # 颜色（仅马匹）
style: WHITE_DOTS # 样式（仅马匹）
armor: DIAMOND_HORSE_ARMOR # 盔甲（仅马匹，可选）
categories: # 分类，用于 /mbuycat 命令筛选
  - vip_rank1
  - vip_rank2
requirements: # 使用要求（均为可选）
  level: 10 # Minecraft 等级
  advancements: # 需完成的进度
    - recipes/transportation/carrot_on_a_stick
    - nether/all_effects
  mcmmo:
    powerLevel: 75
    skills:
      TAMING: 5
  quantumrpg:
    classes:
      - archer
      - warrior
    level: 10
  skillapi:
    skills:
      Archery: 5
    classes:
      - Archer
      - Runeblade
    level: 10
  mmocore:
    professions:
      enchanting: 10
    classes:
      - marksman
      - warrior
    attributes:
      dexterity: 5
    level: 50
# 购买/出售价格（只能选择一种货币类型）
priceBuy: 50.00 # Vault 经济价格
priceSell: 25.00
# 或使用物品价格
# priceBuy:
#   DIAMOND: 2
#   EMERALD: 1
# priceSell:
#   DIAMOND: 1

❓使用示例

给予玩家坐骑

• 创建坐骑配置文件后，重载配置：

    /mounts reload

• 给予玩家坐骑（坐骑 ID 即文件名不含 .yml）：

    /mgive PlayerName swift_brown_steed

设置 NPC 商店

你可以使用 Citizens2 和 CitizensCMD 插件（或命令方块）来创建提供购买/出售菜单的 NPC。请注意，本插件不直接与任何 NPC 插件集成，你需要自行配置 NPC 来执行相应的 Mounts 命令。

购买命令示例：

• 允许玩家购买一个特定坐骑：

    /mbuy PlayerName swift_brown_steed

• 允许玩家购买多个坐骑：

    /mbuy PlayerName swift_brown_steed forest_horse

• 允许玩家购买所有坐骑：

    /mbuy PlayerName

• 按分类购买：

    /mbuycat PlayerName vip_rank1

出售命令示例：

/msell PlayerName

玩家操作示例

• 骑乘特定坐骑：

    /mount the_prestige

• 将当前坐骑设为最爱：

    /mset

• 骑乘最爱的坐骑：

    /m

💡注意事项

• 确保坐骑配置文件正确放置在 plugins/Mounts/mounts/ 文件夹中。
• 修改配置后，记得使用 /mountsreload 重载。
• 使用经济功能需要安装 Vault 及对应的经济插件。
• 使用 RPG 插件集成功能时，请确保对应插件已正确安装并运行。