PickUpSpawners - 刷怪笼拾取插件

PickUpSpawners 是一款功能强大的插件，它允许玩家在世界中拾取和放置刷怪笼，并提供了丰富的自定义选项和商店系统。

💡核心功能

• 拾取与放置刷怪笼：在配置文件中指定的世界内，玩家可以拾取和放置刷怪笼。
• 权限控制：通过权限节点精确控制谁可以拾取、放置或购买刷怪笼。
• 无精准采集拾取：拥有 pickupspawners.nosilk 权限的玩家无需使用附有“精准采集”的工具即可拾取刷怪笼。
• 刷怪笼商店 (GUI)：通过一个简洁的图形界面，玩家可以购买不同类型的刷怪笼（需要 Vault 和经济插件支持）。
• 自定义 GUI 皮肤：可以自定义刷怪笼商店界面的外观。
• 刷怪笼类型修改：可通过配置文件开关，允许玩家使用怪物蛋右键点击刷怪笼来更改其生成的生物类型。
• 爆炸掉落：可配置刷怪笼被爆炸破坏时是否掉落，并设置掉落概率。
• 简易保护系统：可启用刷怪笼保护，防止被其他玩家破坏。
• 控制台命令：支持通过控制台使用 /pickupspawners give 命令发放刷怪笼，非常适合用作活动奖励。
• 广泛的生物支持：兼容多达 34 种不同的生物刷怪笼类型。

🎮命令

主命令 /pickupspawners 可简写为 /ps。

• /pickupspawners reload

重载插件的配置文件。

• /pickupspawners get

打开刷怪笼商店的图形界面 (GUI)。玩家需要拥有 pickupspawners.get 权限以及对应刷怪笼类型的购买权限。

• /pickupspawners give <spawner type> <amount> [player name]

给予指定玩家特定类型和数量的刷怪笼。此命令可由玩家（需 pickupspawners.give 权限）或在控制台执行。

✨权限列表

主要权限

• pickupspawners.reload - 允许使用重载命令。（默认仅 OP）
• pickupspawners.pickup - 允许拾取刷怪笼。（非默认）
• pickupspawners.place - 允许放置刷怪笼。（非默认）
• pickupspawners.nosilk - 拾取刷怪笼时无需“精准采集”附魔。（非默认）
• pickupspawners.bypassprotection - 允许玩家破坏受保护的刷怪笼。（默认仅 OP）
• pickupspawners.allworlds - 允许在配置文件未启用的世界中拾取/放置刷怪笼。（默认仅 OP）
• pickupspawners.get - 允许玩家使用 /pickupspawners get 命令打开 GUI 商店。（非默认）
• pickupspawners.give - 允许玩家使用 /pickupspawners give 命令获取刷怪笼。（非默认）
• pickupspawners.eggchange - 允许玩家无视配置设置，始终可以使用怪物蛋更改刷怪笼类型。（非默认）

个体刷怪笼权限

这些权限仅对已拥有 pickupspawners.get 或 pickupspawners.give 权限的玩家生效。每个刷怪笼类型都有对应的权限节点，用于控制玩家是否可以获取或购买该类型刷怪笼。

**默认开启的权限（玩家默认拥有）**

• pickupspawners.bat
• pickupspawners.blaze
• pickupspawners.cavespider
• pickupspawners.chicken
• pickupspawners.cow
• pickupspawners.creeper
• pickupspawners.enderman
• pickupspawners.endermite
• pickupspawners.guardian
• pickupspawners.horse
• pickupspawners.mooshroom
• pickupspawners.ocelot
• pickupspawners.pig
• pickupspawners.pigman
• pickupspawners.rabbit
• pickupspawners.sheep
• pickupspawners.silverfish
• pickupspawners.skeleton
• pickupspawners.spider
• pickupspawners.squid
• pickupspawners.slime
• pickupspawners.magmacube
• pickupspawners.villager
• pickupspawners.witch
• pickupspawners.wolf
• pickupspawners.zombie
• pickupspawners.irongolem
• pickupspawners.snowman
• pickupspawners.llama
• pickupspawners.polarbear

**默认关闭的权限（非默认）**

• pickupspawners.enderdragon
• pickupspawners.giant
• pickupspawners.wither
• pickupspawners.ghast

> 注意：若要取消玩家默认拥有的某个刷怪笼权限，请授予其带 “-” 前缀的权限，例如 -pickupspawners.ghast。

🔧配置说明

首次运行插件时，会在插件数据文件夹内创建 PickUpSpawners 文件夹，其中包含 config.yml 配置文件。

重要：更新插件时，请确保您的配置文件包含与默认配置相同的设置项。

主要配置选项

• enabled_pickup_in_worlds：允许拾取刷怪笼的世界列表（请使用精确的世界名称）。
• enabled_placement_in_worlds：允许放置刷怪笼的世界列表。
• pickup_natural_spawners：是否允许玩家挖掘自然生成的刷怪笼（如地牢、烈焰人塔中的）。
• spawner_changing：是否允许使用怪物蛋更改刷怪笼类型。
• spawner_protection：是否对放置的刷怪笼启用玩家间保护。
• crouch_mob_spawning：玩家潜行时是否可以使用怪物蛋在刷怪笼上生成生物。
• explosion_drop：刷怪笼被爆炸破坏时是否掉落。
• explosion_chance：刷怪笼爆炸掉落的概率（0-100）。
• gui_shop：GUI 是否作为商店运行（设置为 false 将禁用所有价格并移除对 Vault 的依赖）。
• [生物名]_spawner_cost：在 GUI 商店中购买对应刷怪笼的价格。设置为 -1 可使其不在商店中显示。

❓依赖与安装

需求

• 必需：Spigot 或 Paper 服务端。
• 可选但推荐：如需使用 GUI 商店功能，则需要安装 Vault 及一个兼容的经济插件（如 EssentialsX）。

安装步骤

• 下载 PickUpSpawners.jar 文件。
• 将其放入服务器的 plugins 文件夹。
• 重启服务器。
• 根据需求编辑生成的 plugins/PickUpSpawners/config.yml 文件。
• 使用 /ps reload 重载配置或重启服务器使更改生效。

⭐开发者 API

插件提供了一些公共方法，方便其他开发者进行集成。

• PickUpSpawnersUtil.getSpawnerDisplayName(ItemStack spawnerItem)

返回刷怪笼物品的类型名称（字符串）。例如，传入一个 PIG_ZOMBIE 类型的刷怪笼，会返回字符串 "Pigman"。

• PickUpSpawnersUtil.createSpawner(String spawnerDisplayName)

返回指定类型的刷怪笼物品。例如，传入 "Pigman"，会返回一个 PIG_ZOMBIE 类型的刷怪笼物品。

• PickUpSpawnersUtil.getDisplayNameFromSpawnerTypeName(String spawnerTypeName)

从刷怪笼类型名返回其显示名称。例如，传入 "PIG_ZOMBIE"，会返回字符串 "Pigman"。

• PickUpSpawnersUtil.getExplosionRate(PickUpSpawners pluginInstance)

获取爆炸时刷怪笼的掉落率。

• PickUpSpawnersUtil.setExplosionRate(PickUpSpawners pluginInstance, int rate)

设置爆炸时刷怪笼的掉落率。

🔧其他信息

• 问题反馈：如果您遇到任何问题或漏洞，请在评论区留言或联系开发者，而不是直接留下负面评价，这将有助于更快地修复问题。
• 功能建议：如果您有新的功能想法，欢迎通过私信或评论告知开发者，会将其添加到待办列表。
• 支持开发者：如果您觉得本插件有帮助，可以通过捐赠请开发者喝杯咖啡以示支持。
• 源代码：可在指定链接获取。