CobbleSpawners

CobbleSpawners

CobbleSpawners 是一款适用于 Cobblemon 的综合性 Fabric 模组，为服务器所有者和地图制作者提供对宝可梦生成的全面控制。放置并管理高度可配置的刷怪笼，它们可以按计时器运行、生成具有自定义属性和特征的宝可梦，甚至能在已禁用自然生成的受保护区域中运作。

## [警告]

CobbleSpawners 现已进入维护模式。

此模组只会在必要时接收错误修复和兼容性更新。

新功能和未来开发已转移至 CobbleSpawnRegions，它是 CobbleSpawners 的新一代改进替代品。

新用户应改用 CobbleSpawnRegions。

前置依赖

• Fabric API
• Fabric Language Kotlin
• Cobblemon
• E-Utils

功能

• 高级刷怪笼方块：放置可在游戏内配置的自定义刷怪笼方块。可以将它们设为可见或隐形，还可以复制已完整配置的刷怪笼并放置到其他位置。
• 精细的生成控制：配置生成计时器、每次生成的宝可梦数量、每个刷怪笼的生成总上限，以及宝可梦的生成半径。
• 全面自定义宝可梦：控制生成宝可梦的各项属性，包括种类、形态、自定义特征（例如闪光）、等级范围、各项属性的个体值范围、被击败时提供的努力值、体型修正，以及带有自定义概率的携带物品。
• 条件生成：设置刷怪笼仅在特定时段（白天/夜晚）、特定天气条件（晴天、下雨、雷暴）以及特定地点类型（地表、地下、水中）运行。
• 智能安全生成：刷怪笼会进行高级检查，确保宝可梦只会在其生成半径内安全且可到达的位置出现。
• 强大的管理员工具：提供完整的命令套件和直观的图形界面，方便管理、传送到服务器上的刷怪笼并查看其位置。
• 性能优化功能：可以设置仅在附近有玩家时激活刷怪笼，还可选择强制区块保持加载，以确保关键区域稳定生成宝可梦。

命令

主要命令是 /cobblespawners，别名为 /cs。

| 命令 | 权限 | 描述 |
| :— | :— | :— |
| /cs listgui | cobblespawners.listgui | 打开主界面，列出服务器上的所有刷怪笼，便于管理。 |
| /cs listgui <spawnerName> | cobblespawners.listgui | 打开指定刷怪笼的配置界面。 |
| /cs givespawnerblock | cobblespawners.givespawnerblock | 给予你一个空白的可配置刷怪笼方块。 |
| /cs givespawnerblockcopy <name> | cobblespawners.givespawnerblockcopy | （非常实用！） 给予你一个现有刷怪笼的副本，包含其中的所有宝可梦和设置。 |
| /cs rename <oldName> <newName> | cobblespawners.rename | 重命名现有刷怪笼。 |
| /cs teleport <spawnerName> | cobblespawners.teleport | 将你直接传送到指定刷怪笼的位置。 |
| /cs togglevisibility <name> | cobblespawners.togglevisibility | 切换刷怪笼方块的显示状态，使其可见或不可见（空气）。 |
| /cs toggleradius <spawnerName> | cobblespawners.toggleradius | 切换刷怪笼半径的粒子显示效果，仅你自己可见。 |
| /cs killspawned <spawnerName> | cobblespawners.killspawned | 击杀指定刷怪笼当前生成的所有宝可梦。 |
| /cs reload | cobblespawners.reload | 从磁盘重新加载所有配置文件。 |
| /cs inspectnearest | cobblespawners.inspectnearest | 将最近的宝可梦的详细信息记录到控制台，便于调试形态和属性。 |
| /cs addmon <spawner> <poke> [form] | cobblespawners.addmon | 通过命令将一只使用默认设置的宝可梦添加到刷怪笼。 |
| /cs removemon <spawner> <poke> [form] | cobblespawners.removemon | 通过命令从刷怪笼中移除一只宝可梦。 |

配置

CobbleSpawners 使用多文件配置系统，配置文件位于 config/cobblespawners/。

• config.jsonc：此文件包含影响所有刷怪笼的全局设置。
• /spawners/：此子目录为你放置的每个刷怪笼单独保存一个 .jsonc 文件，支持非常详细且有条理的配置。

config.jsonc – 全局设置

此文件用于控制模组的整体行为。

| 设置 | 描述 |
| :— | :— |
| debugEnabled | 设置为 true 可在控制台输出极其详细的日志，有助于排查生成条件问题。 |
| cullSpawnerPokemonOnServerStop | 如果设置为 true，服务器停止或重启时，此模组生成的所有宝可梦都会被移除，以防止累积。 |

单个刷怪笼的设置（位于 /spawners/）

每个刷怪笼都有自己的文件，你可以通过游戏内界面（/cs listgui <name>）管理，也可以直接编辑该文件。

刷怪笼关键选项

| 设置 | 描述 |
| :— | :— |
| spawnTimerTicks | 两次生成尝试之间的游戏刻延迟（20 个游戏刻 = 1 秒）。 |
| spawnLimit | 此生成器同时可生成的宝可梦数量上限。 |
| spawnAmountPerSpawn | 每次计时器结束时尝试生成的宝可梦数量。 |
| requirePlayerInRange | 如果为 true，只有玩家位于 playerActivationRange 范围内时，生成器才会激活。 |
| forceChunkLoading | 如果为 true，生成器会保持周围区块处于加载状态，确保即使附近没有玩家也能正常运作。适用于自动化竞技场或世界地标。 |

宝可梦条目选项

为生成器添加每种宝可梦时，你都可以进行大量自定义：

| 设置 | 描述 |
| :— | :— |
| spawnChanceType | 决定如何计算生成概率。COMPETITIVE 表示生成器中的所有宝可梦会根据各自的权重“竞争”生成机会。INDEPENDENT 表示每种宝可梦都有独立的生成概率，因此同一时间可以生成多种不同的宝可梦。 |
| spawnSettings | 用于控制生成条件的选项：spawnTime（ALL、DAY、NIGHT）、spawnWeather（ALL、CLEAR、RAIN、THUNDER）以及 spawnLocation（ALL、SURFACE、UNDERGROUND、WATER）。 |
| captureSettings | 控制宝可梦isCatchable是否启用，以及是否要restrictCaptureToLimitedBalls限制可用球种；你可以指定所需的精灵球列表。 |
| ivSettings | 如果 allowCustomIvs 为 true，你可以为六项 IV 属性分别设置最小值和最大值。 |
| evSettings | 如果 allowCustomEvsOnDefeat 为 true，你可以指定玩家击败宝可梦后获得的确切 EV 数值。 |
| heldItemsOnSpawn | 如果 allowHeldItemsOnSpawn 为 true，你可以提供物品 ID 列表，并设置宝可梦携带每种物品的概率。 |