CobbleBoss

重要：

Fabric 和 NeoForge 使用相同的字段名称和顶层 TOML 结构。

如果旧版 NeoForge 配置是在此统一版本推出前生成的，请删除旧配置文件，或手动将其中的值移至顶层。

level-mapping.json

用途：

将玩家的宝可梦等级映射为 Boss 等级。

说明：

• 仅在启用自定义等级映射时使用。
• 左侧为玩家等级。
• 右侧为 Boss 等级。
• 如果未找到映射，则可以使用常规等级计算。

pokemon-max-level.json

用途：

控制 Cobblemon 的全局宝可梦等级上限。

字段：

• configName
• maxPokemonLevel
• description

说明：

• 默认等级上限通常为 900。
• 此设置会影响 Cobblemon 使用的全局宝可梦等级上限。

boss-spawn.toml

用途：

控制 Boss 自然生成。

字段：

• enableBossSpawn
• checkIntervalTicks
• spawnChance
• enableSpawnTimeRandom
• randomValueMin
• randomValueMax
• spawnFrequency

说明：

• checkIntervalTicks 的范围为 100 到 72000。
• spawnChance 的范围为 0 到 1。
• randomValueMin 和 randomValueMax 的范围为 1 到 10000。
• spawnFrequency 的范围为 0 到 100。

boss-level.toml

用途：

控制 Boss 等级计算。

字段：

• bossLevelMultiplier
• minBossLevel
• maxBossLevel
• includePCPokemon
• scaleByMaxLevel
• enableCustomLevelMapping
• enableLevelRandom
• randomMin
• randomMax

说明：

• bossLevelMultiplier 的范围为 1.0 到 10.0。
• minBossLevel 的范围为 1 到 100。
• maxBossLevel 的范围为 50 到 200。
• enableCustomLevelMapping 用于控制是否使用 level-mapping.json。

boss-reward.toml

用途：

控制默认 Boss 奖励概率。

字段：

• minDropRate
• maxDropRate
• levelScale

重要说明：

chance 大于 0 的直接奖励条目和奖励池会使用各自设置的概率。

没有设置 chance 或 chance 为 0 的直接奖励条目和奖励池，会使用此配置中的默认掉落率。

说明：

• minDropRate 和 maxDropRate 的范围为 0 到 1。
• levelScale 的范围为 1 到 1000。

boss-penalty.toml

用途：

控制默认惩罚概率。

字段：

• enablePenalty
• minPenaltyChance
• maxPenaltyChance
• penaltyLevelScale

重要说明：

chance 大于 0 的惩罚条目会使用各自设置的概率。

没有设置 chance 或 chance 为 0 的惩罚条目，会使用此配置中的默认惩罚概率。

说明：

• minPenaltyChance 和 maxPenaltyChance 的范围为 0 到 1。
• penaltyLevelScale 的范围为 1 到 1000。

boss-battle-check.toml

用途：

控制 Boss 战斗限制检查。

字段：

• enableBattleCheck
• cancelBattle
• enablePokemonCheck
• bannedPokemonList
• enableItemCheck
• bannedItemsList
• enableMoveCheck
• bannedMovesList

说明：

• enableBattleCheck是总开关。
• cancelBattle用于控制检测到禁用内容时是否取消战斗。
• bannedPokemonList使用宝可梦种类 ID。
• bannedItemsList使用物品 ID。
• bannedMovesList使用招式 ID。

boss-capture.toml

用途：

控制是否可以捕捉 Boss 宝可梦。

字段：

• preventBossCapture
• showCaptureMessage

说明：

• 通常应保持启用preventBossCapture。
• showCaptureMessage用于控制捕捉被阻止时是否向玩家显示提示信息。

boss-immune.toml

用途：

控制 Boss 实体在世界中是否无敌。

字段：

• enableBossImmune

重要说明：

此设置主要用于保护 Boss 实体免受正常战斗伤害以外的伤害。

这并不意味着 Boss 在战斗中免疫所有招式。

说明：

• 建议保持启用。
• 有助于防止玩家通过非战斗方式击杀 Boss。

boss-music.toml

用途：

控制 Boss 战斗音乐。

字段：

• enableBossBattleMusic
• stopOnBattleEnd

重要说明：

音乐系统不再使用bossBattleMusicSoundId。

Boss 战斗开始时，模组会从以下位置随机选择一个音乐声音事件：

1. 模组内置的assets/cobbleboss/sounds.json。
2. 在sounds.json中定义了音乐的已启用资源包。

仅放在resourcepacks文件夹中、但未在客户端资源包菜单中启用的资源包将被忽略。

说明：

• 默认内置声音事件为cobbleboss:boss_battle_theme。
• 自定义音乐必须由资源包提供。
• 音频文件应为 OGG 格式。
• 玩家需要启用资源包才能听到资源包提供的音乐。
• 旧配置中如果包含bossBattleMusicSoundId，应重新生成配置或清理该项。

boss-shield.toml

用途：

控制全局 Boss 护盾系统。

字段：

• enableBossShield
• superEffectiveLayers
• moveLayerOverrides

含义：

• enableBossShield：启用或禁用 Boss 护盾机制。
• superEffectiveLayers：被效果拔群的伤害招式消耗的护盾层数。
• moveLayerOverrides：特殊的招式与护盾层数规则。

说明：

• 如果enableBossShield为 false，Boss JSON 中的护盾字段将不起作用。
• moveLayerOverrides使用招式 ID 和护盾层数值。

player-level-limit.toml

用途：

控制玩家宝可梦的等级上限。

字段：

• enableLevelLimit
• maxPlayerPokemonLevel

说明：

• enableLevelLimit用于启用玩家宝可梦等级上限。
• maxPlayerPokemonLevel用于设置玩家宝可梦允许达到的最高等级。

13. 资源包音乐

可以通过资源包自定义 Boss 战斗音乐。

工作原理：

• 该模组在 assets/cobbleboss/sounds.json 中内置了音乐。
• 已启用的资源包可以添加更多音乐事件。
• Boss 战斗开始时，模组会随机选择一个可用的音乐事件。
• 无需在配置中指定单个音效 ID。

资源包路径：

pack.mcmeta
assets/cobbleboss/sounds.json
assets/cobbleboss/sounds/music/

结构示例：

my_boss_music_pack.zip
pack.mcmeta
assets/cobbleboss/sounds.json
assets/cobbleboss/sounds/music/boss_1.ogg
assets/cobbleboss/sounds/music/boss_2.ogg
assets/cobbleboss/sounds/music/boss_3.ogg

sounds.json 示例：

{
  "music.boss_1": {
    "category": "music",
    "sounds": [
      {
        "name": "cobbleboss:music/boss_1",
        "stream": true
      }
    ]
  },
  "music.boss_2": {
    "category": "music",
    "sounds": [
      {
        "name": "cobbleboss:music/boss_2",
        "stream": true
      }
    ]
  }
}

对应文件：

assets/cobbleboss/sounds/music/boss_1.ogg
assets/cobbleboss/sounds/music/boss_2.ogg

音效 ID 示例：

• assets/cobbleboss/sounds.json 中的 music.boss_1 会变为 cobbleboss:music.boss_1。
• assets/cobbleboss/sounds.json 中的 music.boss_2 会变为 cobbleboss:music.boss_2。

音乐检测：

符合以下任一条件时，模组会将该音效事件视为 Boss 音乐：

• 事件键以 music 开头。
• 事件键包含 .music。
• 事件具有 "category": "music"。
• 其中一个音效文件路径位于 music/ 文件夹内。

注意事项：

• 请使用 OGG 格式。
• 音乐请使用 stream: true。
• 玩家需要启用资源包才能听到自定义音乐。
• 请仅使用原创或已获授权的音乐。
• 如果未启用资源包，客户端将不会注册其中的音效事件。

14. 固定生成点命令

主命令：

/spawnpokemonbossat

权限：

需要管理员权限。

功能：

• create
• addboss
• removeboss
• setweight
• remove
• list
• info
• trigger
• settext
• cleartext
• announcement enable
• announcement text
• announcement color
• announcement clear

create

用途：

创建一个固定 Boss 生成点。

参数：

• 生成点 ID
• 维度
• X 坐标
• Y 坐标
• Z 坐标
• Boss 等级
• 重生间隔秒数
• 可选的全息文字

注意事项：

• 生成点 ID 必须唯一。
• 重生时间以秒为单位。
• Boss 等级范围为 1 到 900。

addboss

用途：

将 Boss 添加到固定生成点的候选池中。

参数：

• 生成点 ID
• Boss 唯一 ID
• 权重

注意事项：

• Boss 唯一 ID 必须存在于已加载的 Boss 数据中。
• 权重越高，该 Boss 在此固定生成点出现的概率越大。

removeboss

用途：

从固定生成点的候选池中移除 Boss。

setweight

用途：

更改固定生成点候选池中某个 Boss 的权重。

remove

用途：

删除固定生成点。

注意事项：

• 移除生成点数据。
• 移除相关的全息显示。
• 处理当前激活的固定 Boss。

list

用途：

列出所有固定生成点。

显示内容：

• 生成点 ID
• 维度
• 坐标
• Boss 等级
• 重生时间
• Boss 池
• 当前激活的 Boss

info

用途：

显示单个生成点的详细信息。

显示内容：

• 维度
• 坐标
• Boss 等级
• 重生时间
• 下次重生刻
• 当前激活的 Boss
• 全息文本
• Boss 池
• 公告状态
• 公告文本
• 公告颜色

trigger

用途：

手动将生成点设为可再次生成状态。

备注：

• 适用于测试。
• 不会删除生成点。

settext

用途：

设置固定生成点的全息文本。

支持的占位符：

• {id}
• {level}
• {time}
• {x}
• {y}
• {z}
• {dimension}
• {boss_count}
• {boss_pool}
• {active_boss_id}
• {active_boss}
• {active_weight}

备注：

• 使用 | 分隔多行全息文本。
• 全息占位符与公告占位符不同。

cleartext

用途：

清除自定义全息文本并恢复默认的全息显示行为。

announcement enable

用途：

启用或禁用固定生成点公告。

工作方式：

• true 启用公告。
• false 禁用公告。

备注：

• 没有单独的禁用公告命令。
• 使用 announcement enable 并指定 true 或 false。

announcement text

用途：

设置自定义公告文本。

支持的占位符：

• {boss}
• {boss_id}
• {species}
• {point}
• {dimension}
• {x}
• {y}
• {z}
• {position}

announcement color

用途：

设置公告消息的颜色。

可用颜色：

• black
• dark_blue
• dark_green
• dark_aqua
• dark_red
• dark_purple
• gold
• gray
• dark_gray
• blue
• green
• aqua
• red
• light_purple
• yellow
• white

备注：

• 默认颜色为 gold。
• 此设置更改公告颜色，不会更改 Boss 的发光颜色。

announcement clear

用途：

恢复默认公告文本。

备注：

• 不会移除生成点。
• 不会清除全息文本。
• 仅重置固定生成点公告模板。

固定生成 Boss 池权重

用途：

控制同一个固定生成点内的选择概率。

规则：

• 最小权重：1
• 最大权重：1000000

备注：

• 此权重独立于自然 spawn_rule.spawn_weight。
• 权重越高，在该固定生成点的 Boss 池中被选中的概率越大。

15. 基础 Boss 命令

checkpokemonboss

用途：

检查哪些 Boss 可以在玩家当前位置生成。

显示：

• 距离下次 Boss 刷新的时间
• 符合条件的 Boss
• Boss 显示名称
• 生成权重

权限：

通常普通玩家即可使用。

spawnpokemonboss

用途：

在玩家附近直接生成一个 Boss。

参数：

• Boss 唯一 ID
• 可选等级

权限：

需要管理员权限。

说明：

• 使用 Boss 唯一 ID，而不是宝可梦种类 ID。
• 等级范围为 1 至 900。
• 可用于测试 Boss 配置。

spawnpokemonbossat

用途：

管理固定的 Boss 生成点。

权限：

需要管理员权限。

16. 新手设置建议

最简单的设置方式：

• 启用自然生成 Boss。
• 设置合理的生成间隔。
• 初期使用较低的生成概率。
• 启用 Boss 捕获限制。
• 启用 Boss 免疫效果。
• 使用等级映射或等级倍率。
• 设置合理概率的奖励。
• 为 Boss 添加发光效果，方便寻找。
• 除非想要巨型 Boss，否则将缩放比例留空。

限制较严格的 Boss 服务器：

• 启用战斗检查。
• 按需禁用特定宝可梦。
• 按需禁用特定物品。
• 按需禁用特定招式。
• 通过 custom_battle_stats 提高 Boss 属性。
• 谨慎使用 actions_per_turn。
• 为团队副本式战斗添加护盾设置。

休闲服务器：

• 将惩罚设为较低，或直接禁用。
• 为 Boss 设置明显的发光效果。
• 使用适中的 Boss 体型。
• 设置必定掉落的小奖励，以及稀有的特殊奖励。
• 使用奖励池实现“从该组中随机获得一件物品”的奖励。
• 避免将 actions_per_turn 设得过高。

17. 常见问题

Boss 未能加载

可能原因：

• unique_id 重复。
• species_id 无效。
• 招式名称无效。
• 特性名称无效。
• 物品 ID 无效。
• 发光颜色无效。
• 缩放值无效。
• JSON 格式有误。
• reward_pools.entries 为空。
• 奖励池的 rolls 无效。
• 奖励池条目的 weight 无效。

Boss 不会自然生成

可能原因：

• 自然生成已禁用。
• 生成概率过低。
• 生成间隔尚未结束。
• 当前生物群系不符合条件。
• 当前结构不符合条件。
• 当前时间不符合条件。
• 当前位置类型不符合条件。
• 缺少 spawn_weight，或其值过低。
• Boss 文件尚未加载。

Boss 音乐不播放

可能原因：

• Boss 音乐配置已禁用。
• 所选音效事件未在客户端注册。
• 资源包未启用。
• 音效文件路径错误。
• 音效文件不是 OGG 格式。
• 客户端未安装该资源包。
• 资源包已放入文件夹，但尚未移至已启用列表。
• 音乐音量已静音。

重要提示：

该模组会从内置音乐和已启用的资源包中随机选择音乐。

不会使用 bossBattleMusicSoundId。

Boss 护盾无效

可能原因：

• 全局 Boss 护盾配置已禁用。
• shield_layers 为 0 或缺失。
• 所用招式不会消耗护盾层数。
• superEffectiveLayers 被设为 0。
• 该招式并非效果拔群。
• 该招式未列入 moveLayerOverrides。
• Boss 使用旧版或过时数据生成。

Boss 体型过小或过大

可能的原因：

• scale 设置得过低或过高。
• Boss 等级会导致自动计算体型。
• 模组会将体型限制在允许范围内。

Boss 没有发光

可能的原因：

• 未设置 glow。
• 发光颜色无效。
• Boss 是根据旧数据生成的。
• 其他系统移除了发光效果。

公告颜色没有变化

可能的原因：

• 颜色名称无效。
• 使用了错误的生成点 ID。
• 公告功能已禁用。
• 检查的消息不是固定生成公告。

旧版 NeoForge 配置无法使用

可能的原因：

• 该配置文件是在统一配置字段推出前生成的。
• 仍存在旧的分组 TOML 配置节。
• 仍存在旧的盾牌 snake_case 字段。
• 仍存在旧字段 bossBattleMusicSoundId。

解决方法：

• 删除旧配置文件，让模组重新生成。
• 或者将旧值移至新的顶层字段。
• 移除旧的音乐音效 ID 配置。

18. 总结

CobbleBoss 配置可以这样理解：

• 使用 unique_id、species_id、display_name 和 glow 定义 Boss 的身份和外观。
• 使用 spawn_rule 定义 Boss 出现的地点和时间。
• 使用 reward_rule 和 punish_rule 定义胜利和失败后的结果。
• 使用 reward_items 进行独立的奖励抽取。
• 使用 reward_pools 实现“先抽取一次，再从列表中选择一项奖励”。
• 使用 random_configs 定义属性、招式、对战模式、行动次数、护盾、阶段技能、持有物品、形态、特性、闪光状态和体型。
• 使用配置文件控制全局 Boss 行为。
• 使用资源包添加随机 Boss 对战音乐。
• 使用固定生成点命令创建可控的 Boss 生成地点。

19. 付费功能：多人组队 Boss 对战

这是一项高级付费功能。

数据包路径：

data/cobbleboss/boss_teams/

Boss 队伍文件用于定义群体 Boss 对战。

字段：

• team_id
• pokemon_unique_ids
• spawn_structures
• defeat_rewards
• punish_rule

team_id

用途：

Boss 队伍的唯一 ID。

注意：

• 如果未填写命名空间，则使用 cobbleboss。
• 命令可以使用此 ID。

pokemon_unique_ids

用途：

此队伍所使用的 Boss 宝可梦唯一 ID。

注意：

• 这些 ID 必须与普通 Boss JSON 中的 unique_id 值一致。
• 队伍系统会根据已有的 Boss 定义创建 Boss 宝可梦。

spawn_structures

用途：

控制哪些结构可以触发此 Boss 队伍。

注意：

• 使用结构 ID。
• 玩家身处匹配的结构内并派出宝可梦时，可以触发队伍对战。
• 系统会记录结构实例，避免同一结构被反复触发。

defeat_rewards

用途：

击败 Boss 队伍后获得的奖励。

字段：

• reward_items
• reward_pools
• item_id
• count
• command
• chance
• rolls
• weight

工作原理：

• reward_items 作为独立的奖励抽取项。
• reward_pools 抽取一次，然后从池中随机选择条目。
• 团队奖励池使用与普通 Boss 奖励池相同的格式。

概率说明：

如果 chance 大于 0，则使用该自定义概率。

如果 chance 缺失或为 0，则可以使用默认奖励概率。

示例：

"defeat_rewards": {
  "reward_items": [
    {
      "item_id": "minecraft:gold_ingot",
      "count": 4,
      "chance": 1.0
    }
  ],
  "reward_pools": [
    {
      "chance": 0.1,
      "rolls": 1,
      "entries": [
        {
          "item_id": "cobblemon:poke_ball",
          "count": 3
        },
        {
          "item_id": "cobblemon:great_ball",
          "count": 2
        },
        {
          "item_id": "cobblemon:ultra_ball",
          "count": 1
        }
      ]
    }
  ]
}

punish_rule

用途：

输给 Boss 队伍后的惩罚。

字段：

• punish_items
• level
• evs
• ivs
• command
• chance

概率说明：

如果 chance 大于 0，则使用该自定义概率。

如果 chance 缺失或为 0，则可以使用默认惩罚概率。

spawnpokemonbossteam

用途：

为玩家手动开始一场 Boss 队伍战斗。

命令含义：

/spawnpokemonbossteam <player> <bossTeamId>

权限：

需要管理员权限。

注意：

• bossTeamId 可以带命名空间，也可以不带。
• 如果未写命名空间，则使用 cobbleboss。
• 此命令主要用于测试和管理员控制的事件。

多人团队战斗行为

工作方式：

• 系统会扫描附近的有效玩家。
• 附近玩家必须尚未处于战斗中。
• 旁观者和已移除的玩家会被忽略。
• 当前团队战斗系统设计为最多支持 2 名玩家。
• 当前 Boss 团队战斗系统最多使用 2 只 Boss 宝可梦。
• 当玩家和 Boss 数量足够时，会形成 2v2 突袭式战斗。
• 如果未满足多人条件，可以回退为单人团队 Boss 战斗。

注意：

• 此功能最好在普通 Boss 配置之后说明。
• 它面向希望获得突袭式玩法的服务器。
• Boss 属性、奖励、护盾和 actions_per_turn 应针对团队战斗仔细平衡。