Cobblemon Auto Battle (SV styled) [NeoForge]

作者：P1nero

为 Cobblemon 添加类似《宝可梦朱／紫》中“Let's Go”的自动战斗功能。派出宝可梦后，它们会自行搜寻并狩猎附近的野生宝可梦——使用真实招式进行战斗，并提供稀有保护、瞄准狩猎、经验值／努力值／掉落奖励。适合大量出现事件。

模组 NeoForge 实用附属

介绍

介绍由机器翻译自 CurseForge 原页面，仅供参考。

Fabric 版本：https://www.curseforge.com/minecraft/mc-mods/cobblemon-auto-battle-sv-styled

Cobblemon Auto-Battle

本仓库是 viniciusmorenorogato-crypto/CobblemonAutoBattle v1.4.0 的 NeoForge 1.21.1 移植版。原作者署名和 MIT 版权声明均予以保留。

为 Cobblemon 带来《宝可梦朱／紫》“Let’s Go”风格的自动对战。

放出你的宝可梦，按下按键，看它们自行狩猎附近的野生宝可梦——为你赚取经验值、努力值和物品掉落，就像《宝可梦朱／紫》中的 Let’s Go 机制一样。你也可以瞄准某只特定的野生宝可梦，让伙伴去追击它。

功能

一键自动对战 — 按 R（可重新绑定按键）即可切换。如果当前没有放出宝可梦，会自动放出队首的宝可梦。
指定狩猎 — 瞄准一只野生宝可梦并按下 V（可重新绑定按键）：最近的猎手会去追击它。即使关闭自动对战也有效——队首宝可梦会自行出场、完成任务，然后返回精灵球。
多猎手 — 你放出的所有宝可梦都会同时狩猎，并各自选择目标（不会有多个猎手围攻同一只野生宝可梦）。
朱／紫风格的单击对战 — 每场对战通过一记编排好的攻击结算：攻击动画蓄势 → 同步命中 → 被击败的野生宝可梦播放真实的 faint 动画并发出叫声，随后消失。
招式配置确实重要 — 双方都会选择自己最强的实际招式（真实威力、属性和物理／特殊类别、真实属性一致加成及完整属性克制表）。速度决定谁先出手，而免疫类特性（飘浮、引火、蓄水／蓄电、食草等）会使对应属性的招式无效。
你也可能落败 — 如果模拟结果显示野生宝可梦会先击倒你的宝可梦，你就会输掉这回合：野生宝可梦会反击，你的宝可梦会受伤撤退，而野生宝可梦则会存活。招式配置中的属性覆盖因此变得十分重要（可配置）。
稀有宝可梦保护 — 闪光宝可梦、传说宝可梦、幻之宝可梦、究极异兽、悖谬宝可梦（以及你配置的任何自定义标签／种类）绝不会遭到攻击。系统会通过聊天提示和铃声音效提醒你，稀有宝可梦还会发光几秒，方便你找到它。
胜利反馈 — 你独自可听见的简短三音提示音（朱／紫风格）、被击败宝可梦的叫声，以及音调各异的轻微命中音效。
轻松节奏 — 每次获胜后，猎手会在原地休息几秒，而不是立刻冲向下一个目标。
智能导航 — 搜索目标时以玩家为中心（可配置），并设有牵引范围，让游荡的猎手返回身边（落后太远时会将其传送回来）；路径会稳定地重新计算，防卡住系统也会放弃无法到达的目标。
真实模型动画 — 攻击者会播放其模型对应的 physical/special 动画；所有动画均使用 Cobblemon 自带的可摆姿势动画系统。
公平选取目标 — 只会攻击等级不高于你的宝可梦等级加上可配置差值的野生宝可梦；生命值较低的猎手会撤退（自动对战不会让它们濒死）。
奖励 — 获胜者获得经验值和努力值（按宝可梦种类的正确努力值收益计算）；物品掉落会直接进入你的物品栏。
完全可配置并支持本地化 — 提供 30 多项选项，位于 config/autobattle.json，可在游戏中热重载。支持英语和巴西葡萄牙语；欢迎贡献翻译！

运行要求

依赖项	版本
Minecraft	1.21.1
NeoForge	≥ 21.1
Kotlin for Forge	≥ 5.12.0
Cobblemon	≥ 1.7.3 < 1.8.0

请安装在客户端（按键绑定需要）。在服务器上使用时，客户端和服务端都需要安装。

用法

按键（可重新绑定）	操作
R	切换区域自动战斗。已派出的宝可梦会在你附近搜寻符合条件的野生宝可梦；再次按下即可停止（由模组派出的宝可梦会被召回）。
V	指定目标狩猎。瞄准一只野生宝可梦（最多 32 格）并按下按键：最近的猎手会追击它。关闭自动战斗时，这是一项单次任务——完成后，你的首位宝可梦会自行返回。

猎手 HP 较低时会撤退并暂停行动，直到被召回并再次派出。发现稀有或受保护的宝可梦时只会发出通知，不会攻击——区域模式和直接瞄准时均如此。

命令（权限等级 2）

命令	效果
`/autobattle info`	显示当前配置
`/autobattle reload`	无需重启即可重新加载`config/autobattle.json`

配置

config/autobattle.json首次启动时会创建配置；更新后若有字段缺失，也会自动修复。

目标搜寻与导航

字段	默认值	说明
`enabled`	`true`	总开关
`anchorToPlayer`	`true`	在玩家周围搜寻目标（SV 风格）；`false`则以每个猎手为中心搜寻（自由漫游）
`searchRadius`	`28.0`	以锚点为中心搜寻目标的半径（格）
`leashRadius`	`40.0`	猎手离你超过此距离时会放弃目标并返回；超过其 1.5 倍时会传送到你身边
`attackRange`	`2.5`	攻击开始时，双方碰撞箱边缘之间的间隔（会自动将双方宝可梦的体型计入计算）
`moveSpeed`	`1.3`	追击速度倍率
`followPlayerRadius`	`8.0`	闲置猎手在距离你超过此距离时会跟随你
`repathIntervalTicks`	`10`	重新计算寻路路线的间隔（刻；用于防止移动抖动）
`stuckTimeoutTicks`	`60`	追踪目标期间超过此时长仍无进展 → 放弃目标
`levelMargin`	`5`	符合条件的野生宝可梦距离不超过`hunter level + margin`
`directedHuntRange`	`32.0`	按下 V 键时的最大瞄准距离

稀有宝可梦保护

字段	默认值	说明
`protectRareTargets`	`true`	稀有保护总开关
`protectShiny`	`true`	绝不攻击闪光宝可梦
`protectedLabels`	`legendary, mythical, ultra_beast, paradox`	受保护的种类标签（其他模组的标签也可使用）
`protectedSpecies`	`[]`	按名称额外保护的种类
`rareGlowSeconds`	`10`	发现稀有宝可梦时显示发光轮廓（0 表示禁用）
`rareFoundSound`	`true`	发现稀有宝可梦时响起警报铃声

战斗

字段	默认值	描述
`attackWindupTicks`	`8`	从攻击动画到命中之间的延迟
`attackIntervalTicks`	`30`	两场战斗之间的最小刻数
`restAfterBattleTicks`	`60`	每次获胜后，猎人会静止这么长时间（3秒）
`retreatHealthPercent`	`0.2`	HP 比例降至此值时撤退
`retaliationMultiplier`	`0.5`	猎人承受的战斗消耗伤害倍率
`allowDefeat`	`true`	属性不利时可能输掉战斗（猎人撤退，野生宝可梦存活）
`abilityImmunities`	`true`	飘浮、引火、水/电气吸收等特性会使对应属性的招式无效
`damageScale`	`1.0`	全局伤害倍率
`randomizeDamage`	`true`	应用经典的 85–100% 伤害随机浮动

效果、音效与奖励

字段	默认值	描述
`battleEffects`	`true`	模型动画、粒子效果、击退和音效
`faintAnimationTicks`	`40`	被击败的野生宝可梦倒地后、消失前的持续时间
`victoryJingle`	`true`	三音胜利提示音（只有你能听见）
`defeatCry`	`true`	宝可梦被击败倒下时发出叫声
`hitSoundVolume`	`0.35`	命中音效音量（设为 0 可禁用）
`awardXp` / `xpMultiplier`	`true` / `1.0`	经验奖励
`awardEvs`	`true`	努力值奖励（根据宝可梦种类的努力值收益）
`awardDrops`	`true`	将野生宝可梦的掉落物送入你的物品栏
`announceRewards`	`true`	每次获胜后发送聊天消息

工作原理（技术细节）

服务端大脑运行于 NeoForge 的 ServerTickEvent.Post；客户端只负责注册按键绑定并发送切换/狩猎数据包。定向狩猎由服务端进行射线检测（不信任客户端提供的实体 ID）。
战斗通过一次攻击结算：轻量级模拟会为双方选出最强的实际招式（威力/属性/类别取自真实招式配置，并考虑真实 STAB、完整属性相性表和特性免疫），再根据速度判定谁先出手，并计算战斗需要多少个“回合”——按比例扣减猎人的 HP，或者在野生宝可梦会先获胜时判定猎人落败。不会实例化真实的 PokemonBattle，因此同时有数十名猎人时依然开销很低。
动画复用 Cobblemon 的可姿势化动画数据包——官方战斗中 recoil 使用的也是同一机制——并在失败时播放宝可梦种类对应的真实 faint 动画和叫声。
奖励通过 Cobblemon 自带的 API（addExperienceWithPlayer、努力值收益和宝可梦种类掉落表）发放，并使用带有附加模组标记的来源，因此其他模组的事件钩子也能正常工作。
稀有宝可梦检测使用 Cobblemon 官方的种类标签，因此数据包和其他模组为宝可梦种类添加标签时也会自动受到保护。