Piggy Back (Pickup PLAYERS and MOBS) - PiggyBack - 轻松搬运玩家与生物

PiggyBack 是一款允许玩家将其他玩家或生物“扛”在身上的趣味插件。你可以自定义堆叠数量、投掷力度、冷却时间等，非常适合朋友间的小型服务器或特殊活动使用。

💡主要特性

• 扛起玩家与生物：可以扛起单个玩家，也可以堆叠多个生物。
• 高度可定制：通过配置文件调整各种参数，打造独特体验。
• 投掷功能：可以将堆叠的实体以一定速度投掷出去。
• 忽略列表：可以设置忽略所有、特定玩家或不被他人扛起。

🔧即将推出的功能

• 完整的代码重构。
• 可供其他插件调用的 API 事件。
• 自动化的本地化语言系统。
• 可开关的投掷/发射功能。
• 通过命令扛起玩家。
• PlaceholderAPI 支持。
• 移除忽略命令（正在重新设计中）。

🎮安装方法

• 下载 PiggyBack 插件。（已在 1.16.5, 1.18.1, 1.20.6 版本测试）
• 将下载的 .jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。（已知与 Plugman 兼容）

⭐自定义配置

你可以通过修改 config.yml 文件来调整插件行为：

• 调整投掷力度：修改速度值，控制投掷的方向和高度。
• 设置冷却时间：更改堆叠实体之间的冷却时间（以秒为单位）。
• 禁用特定世界：将世界名称添加到世界黑名单中。
• 自定义拾取物品：添加或修改拾取实体所需的物品，或完全禁用物品要求。
• 调整权限节点：根据你的需求修改权限说明。
• 生物黑名单：禁止特定生物被堆叠。
• 自定义消息：修改堆叠所有者收到的提示信息。
• 自定义音效：更改投掷、卸载、乘客数量达到上限等动作的音效。
• 设置堆叠上限：控制一个玩家最多能堆叠多少个生物。

未来计划的自定义选项

• 在投掷、卸载或达到乘客上限时执行命令。
• 修改粒子效果 ID 及其生成半径。
• 为特定生物设置独立的权限节点。

❓常见问题解答

• 多个玩家可以堆叠在我头上吗？

每个拥有拾取权限的玩家都需要右键点击他们想扛起的玩家来形成堆叠。一个玩家一次只能被一个“底座”玩家扛起。

• 我发现了漏洞或想请求新功能，该去哪里？

欢迎前往插件的官方讨论帖提出功能请求或报告漏洞：https://www.spigotmc.org/threads/piggy-back-pickup-players-and-mobs.494865/

• 我可以更改卸载和投掷时发出的声音吗？

所有音效都可以在 config.yml 中配置。你可以在 Bukkit 官方文档中查找可用的音效列表：https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html

• 如何给予玩家使用此插件的权限？

你需要安装一个权限管理插件（如 LuckPerms 或 Group Manager），然后将相应的权限授予玩家或其所在组。我们推荐使用 LuckPerms。

• 我想扛起我的朋友，但不想被他们扛起，怎么办？

给予你自己 PiggyBack.pickup.ignore 权限，这样其他玩家就无法扛起你了。

✨权限与命令

你需要一个权限插件（如 LuckPerms）来管理以下权限。

权限列表

• PiggyBack.pickup.player：允许扛起其他玩家。
• PiggyBack.pickup.mobs：允许扛起生物。
• PiggyBack.pickup.*：允许扛起玩家和生物。
• PiggyBack.pickup.ignore：使玩家自身免疫被扛起。
• PiggyBack.cmds.ignore：允许玩家使用 /piggy ignore 命令。
• PiggyBack.cmds.ignoreothers：允许玩家使用 /piggy ignore 命令来忽略特定玩家。

命令

• /piggy <ignore> [player|list|clear]

此命令为可选功能，允许玩家管理自己的忽略列表。

• 忽略所有人、特定玩家。
• 清除忽略列表。
• 查看当前的忽略列表。

🔧配置文件示例

以下是 config.yml 的核心配置项示例：

stacking-settings:
  enabled: true
  cooldown: 3
  throw-velocity: '1.45:1.2' # 速度倍数:高度 (支持小数或整数)
  mobstack-limit: 3
  should-stack-take-damage: false
  entity-blacklist:
    - 'WITHER'
  world-blacklist:
    - 'Spawn'
  use-hand-item: true # 如果为 true，则需使用下方指定的物品
  pickup-hand-items:
    - 'SADDLE'

# 权限节点配置
pickup-all-permission: "PiggyBack.pickup.*"
pickup-mobs-permission: "PiggyBack.pickup.mobs"
pickup-players-permission: "PiggyBack.pickup.player"
pickup-ignore-cmd-perm: "PiggyBack.cmds.ignore"
pickup-ignorespecific-cmd-perm: "PiggyBack.cmds.ignoreothers"

# 音效配置 (格式: BUKKIT_SOUND:音量:音高)
Sounds:
  mount-sound: ENTITY_PIG_SADDLE:1:1
  dismount-sound: ENTITY_PIG_SADDLE:1:1
  throw-sound: ENTITY_PIG_SADDLE:1:1
  limit-reached-sound: ENTITY_PIG_SADDLE:1:1

# 粒子效果配置
Particles:
  enabled: true
  throw-particle: HEART

消息文本同样在 config.yml 中配置，支持 [ACTIONBAR]、[SUBTITLE]、[NORMAL] 等前缀来指定显示位置。

---

bStats 信息：本插件使用了 bStats 来收集匿名的使用数据，以帮助开发者改进插件。你可以在配置文件中禁用它。