SpawnerMeta - 自定义刷怪笼插件

SpawnerMeta 是一款功能强大的刷怪笼管理插件，它实现了高度可定制、可升级和可修改的刷怪笼系统。玩家可以购买升级来增强刷怪笼的激活范围、生成延迟和生成数量，几乎所有功能都可以通过配置文件进行调整，为服务器管理带来极大的灵活性。

💡核心特性

• 可升级的刷怪笼：玩家可以购买升级，提升刷怪笼的玩家检测范围、实体生成延迟和生成数量。
• 完全可定制的条件：刷怪笼的生成要求和条件均可修改，并支持显示刷怪笼能否正常工作的警告提示。
• 刷怪笼类型切换：玩家可通过潜行右键点击来更改刷怪笼的生成类型（默认禁用）。
• 精准采集支持：破坏刷怪笼支持可定制的精准采集附魔。
• 刷怪笼堆叠：多个同类型刷怪笼可以堆叠成一个方块（默认禁用）。
• 可自定义的全息显示：显示刷怪笼类型、堆叠数和警告信息（默认仅警告启用）。
• 空刷怪笼：允许玩家使用刷怪蛋更改其类型而不会消耗刷怪蛋（默认禁用）。
• 刷怪笼开关：玩家可以在升级GUI中开启或关闭刷怪笼（默认禁用）。
• 生成实体上限：刷怪笼在生成一定数量的实体后会自动销毁（默认禁用）。
• 刷怪笼充能：玩家可以购买刷怪笼充能次数，限制其可生成的总次数（默认禁用）。
• 实体行为修改：可修改生成实体的行为，例如禁用攻击、移动、使其静音等。
• 玩家持有上限：限制玩家可拥有的刷怪笼数量（默认禁用）。
• 区块刷怪笼上限：限制每个区块内可放置的刷怪笼数量（默认禁用）。
• 内置商店系统：已内置刷怪笼商店，支持购买和出售功能（默认购买启用，出售禁用）。
• 多样化的支付方式：支持使用经验点、经验等级、游戏货币甚至物品作为价格。
• 全面的文本自定义：语言文件支持十六进制颜色和渐变效果。
• 更多配置选项：配置文件提供了极其丰富的自定义选项。

高级版本

如果你喜欢 SpawnerMeta 但需要更多功能，可以考虑购买高级版本 SpawnerLegacy，它提供了更深入的定制和更多特性。

❓要求与依赖

运行环境

• Minecraft 版本：1.14. - 1.21.
• Java 版本：21+

支持的插件

• Vault：如需使用游戏货币（而非经验）作为支付方式。
• WildStacker：用于实体堆叠功能。
• WildTools：用于撬棍工具支持（未完全测试）。
• ShopGUI+：自定义刷怪笼供应商支持（未完全测试）。

🔧命令列表

以下命令默认均对玩家启用

• /spawnerview - 查看所有刷怪笼及其状态。
• /spawnershop - 打开刷怪笼购买商店。
• /spawnerdrops - 当背包已满时，取回刷怪笼掉落物。
• /spawnerlocations - 查看所有已放置的刷怪笼位置。
• /spawnertrust - 管理刷怪笼的受信任玩家列表。

使用 /spawnermeta 或 /sm 查看管理操作：

管理命令

• /sm update - 更新插件。

- `/sm update #all` - 更新所有内容。

- `/sm update configuration` - 更新配置文件。

- `/sm update language` - 更新语言文件。

- `/sm update spawners` - 更新所有刷怪笼。

- `/sm update shop` - 更新刷怪笼商店。

• /sm give [实体^] [数量*] [玩家?] [数据?] - 给予其他玩家刷怪笼。

- 若不指定玩家，则给予自己。

- 数据格式：`[范围等级];[延迟等级];[数量等级];[充能次数];[生成实体上限]`，使用 `-` 表示默认值。

- 示例：`/sm give PIG 3 PlayerName 1;2;-;16;100`

• /sm modify - 修改目标刷怪笼。

- `/sm modify type [实体^]` - 更改刷怪笼类型。

- `/sm modify stack [(+/-) 数值*]` - 更改堆叠数量（使用 + 或 - 来增减）。

- `/sm modify entities [(+/-) 数值*]` - 更改可生成实体数量。

- `/sm modify charges [(+/-) 数值*]` - 更改充能次数。

• /sm location - 管理刷怪笼位置。

- `/sm location view [玩家^] [世界^?]` - 查看指定世界（或所有世界）中已放置的刷怪笼位置。

- `/sm location validate [玩家^] [世界^?]` - 验证并移除无效的刷怪笼位置记录。

- `/sm location clear [玩家^] [世界^?]` - 清除指定世界（或所有世界）中的刷怪笼位置记录。

• /sm active [世界^] - 查看指定世界中的活跃刷怪笼数量。
• /sm disable [true/false] - 全局切换刷怪笼是否生成实体。
• /sm version - 查看插件版本。

> 参数说明：^ - 必填参数，* - 可选参数，? - 可选参数。

🎮权限节点

基础命令权限

• spawnermeta.sm - 允许使用 /sm 命令。
• spawnermeta.command.view - 允许使用 /spawnerview。
• spawnermeta.command.shop - 允许使用 /spawnershop。
• spawnermeta.command.drops - 允许使用 /spawnerdrops。
• spawnermeta.command.locations - 允许使用 /spawnerlocations。
• spawnermeta.command.trust - 允许使用 /spawnertrust。

功能使用权限

• spawnermeta.eggs - 允许使用刷怪蛋更改刷怪笼类型。
• spawnermeta.stacking - 允许堆叠刷怪笼。
• spawnermeta.place - 允许放置刷怪笼。
• spawnermeta.break - 允许破坏刷怪笼。
• spawnermeta.unbreakable.bypass - 允许绕过“不可破坏”刷怪笼选项。
• spawnermeta.breaking.bypass.silktouch - 允许绕过精准采集附魔要求。

商店与升级权限

• spawnermeta.upgrades.open - 允许打开刷怪笼升级界面。
• spawnermeta.upgrades.buy - 允许购买刷怪笼升级。
• spawnermeta.shop.buy.open - 允许打开刷怪笼购买商店。
• spawnermeta.shop.buy.purchase - 允许购买刷怪笼。
• spawnermeta.shop.sell.open - 允许打开刷怪笼出售商店。
• spawnermeta.shop.selection.open - 允许打开刷怪笼商店选择器。

所有权与自然刷怪笼绕过权限

• spawnermeta.ownership.bypass.limit - 允许绕过玩家持有刷怪笼数量上限。
• spawnermeta.ownership.bypass.breaking - 允许绕过破坏玩家所属刷怪笼的限制。
• spawnermeta.ownership.bypass.stacking - 允许绕过堆叠玩家所属刷怪笼的限制。
• spawnermeta.ownership.bypass.changing - 允许绕过更改玩家所属刷怪笼类型的限制。
• spawnermeta.ownership.bypass.interact - 允许绕过与玩家所属刷怪笼交互的限制。
• spawnermeta.ownership.bypass.upgrading - 允许绕过升级玩家所属刷怪笼的限制。
• spawnermeta.natural.bypass.breaking - 允许绕过破坏自然生成刷怪笼的限制。
• spawnermeta.natural.bypass.stacking - 允许绕过堆叠自然生成刷怪笼的限制。
• spawnermeta.natural.bypass.changing - 允许绕过更改自然生成刷怪笼类型的限制。
• spawnermeta.natural.bypass.interact - 允许绕过与自然生成刷怪笼交互的限制。
• spawnermeta.natural.bypass.upgrading - 允许绕过升级自然生成刷怪笼的限制。

> 此外，插件还为自定义的破坏、堆叠和所有权功能创建了对应的权限节点。

✨插件API

SpawnerMeta 提供了易于集成的API，支持刷怪笼事件、放置、破坏等操作。请注意，API可能会在部分更新中发生变动。

基础用法示例

// 首先获取 SpawnerMeta 插件实例
SpawnerMeta sm = (SpawnerMeta) Bukkit.getPluginManager().getPlugin("SpawnerMeta");
// 然后获取 API 提供者
APIInstance api = sm.getAPI();
// 之后你可以注册事件、放置或破坏刷怪笼等
// 注册事件需要事件类和事件执行器
api.register(SpawnerPlaceEvent.class, event -> {
    // 在此处执行你的逻辑
});

事件列表

• IEvent - 事件标记接口。
• SpawnerEvent - 可取消的事件。

- **SpawnerPlayerEvent** - 由玩家执行的事件。

- **SpawnerInteractEvent** - 玩家与刷怪笼方块交互时触发。

- **SpawnerBreakEvent** - 玩家破坏刷怪笼时触发。

- **SpawnerChangeEvent** - 玩家更改刷怪笼类型时触发。

- **SpawnerPlaceEvent** - 玩家放置刷怪笼时触发。

- **SpawnerStackEvent** - 玩家堆叠刷怪笼时触发。

- **SpawnerModifyEvent** - 玩家修改刷怪笼时触发。

- **SpawnerUpgradeEvent** - 玩家升级刷怪笼时触发。

- **SpawnerChargeEvent** - 玩家为刷怪笼充能时触发。

- **SpawnerSwitchEvent** - 玩家切换刷怪笼状态时触发。

- **SpawnerEmptyEvent** - 玩家清空刷怪笼时触发。

- **SpawnerOpenEvent** - 玩家打开刷怪笼时触发。

- **SpawnerExplodeEvent** - 刷怪笼爆炸时触发。

- **SpawnerPreSpawnEvent** - 刷怪笼即将生成实体前触发。

- **SpawnerPostSpawnEvent** - 刷怪笼生成实体后触发。

• IPriceEvent - 与价格相关的事件。

⭐支持的刷怪笼类型

配置插件时，请使用以下大写英文名称，而非 Bukkit 提供的名称。

• Allay (ALLAY) (1.19+)
• Armadillo (ARMADILLO) (1.20.6+)
• Armor Stand (ARMOR_STAND) (仅管理员)
• Axolotl (AXOLOTL) (1.17+)
• Bat (BAT)
• Bee (BEE) (1.15+)
• Blaze (BLAZE)
• Boat (BOAT) (仅管理员)
• Boat with Chest (CHEST_BOAT) (仅管理员)
• Bogged (BOGGED) (1.21+)
• Breeze (BREEZE) (1.21+)
• Camel (CAMEL) (1.20+)
• Camel Husk (CAMEL_HUSK) (1.21.11+)
• Cat (CAT)
• Cave Spider (CAVE_SPIDER)
• Chicken (CHICKEN)
• Cod (COD)
• Cow (COW)
• Creeper (CREEPER)
• Dolphin (DOLPHIN)
• Donkey (DONKEY)
• Drowned (DROWNED)
• Elder Guardian (ELDER_GUARDIAN)
• Enderman (ENDERMAN)
• Endermite (ENDERMITE)
• Ender Dragon (ENDER_DRAGON)
• Evoker (EVOKER)
• Experience Bottle (EXPERIENCE_BOTTLE) (仅管理员)
• Experience Orb (EXPERIENCE_ORB) (仅管理员)
• Fox (FOX)
• Frog (FROG) (1.19+)
• Ghast (GHAST)
• Giant (GIANT)
• Glow Squid (GLOW_SQUID) (1.17+)
• Goat (GOAT) (1.17+)
• Guardian (GUARDIAN)
• Hoglin (HOGLIN) (1.16+)
• Horse (HORSE)
• Husk (HUSK)
• Illusioner (ILLUSIONER)
• Iron Golem (IRON_GOLEM)
• Llama (LLAMA)
• Magma Cube (MAGMA_CUBE)
• Minecart (MINECART) (仅管理员)
• Minecart with Chest (MINECART_CHEST) (仅管理员)
• Minecart with Command Block (MINECART_COMMAND) (仅管理员)
• Minecart with Furnace (MINECART_FURNACE) (仅管理员)
• Minecart with Hopper (MINECART_HOPPER) (仅管理员)
• Minecart with Spawner (MINECART_SPAWNER) (仅管理员)
• Minecart with TNT (MINECART_TNT) (仅管理员)
• Mule (MULE)
• Mushroom Cow (MUSHROOM_COW)
• Nautilus (NAUTILUS) (1.21.11+)
• Ocelot (OCELOT)
• Panda (PANDA)
• Parched (PARCHED) (1.21.11+)
• Parrot (PARROT)
• Phantom (PHANTOM)
• Pig (PIG)
• Piglin (PIGLIN) (1.16+)
• Piglin Brute (PIGLIN_BRUTE) (1.16.2+)
• Pig Zombie (PIG_ZOMBIE) (-1.15)
• Pillager (PILLAGER)
• Polar Bear (POLAR_BEAR)
• Pufferfish (PUFFERFISH)
• Rabbit (RABBIT)
• Ravager (RAVAGER)
• Salmon (SALMON)
• Sheep (SHEEP)
• Shulker (SHULKER)
• Silverfish (SILVERFISH)
• Skeleton (SKELETON)
• Skeleton Horse (SKELETON_HORSE)
• Slime (SLIME)
• Sniffer (SNIFFER) (1.20+)
• Snowman (SNOWMAN)
• Spider (SPIDER)
• Squid (SQUID)
• Stray (STRAY)
• Strider (STRIDER) (1.16+)
• Tadpole (TADPOLE) (1.19+)
• Trader Llama (TRADER_LLAMA)
• Tropical fish (TROPICAL_FISH)
• Turtle (TURTLE)
• Vex (VEX)
• Villager (VILLAGER)
• Vindicator (VINDICATOR)
• Wandering Trader (WANDERING_TRADER)
• Warden (WARDEN) (1.19+)
• Witch (WITCH)
• Wither (WITHER)
• Wither Skeleton (WITHER_SKELETON)
• Wolf (WOLF)
• Zoglin (ZOGLIN) (1.16+)
• Zombie (ZOMBIE)
• Zombie Horse (ZOMBIE_HORSE)
• Zombie Nautilus (ZOMBIE_NAUTILUS) (1.21.11+)
• Zombie Villager (ZOMBIE_VILLAGER)
• Zombified Piglin (ZOMBIFIED_PIGLIN) (1.16+)

🔧帮助与支持

• 问题反馈：如需帮助、发现漏洞或错误，请加入我的 Discord 服务器或在讨论区留言（回复时间可能稍长）。
• 教程视频：我们提供了多语言教程视频（英文、俄文、西班牙文），版本可能不同。如果你制作了关于 SpawnerMeta 的视频并希望展示在此页面，欢迎联系我！
• 支持开发：如果你喜欢使用 SpawnerMeta，请考虑捐赠以支持插件的持续改进和质量提升。