PiggyBack - More than just a Stacker - PiggyBack - 骑乘插件

💡潜行、点击、骑乘！

你是否想像个硬汉一样把猪扛起来？是否想养一只史莱姆当宠物？厌倦了用小麦和拴绳？你的朋友不想跟你走？

那么，这个插件就是为你准备的！Piggyback 已存在 8 年之久，因此可能比大多数其他“骑乘”插件更稳定、更完善！它完全可配置，既可用于生存模式，也可用于大厅，并且最初就是作为一个生存模式的骑乘插件开始的。

> 插件主页（Bukkit）：http://dev.bukkit.org/bukkit-plugins/piggyback/

---

❓如何使用

• 找到你想携带的生物或玩家。
• 靠近目标（至少 5 格以内）。
• 潜行并右键/左键点击目标（点击方式可配置）。
• 要放下携带的目标，只需再次潜行并点击它即可。

关于玩家：

• 玩家可以关闭自己被骑乘的功能。
• 配置中可关闭对 NPC 的骑乘。
• 关闭此功能的玩家既不能被其他玩家骑乘，也不能骑乘其他玩家，但仍可骑乘生物。

你可以将此插件用于生存模式，或作为大厅的“叠罗汉”插件！所有消息均可自定义，甚至可以完全禁用或由玩家自行关闭，以获得沉浸式体验！

---

✨功能特性

• 无需命令即可骑乘其他玩家和生物。
• 无需命令即可放下或投掷（可配置）其他玩家和生物。
• 发送消息通知玩家目标已被骑乘、放下或投掷。
• 发送无骚扰的消息，通知玩家其操作被拒绝。
• 玩家可以关闭 Piggyback 的消息提示。
• 可为骑乘行为设置冷却时间。
• 可要求玩家在骑乘前必须空手。
• 玩家可以关闭自己被骑乘的能力。关闭后，他们将无法骑乘其他玩家。
• 服主可以自定义插件命令。
• 可完全阻止骑乘特定实体，或在特定世界禁用 Piggyback。
• 支持 WorldGuard（在区域中设置 allow-piggyback = DENY 以禁用骑乘）。
• 支持 PlotSquared？（需要测试）
• 非生命实体会被自动阻止骑乘。

---

🎮命令

• /pback - 显示帮助页面。
• /pback help - 同样显示帮助页面。
• /pback toggle <空/玩家名> - 为自己或他人（如果有权限）切换是否允许被骑乘。
• /pback messages <空/玩家名> - 为自己或他人（如果有权限）切换是否显示 Piggyback 消息。
• /pback reload - 重载 Piggyback 的配置和语言文件。

---

🔧权限

• piggyback.use (默认) - 允许用户骑乘实体和玩家（前提是被骑乘的玩家未关闭此功能）。
• piggyback.toggle (op) - 允许用户切换自己是否可被骑乘。
• piggyback.toggle.other (op) - 允许用户切换其他用户是否可被骑乘。
• piggyback.messages (op) - 允许用户为自己切换 Piggyback 消息的开关。
• piggyback.messages.other (op) - 允许用户为他人切换 Piggyback 消息的开关。
• piggyback.cooldown.bypass (op) - 绕过骑乘冷却时间。
• piggyback.reload (op) - 重载 Piggyback 配置和语言文件。

---

⭐配置示例

> 注意：此更新（v1.9.9）中配置已大幅更改。如果是从旧版本升级，请删除现有的 Piggyback 插件文件夹，让新配置重新生成。

# PIGGYBACK 配置文件
general:
  # 启用 bStats 统计
  bStatsMetrics: true
  # 可选值：RIGHT, LEFT, 或 EITHER
  clickType: RIGHT
  requireEmptyHand: true

pickUp:
  Cooldown: 10
  # 可选值：PICKUP 或 RIDE
  clickAction: PICKUP

pickup:
  throwRiderAway: true
  pickUpNPCs: false

ride:
  onlyRidePlayers: true
  rideNPC: false

messages:
  Send: true
  Cooldown: 30

blacklists:
  entityBlacklist:
    - ''
  customEntityBlacklist:
    - ''
  worldBlacklist:
    - ''

---

✨占位符

支持 PlaceholderAPI (by clip)：

• %Piggyback_is_disabled% - 玩家是否关闭了被骑乘功能。
• %Piggyback_is_messages_disabled% - 玩家是否关闭了 Piggyback 消息。
• %Piggyback_cooldown_integer% - 玩家当前的冷却时间（整数秒）。
• %Piggyback_cooldown_decimal% - 玩家当前的冷却时间（两位小数秒）。

支持 mdvwPlaceholderAPI：

• {Piggyback_is_disabled}
• {Piggyback_is_messages_disabled}
• {Piggyback_cooldown_integer}
• {Piggyback_cooldown_decimal}

---

🔧WorldGuard 支持

在 WorldGuard 区域中设置 allow-piggyback = DENY 即可在该区域内禁止骑乘。

---

✨开发者 API

• PiggybackAPI：https://github.com/DrkMatr1984/Piggyback/blob/master/src/main/java/me/blubdalegend/piggyback/PiggybackAPI.java
• Piggyback 事件：https://github.com/DrkMatr1984/Piggyback/tree/master/src/main/java/me/blubdalegend/piggyback/events

---

⭐待办事项

• 配置项 - ItemInHand: true/false：如果为 true，玩家手持物品时也可骑乘实体；如果为 false，则骑乘时必须空手。
• 配置项 - 允许骑乘的实体列表。
• 配置项 - 实体的自定义显示名称排除列表。

---

❓如何提供帮助

我会尽力更新需求列表。欢迎通过插件主页或 GitHub 仓库反馈问题或贡献代码。