AutoPickup - 自动拾取

AutoPickup 是一款便捷的 Minecraft 插件，它能自动拾取玩家挖掘的方块与经验，支持自动熔炼和生物掉落物收集，并能在玩家重新登录或服务器重启后保持启用状态。

💡重要提示

• 更新插件版本后，请务必检查并调整配置文件，以确保插件正常工作。
• 推荐使用 LuckPerms 作为权限管理插件。

🎮功能特性

• 自动拾取挖掘的方块和经验。
• 支持拾取生物掉落物和实体经验。
• 为方块提供自动熔炼功能。
• 状态在重新登录或服务器重启后依然保持。
• 支持自定义消息（包含十六进制颜色代码，例如 &#00AAFF）。
• 支持禁用特定权限。
• 支持 PlaceholderAPI (PAPI) 占位符。
• 集成 bStats 统计。
• 提供开发版本。
• 拥有支持 Discord 社区。

🔧命令与权限

主要命令

• /auto
• 功能：启用/禁用自动拾取。
• 所需权限：autopickup.pickup.mined

• /auto reload
• 功能：重载插件配置。
• 所需权限：autopickup.admin

• /autodrops
• 功能：启用/禁用生物掉落物自动拾取。
• 所需权限：autopickup.pickup.entities

• /autosmelt
• 功能：启用/禁用自动熔炼。
• 所需权限：autopickup.pickup.mined.autosmelt

自动启用权限

以下权限控制玩家加入服务器时功能是否默认开启

• autopickup.pickup.mined.autoenabled - 自动拾取
• autopickup.pickup.entities.autoenabled - 生物掉落物拾取
• autopickup.pickup.mined.autosmelt.autoenabled - 自动熔炼

✨配置文件概览

主配置 (config.yml)

主要配置项包括

• ConfigVersion：配置文件版本。
• msgPrefix：消息前缀，支持颜色代码。
• 各类开关消息（如 msgAutoPickupEnable, msgAutoSmeltDisable）。
• voidOnFullInv：当背包已满且自动拾取开启时，是否销毁额外挖掘的方块（适用于监狱服务器，通常不推荐）。
• requirePerms：是否要求玩家拥有权限才能使用命令。

黑名单配置 (blacklist.yml)

用于排除特定方块、实体或世界。

• doBlacklisted：是否启用方块黑名单。
• doBlacklistedEntities：是否启用实体黑名单。
• Blacklisted：方块黑名单列表（使用 Material 名称）。
• BlacklistedEntities：实体黑名单列表（使用 EntityType 名称）。
• BlacklistedWorlds：世界黑名单列表。

参考链接：

• 方块 Material 名称：Spigot Javadocs
• 实体 EntityType 名称：Spigot Javadocs

❓获取支持

如果在使用中遇到问题，请在提交评论前尝试通过以下方式寻求帮助：

• 加入我们的 支持 Discord。
• 在 GitHub 上提交问题。
• 通过 Spigot 站内信联系开发者。

💡支持与帮助

欢迎使用本插件！如有任何问题或疑问，请随时加入我们的 Discord 服务器以获取快速支持。

• Discord 支持：https://discord.gg/ncHH4FP
• 其他支持方式：您也可以通过 GitHub 提交问题，或在 Spigot 上私信 @MrButtersDev。我们几乎每日都会查看。对于快速和一般性支持，Discord 是最佳选择；如需报告错误，请在 GitHub 上创建工单。

> 以下文档由 OpenAI 的 ChatGPT 协助生成。如需进一步澄清，请加入我们的 Discord 或查看 GitHub 上最新的 config.yml 默认配置文件。

---

🎮配置文件 - config.yml

消息与提示

• msgPrefix：字符串，代表与自动拾取功能相关的消息前缀，将在聊天中以特定颜色代码格式显示。
• msgAutoPickupEnable / msgAutoPickupDisable：字符串，代表玩家启用或禁用自动拾取功能时显示的消息。
• msgAutoSmeltEnable / msgAutoSmeltDisable：字符串，代表玩家启用或禁用自动熔炼功能时显示的消息。
• msgAutoMobDropsEnable / msgAutoMobDropsDisable：字符串，代表玩家启用或禁用自动拾取生物掉落物功能时显示的消息。
• msgAutoEnable：字符串，代表自动拾取功能自动启用时显示的消息。doAutoEnableMSG 布尔值决定是否显示此消息。
• msgEnabledJoinMSG：字符串，代表玩家加入游戏且自动拾取功能已自动启用时显示的消息。doEnabledOnJoinMSG 布尔值决定是否显示此消息。
• msgReload：字符串，代表重载配置时显示的消息。
• msgFullInv：字符串，代表玩家背包已满时显示的消息。doFullInvMSG 布尔值决定是否显示此消息。
• msgNoperms：字符串，代表玩家没有权限执行命令时显示的消息。

背包已满提示

• titlebar 部分包含与背包已满时标题栏消息显示相关的设置。

- **doTitleBar**：布尔值，决定是否显示标题栏消息。

- **line1** 和 **line2**：字符串，代表标题栏消息的两行文本，将以特定颜色代码格式显示。

功能与权限设置

• voidOnFullInv：布尔值。当自动拾取功能启用且玩家背包已满时，决定额外破坏的方块是否应被直接销毁（不进入背包）。
• usingSilkSpawnerPlugin：布尔值，默认为 true。指定是否正在使用 Silk Spawner 类插件。若启用，本插件将允许该类插件管理刷怪笼的经验掉落。
• ignoreMobXPDrops：布尔值。决定自动拾取是收集生物死亡时掉落的经验，还是让其自然掉落。
• requirePerms 部分指定玩家执行特定命令是否需要权限。

- **autopickup**：布尔值，决定执行 `/autopickup` 命令是否需要权限。

- **auto-reload**：布尔值，决定执行 `/auto reload` 命令是否需要权限。

---

🎮黑名单配置 - blacklist.yml

功能开关

• doBlacklisted：布尔值。若设为 true，则启用方块黑名单功能，Blacklisted 列表中列出的方块将不会被玩家拾取。
• doBlacklistedEntities：布尔值。若设为 true，则启用实体黑名单功能，BlacklistedEntities 列表中列出的实体被玩家杀死时将不会掉落物品。

列表内容

• Blacklisted：方块名称列表。当黑名单功能启用时，这些方块将被阻止拾取。
• BlacklistedEntities：实体名称列表。当黑名单功能启用时，这些实体被击杀不会掉落物品。
• BlacklistedWorlds：世界名称列表。仅在这些世界中应用黑名单功能。

---

🎮PlaceholderAPI 配置 - papi.yml

设置说明

• papi 部分包含与 PlaceholderAPI 插件相关的字段。

- **enabled** 子字段下包含 `true` 和 `false` 两个字符串子字段，分别代表自动拾取插件启用或禁用时显示的占位符消息。

可用占位符

以下是可用的 PlaceholderAPI 占位符：

• %autopickup_autoenabled%
• %autopickup_dropsenabled%
• %autopickup_autosmeltenabled%