PickupArrows - 自动拾箭

简介

PickupArrows 是一款高度可配置的插件，它允许你精细控制玩家可以拾取哪些射出的箭矢。无论是想拾取骷髅的箭、禁用火焰箭的拾取，还是管理三叉戟，这个插件都能满足你的需求。它支持权限、区域保护（WorldGuard），并拥有灵活的配置选项。

💡基本信息

• 当前版本: v7.0.0
• 最低要求: Minecraft 1.20.6 或更高版本
• 旧版本支持: 低于 1.20.6 的版本请使用 v6.x

🎮核心功能

• 灵活配置可拾取的箭矢来源与类型：

- 支持配置从不同实体/方块拾取箭矢。

- 可分别控制普通箭、火焰箭、光灵箭、药箭和三叉戟的拾取。

• 广泛的来源支持：

- 玩家

- 骷髅

- 弩（包括灾厄村民和溺尸使用的）

- 发射器

- 溺尸

- 灾厄村民

• 权限系统：

- 可配置是否启用权限检查。

- 为每种箭矢类型提供独立的权限节点。

• WorldGuard 区域支持：

- 可与 WorldGuard 联动。

- 允许或禁止插件在特定区域生效。

• 游戏内命令：

- 提供 `/pickuparrows` 命令来切换拾取状态。

• 第三方集成：

- 内置 bStats 用于收集匿名使用统计（可禁用）。

🔧配置说明

配置文件允许你详细定义拾取规则。主要配置项如下

启用权限检查

• usePermissions: false

- 设置为 `true` 时，插件将检查玩家权限。

- 设置为 `false` 时，所有玩家均可拾取已启用的箭矢。

定义拾取来源 (`pickupFrom`)

在此部分，你可以为每个实体/来源类型设置是否可拾取各类投射物。格式如下：

skeleton:
  fire: true
  normal: true
  spectral: true
  tipped: true
  trident: true

• 支持的来源包括：skeleton（骷髅）、player（玩家）、crossbow（弩）、dispenser（发射器）、drowned（溺尸）、pillager（灾厄村民）。
• 每种来源下可设置 fire（火焰箭）、normal（普通箭）、spectral（光灵箭）、tipped（药箭）、trident（三叉戟）是否为 true（可拾取）。

未知来源回退设置 (`unknown`)

• 当箭矢来源未在列表中定义时，将使用此设置。
• range: 5.0 定义了用于权限检查的搜索范围。

WorldGuard 设置

• useWorldGuard: false

- 设置为 `true` 以启用 WorldGuard 支持。

• useListAsDenylist: false

- 设置为 `false` 时，下方的 `regions` 列表为**允许列表**（仅这些区域生效）。

- 设置为 `true` 时，`regions` 列表为**拒绝列表**（这些区域不生效）。

• regions: []

- 在此处添加区域名称。示例：

      regions:
        - spawn
        - arena

⭐权限节点

如果配置中 usePermissions 设置为 true，则需要以下权限。若无权限系统，则所有权限仅对 OP 有效。

• pickuparrows.allow.normal

- 允许拾取普通箭（非燃烧）。

• pickuparrows.allow.fire

- 允许拾取火焰箭（燃烧）。

• pickuparrows.allow.spectral

- 允许拾取光灵箭。

• pickuparrows.allow.tipped

- 允许拾取药箭。

• pickuparrows.allow.trident

- 允许拾取三叉戟。

• pickuparrows.*

- 包含所有子权限。

• pickuparrows.allow.*

- 包含所有拾取箭矢的权限。

🔧命令

• /pickuparrows (别名：pa, arrow, arrows, pickuparrow)

- 在游戏中切换你个人的箭矢拾取状态。

✨下载与开发

• 最新开发版：可从 [Jenkins](提供的链接) 获取。
• 源代码：托管于 [GitHub](提供的链接)。

❓已知问题

• 当启用权限检查时，插件会使用范围检查。如果范围内有拥有权限的玩家，则任何玩家都能拾取那支箭矢。

🔧更新日志摘要

版本 7.0.0

• 更新代码以支持 1.20.6 及更高版本。
• 重命名列表选项为 useListAsDenylist。

版本 6.2.4

• 更新 bStats。

（更详细的更新日志请查看原页面。）

🔧数据统计 (bStats)

本插件使用 bStats 收集匿名使用数据，以帮助改进插件。

• 查看数据：数据公开于 https://bstats.org/plugin/bukkit/PickupArrows
• 收集的数据包括：

- 服务器随机生成的 UUID

- 在线玩家数量

- 服务器在线模式

- Bukkit 版本

- Java 版本

- 操作系统名称、版本、架构和核心数

- 已安装的 bStats 支持的插件列表

如何禁用 bStats

你可以在 ../plugins/bStats/config.yml 文件中找到 opt-out 选项来选择退出数据收集。

🔧其他信息

• 原作者：@mushroomhostage
• 许可证：MIT License
• 捐赠：开发者接受捐赠以支持持续开发，包括比特币捐赠。

- 比特币地址：`1NnrRgdy7CfiYN63vKHiypSi3MSctCP55C`