CobbleSpawnRegions

CobbleSpawnRegions

CobbleSpawnRegions 是一个 Fabric 模组，为 Cobblemon 提供强大的基于区域的神奇宝贝生成控制。服务器管理员和地图制作者可以定义自定义区域、管理自然生成限制、创建自定义区域神奇宝贝生成，并通过命令或游戏内 GUI 调整每个区域。

依赖项

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

---

功能特性

• 基于区域的生成控制：创建命名区域并控制区域内 Cobblemon 的生成行为。
• 坐标与区块标记：使用标记棒选择精确的方块位置或整个区块区域。
• 重叠区域优先级系统：高优先级区域优先控制重叠区域，面积较小的区域用作平局决胜。
• 自然生成限制：完全禁用自然生成、阻止特定物种、阻止 Cobblemon 标签，或通过扫描条件字符串排除神奇宝贝。
• 玩家拥有的神奇宝贝豁免：可选择允许玩家拥有的神奇宝贝忽略区域限制。
• 自定义区域生成：配置区域按计时器自动生成自己的神奇宝贝。
• 生成数量控制：设置区域在每个计时器周期尝试生成的神奇宝贝数量。
• 高级神奇宝贝自定义：配置物种、形态、特征、生成几率、几率类型、等级、个体值、努力值奖励、体型、携带物品、捕获规则、招式以及每条目的生成上限。
• 时间、天气与方块条件：按昼夜、天气和允许的生成方块（如 #solid、#water、#air 或特定方块 ID）限制生成。
• 区域与条目生成上限：限制每个区域和每个神奇宝贝条目的存活自定义生成总数。
• 区域内停留行为：生成的神奇宝贝可以使用随机、中心或最近返回目标重新寻路回其区域。
• 捕获限制：使区域生成的神奇宝贝不可捕获，或将其限制为只能使用特定的精灵球。
• 自定义努力值奖励：覆盖击败区域生成的神奇宝贝时获得的努力值。
• 玩家激活范围：可选择在没有玩家靠近区域时暂停自定义生成。
• 上限强制区块加载：可选择强制加载区域区块，最高可达可配置的安全上限。
• 持久生成追踪：生成的神奇宝贝在区块卸载后仍被追踪，以确保生成上限准确。
• GUI 管理：通过游戏内 GUI 管理区域、自然限制、自定义生成、神奇宝贝设置、标签、黑名单和全局选项。
• 管理员实用命令：传送到区域、检查附近的神奇宝贝、强制生成、克隆区域设置、添加/移除神奇宝贝条目以及清除已生成的神奇宝贝。
• 粒子可视化：切换区域可视化以在游戏中查看已标记的区域。
• 性能优化的生成扫描：生成点随时间从已加载区块中扫描，而不是在每次生成尝试时进行繁重的搜索。

---

命令

主命令为 /csr。

命令	权限	描述
/csr giveclaimstick coords	OP / 命令权限	给予一个坐标标记棒，用于选择精确的方块位置。
/csr giveclaimstick chunk	OP / 命令权限	给予一个区块标记棒，用于选择基于区块的区域。
/csr create <名称>	OP / 命令权限	根据当前标记棒的选择创建区域。
/csr clone <源区域> <新名称>	OP / 命令权限	复制区域的设置和神奇宝贝条目到当前标记选择上。
/csr list	OP / 命令权限	列出所有已配置的区域。
/csr info <区域ID>	OP / 命令权限	显示区域的详细信息。
/csr delete <区域ID>	OP / 命令权限	删除区域并清除其追踪数据。
/csr rename <区域ID> <新名称>	OP / 命令权限	重命名区域的显示名称。
/csr visualize <区域ID>	OP / 命令权限	切换区域的粒子可视化。
/csr edit <区域ID>	OP / 命令权限	打开特定区域的编辑器 GUI。
/csr gui	OP / 命令权限	打开主区域列表 GUI。
/csr teleport <区域ID>	OP / 命令权限	将你传送到区域的中心。
/csr tp <区域ID>	OP / 命令权限	/csr teleport 的别名。
/csr priority <区域ID> <值>	OP / 命令权限	设置区域优先级，范围为 -1000 到 1000。
/csr addmon <区域> <神奇宝贝> [形态] [特征]	OP / 命令权限	向区域添加默认的自定义神奇宝贝条目。
/csr removemon <区域> <神奇宝贝> [形态] [特征]	OP / 命令权限	从区域移除匹配的神奇宝贝条目。
/csr forcespawn <区域ID> [数量]	OP / 命令权限	立即尝试在区域中自定义生成。
`/csr killspawned <区域ID> [已加载	已追踪]`	OP / 命令权限
/csr setspawnamount <区域ID> <数量>	OP / 命令权限	设置区域每个生成周期尝试生成的神奇宝贝数量。
/csr playeractivation <区域ID> <true|false> [范围]	OP / 命令权限	切换玩家范围激活，并可选择设置范围。
/csr forcechunks <区域ID> <true|false> [最大区块数]	OP / 命令权限	切换区域的强制区块加载（带上限）。
/csr inspectnearest	OP / 命令权限	打印最近的神奇宝贝的详细信息和条件字符串。
/csr check	OP / 命令权限	显示当前所在位置由哪个区域控制。
/csr reload	OP / 命令权限	重新加载配置文件并重建生成扫描数据。

---

配置

CobbleSpawnRegions 使用位于 config/cobblespawnregions/ 的多文件配置系统。

• config.jsonc：模组的全局设置。
• /regions/：每个已配置区域各自的 .jsonc 文件。
• tracked_spawns.json：区域生成神奇宝贝的持久追踪数据。

全局设置

设置	描述
debugEnabled	启用详细的调试日志记录。
showUnimplementedPokemonInGui	控制未实现的物种是否显示在选择 GUI 中。
showFormsInGui	控制形态是否显示在 GUI 选择菜单中。
showAspectsInGui	控制特征是否显示在 GUI 选择菜单中。
killTrackedPokemonOnServerStop	服务器停止时移除已加载的受追踪神奇宝贝。

区域设置

设置	描述
regionId	命令和配置文件使用的内部 ID。
regionName	在 GUI 和消息中显示的显示名称。
pos1 / pos2	区域的两个角落。
dimension	区域所属的维度。
mode	创建模式：COORDS 或 CHUNK。
priority	控制区域重叠时哪个区域生效。
spawnTimerTicks	自定义生成尝试之间的延迟。
spawnAmountPerSpawn	每个生成周期尝试生成的神奇宝贝数量。
maxTotalSpawns	此区域存活的自定义生成神奇宝贝数量上限。0 表示无限制。
requirePlayerInRange	如果为 true，则仅当有玩家在附近时才运行自定义生成。
playerActivationRange	在区域边界外检查附近玩家的额外范围。
forceChunkLoading	如果为 true，则强制加载区域区块，最高可达配置的上限。
maxForceLoadedChunks	此区域可强制加载的最大区块数。
selectedPokemon	此区域可以生成的自定义神奇宝贝条目列表。
spawnRestrictions	自然生成限制设置。

自然生成限制

设置	描述
disableAll	在此区域控制的位置阻止所有自然 Cobblemon 生成。
excludeOwnedPokemon	允许玩家拥有的神奇宝贝绕过限制。
disallowedSpecies	被阻止自然生成的物种 ID。
disallowedLabels	要阻止的 Cobblemon 标签。
exclusionConditions	用于阻止自然生成的已扫描神奇宝贝属性字符串。

神奇宝贝条目选项

设置	描述
pokemonName	要生成的神奇宝贝物种。
formName	可选的形态名称。
aspects	可选的形态特征，如闪光或与形态相关的特征。
spawnChance	生成几率或权重。
spawnChanceType	COMPETITIVE 加权选择或 INDEPENDENT 百分比概率。
minLevel / maxLevel	生成神奇宝贝的等级范围。
maxSpawnCount	此条目的最大存活生成数量。0 表示无限制。
spawnSettings	时间、天气和允许生成方块的设置。
wanderingSettings	区域内停留的寻路行为。
captureSettings	可捕获性和所需精灵球。
ivSettings	可选的自定义个体值范围。
evSettings	击败后可获得的可选自定义努力值奖励。
sizeSettings	可选的最小/最大体型缩放修饰符。
heldItemsOnSpawn	可选的携带物品几率。
moves	可选的自定义初始招式，包括强制招式。