最近在尝试用 Python 实现一个简单的宝可梦对战模拟器本以为掌握了面向对象和基础逻辑就能轻松拿捏结果在实现技能伤害计算、状态异常和战斗流程时被各种边界条件和逻辑分支“暴揍”了好几轮。网上很多教程只讲概念缺一个能从头跑到尾、代码清晰、还能自己扩展的完整案例。本文将分享如何从零构建一个可运行、可扩展的宝可梦对战模拟器。我们会从核心的宝可梦和技能类设计开始逐步实现属性克制、伤害计算、状态异常灼伤、麻痹等以及完整的对战回合流程。最后还会提供一个带简单文本界面的可运行版本。无论你是想学习 Python 面向对象设计还是对游戏逻辑实现感兴趣都能从这篇实战指南中获得可以直接复用的代码和清晰的实现思路。1. 核心概念与设计目标在开始写代码之前我们需要明确这个模拟器要模拟哪些核心机制这决定了我们的类如何设计。什么是宝可梦对战模拟器它本质上是一个基于规则的状态机模拟宝可梦系列游戏中回合制对战的核心逻辑。主要包括以下几个部分实体宝可梦具有生命值HP、攻击、防御、速度等属性以及所属的属性类型如“火”、“水”、“草”。行为技能宝可梦可以使用的招式具有威力、命中率、属性类型并可能附带特殊效果如造成异常状态。交互规则属性克制不同属性之间存在克制关系影响伤害倍数。伤害计算一个简化的公式综合攻击方攻击力、防御方防御力、技能威力和属性克制等因素。状态异常如“灼伤”每回合损失HP且攻击力减半、“麻痹”可能无法行动且速度降低等影响宝可梦的能力和行动。流程控制决定行动顺序通常基于速度、处理回合开始/结束的状态效果如灼伤扣血、判断胜负条件。我们的设计目标模块化将宝可梦、技能、战斗引擎分离便于独立修改和扩展。数据驱动将宝可梦数据、技能数据、属性克制表等定义为易于修改的数据结构如字典而不是硬编码在逻辑里。可运行最终产出一个可以通过命令行交互的简单对战程序。可扩展预留接口方便后续添加更复杂的特性如特性、道具、天气等。2. 环境准备与项目结构本项目只需要标准的 Python 3.6 及以上环境无需安装任何第三方库。我们将使用纯 Python 实现。建议环境操作系统Windows 10/11, macOS, 或 Linux 均可。Python 版本3.6确保支持 f-string 和类型提示的基本语法。开发工具任何你喜欢的文本编辑器或 IDE如 VS Code, PyCharm。项目目录结构 在开始前我们先规划好文件结构这有助于保持代码清晰。pokemon_battle_simulator/ │ ├── main.py # 程序主入口运行对战 ├── pokemon.py # 宝可梦类定义 ├── move.py # 技能类定义 ├── battle_engine.py # 战斗引擎类处理核心逻辑 ├── data.py # 存放宝可梦、技能、属性克制等静态数据 └── README.md # 项目说明可选接下来我们将从最底层的数据和类开始构建。3. 核心类设计与实现3.1 定义技能类 (Move)技能是战斗中最基本的操作单元。我们先在move.py中定义Move类。# move.py class Move: 技能招式类 def __init__(self, name: str, move_type: str, power: int, accuracy: int, max_pp: int, effectNone): 初始化一个技能。 :param name: 技能名称 :param move_type: 技能属性如 ‘fire‘, ‘water‘ :param power: 技能威力 :param accuracy: 技能命中率0-100 :param max_pp: 技能最大使用次数 :param effect: 技能特殊效果函数默认为None self.name name self.type move_type self.power power self.accuracy accuracy self.max_pp max_pp self.current_pp max_pp # 当前剩余PP self.effect effect # 一个可调用对象用于施加异常状态等 def use(self, attacker, defender): 使用技能。主要逻辑扣除PP判断命中计算伤害应用效果。 :param attacker: 攻击方宝可梦对象 :param defender: 防御方宝可梦对象 :return: (是否命中, 造成的伤害, 效果信息) if self.current_pp 0: print(f{self.name} 的PP耗尽了) return False, 0, PP不足 self.current_pp - 1 # 命中判定 import random if random.randint(1, 100) self.accuracy: print(f{attacker.name} 使用了 {self.name} ... 但是没有命中) return False, 0, 未命中 # 伤害计算 (将在BattleEngine中详细实现这里先返回一个占位值) # damage calculate_damage(attacker, defender, self) # 为保持类职责清晰伤害计算放在战斗引擎中 damage 0 effect_msg # 如果技能有特殊效果则尝试应用 if self.effect: effect_msg self.effect(defender) print(f{attacker.name} 使用了 {self.name}) return True, damage, effect_msg def __str__(self): return f{self.name} ({self.type}) PP: {self.current_pp}/{self.max_pp}关键点说明effect参数是一个函数或可调用对象它接收defender作为参数并返回一个描述效果信息的字符串。这种设计将技能效果与技能本身解耦非常灵活。use方法返回一个元组包含命中状态、伤害值和效果信息方便战斗引擎处理后续逻辑。目前damage计算为0我们将在战斗引擎中实现具体的公式。3.2 定义宝可梦类 (Pokemon)宝可梦是对战的主体。我们在pokemon.py中定义Pokemon类。# pokemon.py class Pokemon: 宝可梦类 def __init__(self, name: str, pokemon_type: str, level: int, max_hp: int, attack: int, defense: int, speed: int, moves: list): 初始化一只宝可梦。 :param name: 宝可梦名称 :param pokemon_type: 宝可梦属性如 ‘fire‘ :param level: 等级 :param max_hp: 最大生命值 :param attack: 攻击力 :param defense: 防御力 :param speed: 速度 :param moves: 技能列表Move对象列表 self.name name self.type pokemon_type self.level level self.max_hp max_hp self.current_hp max_hp self.attack attack self.defense defense self.speed speed self.moves moves # 技能列表 self.status None # 当前状态异常如 ‘burn‘, ‘paralysis‘ self.status_turns 0 # 异常状态持续回合数 def take_damage(self, damage: int): 承受伤害 self.current_hp - damage if self.current_hp 0: self.current_hp 0 print(f{self.name} 受到了 {damage} 点伤害剩余HP: {self.current_hp}/{self.max_hp}) def is_fainted(self): 判断是否失去战斗能力 return self.current_hp 0 def apply_status_effect(self, status: str): 施加状态异常 if self.status is None: # 简化不能叠加状态 self.status status self.status_turns 0 status_names {burn: 灼伤, paralysis: 麻痹} print(f{self.name} {status_names.get(status, status)}了) return True return False def on_turn_end(self): 回合结束时触发例如状态异常的效果 if self.status burn: # 灼伤每回合损失最大HP的1/16并攻击减半在伤害计算时处理 burn_damage self.max_hp // 16 self.current_hp - burn_damage print(f{self.name} 因灼伤损失了 {burn_damage} HP) if self.current_hp 0: self.current_hp 0 # 麻痹、中毒等效果可以在这里扩展 self.status_turns 1 def __str__(self): status_str f [{self.status}] if self.status else return f{self.name} (Lv.{self.level} {self.type}) HP: {self.current_hp}/{self.max_hp}{status_str}关键点说明status字段记录当前异常状态我们使用简单的字符串标识如‘burn‘。on_turn_end方法在每个回合结束时被战斗引擎调用用于处理状态异常的持续效果如灼伤扣血。apply_status_effect方法用于在战斗中附加新的状态。3.3 实现战斗引擎 (BattleEngine)战斗引擎是模拟器的大脑负责协调所有规则。我们在battle_engine.py中实现。首先我们需要定义属性克制关系。这是一个典型的“数据”我们将其放在引擎内部但更好的做法是放在data.py这里为了流程清晰先写在引擎里。# battle_engine.py import random class BattleEngine: 战斗引擎处理对战的核心逻辑 # 简化版属性克制表 (攻击属性 - 防御属性 - 倍数) TYPE_CHART { fire: {grass: 2.0, fire: 0.5, water: 0.5}, water: {fire: 2.0, water: 0.5, grass: 0.5}, grass: {water: 2.0, grass: 0.5, fire: 0.5}, electric: {water: 2.0, electric: 0.5, grass: 0.5}, normal: {} # 普通系没有克制 } staticmethod def calculate_type_multiplier(attack_type: str, defend_type: str) - float: 计算属性克制倍数 return BattleEngine.TYPE_CHART.get(attack_type, {}).get(defend_type, 1.0) staticmethod def calculate_damage(attacker, defender, move): 简化版伤害计算公式 (基于第二代/第三世代的公式) # 基础伤害 ((2 * 等级 / 5 2) * 威力 * (攻击/防御)) / 50 2 level_factor (2 * attacker.level / 5) 2 attack_def_ratio attacker.attack / defender.defense base_damage (level_factor * move.power * attack_def_ratio) / 50 2 # 属性克制倍数 type_multiplier BattleEngine.calculate_type_multiplier(move.type, defender.type) # 随机因子 (0.85 ~ 1.00) random_factor random.uniform(0.85, 1.0) # 状态修正 (例如灼伤攻击减半) status_multiplier 1.0 if attacker.status burn: status_multiplier 0.5 # 注意宝可梦官方设定中灼伤时物理招式伤害减半特殊招式不减。 # 我们这里简化处理所有攻击都减半。 final_damage int(base_damage * type_multiplier * random_factor * status_multiplier) # 确保至少造成1点伤害除非免疫这里简化 if final_damage 1 and type_multiplier 0: final_damage 1 # 打印克制信息 if type_multiplier 1: print(效果拔群) elif type_multiplier 1: print(效果不理想...) return final_damage def execute_turn(self, pokemon1, pokemon2, move1, move2): 执行一个回合。 规则速度快的先行动。如果选择技能为None可能PP不足则跳过。 :return: (胜利者Pokemon对象, 如果未分出胜负则为None) # 决定行动顺序 first, second, first_move, second_move (pokemon1, pokemon2, move1, move2) if pokemon2.speed pokemon1.speed: first, second, first_move, second_move (pokemon2, pokemon1, move2, move1) elif pokemon2.speed pokemon1.speed: # 速度相同随机决定 if random.choice([True, False]): first, second, first_move, second_move (pokemon2, pokemon1, move2, move1) winner None # 第一只宝可梦行动 if first_move and not first.is_fainted(): hit, damage, effect_msg first_move.use(first, second) if hit: actual_damage self.calculate_damage(first, second, first_move) second.take_damage(actual_damage) if effect_msg: print(effect_msg) if second.is_fainted(): winner first return winner # 第二只宝可梦行动 if second_move and not second.is_fainted(): hit, damage, effect_msg second_move.use(second, first) if hit: actual_damage self.calculate_damage(second, first, second_move) first.take_damage(actual_damage) if effect_msg: print(effect_msg) if first.is_fainted(): winner second return winner # 回合结束处理状态效果 if not first.is_fainted(): first.on_turn_end() if not second.is_fainted(): second.on_turn_end() return winner # 本回合未决出胜负关键点说明TYPE_CHART定义了属性克制关系。这是一个嵌套字典方便查询。calculate_damage实现了简化的伤害公式。真实的宝可梦伤害公式更复杂涉及种族值、个体值、努力值等这里做了大量简化以突出核心逻辑。execute_turn这是引擎的核心方法。它处理行动顺序、技能使用、伤害计算、状态结算的完整流程。注意它需要接收双方宝可梦和它们本回合选择的技能。4. 数据定义与效果函数为了让我们的模拟器“活”起来需要定义一些具体的宝可梦和技能数据以及技能效果。4.1 在data.py中定义数据# data.py from move import Move from pokemon import Pokemon # ---------- 技能效果函数 ---------- def burn_effect(target): 灼伤效果 if target.apply_status_effect(burn): return f{target.name} 被灼伤了 return def paralysis_effect(target): 麻痹效果 if target.apply_status_effect(paralysis): return f{target.name} 麻痹了可能无法行动 return # ---------- 技能定义 ---------- # 火系技能 flamethrower Move(喷射火焰, fire, 90, 100, 15, effectburn_effect) ember Move(火花, fire, 40, 100, 25) # 水系技能 water_gun Move(水枪, water, 40, 100, 25) surf Move(冲浪, water, 90, 100, 15) # 草系技能 vine_whip Move(藤鞭, grass, 45, 100, 25) razor_leaf Move(飞叶快刀, grass, 55, 95, 25) # 电系技能 thunder_shock Move(电击, electric, 40, 100, 30) thunderbolt Move(十万伏特, electric, 90, 100, 15, effectparalysis_effect) # 普通系技能 tackle Move(撞击, normal, 40, 100, 35) quick_attack Move(电光一闪, normal, 40, 100, 30) # ---------- 宝可梦定义 ---------- # 创建宝可梦并分配技能 charizard Pokemon( name喷火龙, pokemon_typefire, level36, max_hp120, attack84, defense78, speed100, moves[flamethrower, ember, quick_attack, tackle] ) blastoise Pokemon( name水箭龟, pokemon_typewater, level36, max_hp118, attack83, defense100, speed78, moves[surf, water_gun, tackle, quick_attack] ) venusaur Pokemon( name妙蛙花, pokemon_typegrass, level36, max_hp120, attack82, defense83, speed80, moves[razor_leaf, vine_whip, tackle, quick_attack] ) pikachu Pokemon( name皮卡丘, pokemon_typeelectric, level30, max_hp90, attack55, defense40, speed90, moves[thunderbolt, thunder_shock, quick_attack, tackle] ) # 一个简单的宝可梦池方便随机选择 POKEMON_POOL [charizard, blastoise, venusaur, pikachu]关键点说明效果函数如burn_effect被定义为独立的函数然后在创建Move对象时通过effect参数传入。这使得技能效果可以灵活定制和复用。宝可梦的种族值HP、攻击等是随意设定的旨在平衡和体现差异性。真实数据可以从宝可梦百科获取。POKEMON_POOL列表方便我们随机选取对战双方。5. 完整实战构建可运行的对战模拟器现在我们将所有模块组合起来在main.py中创建一个简单的命令行对战程序。5.1 主程序逻辑 (main.py)# main.py import random from data import POKEMON_POOL from battle_engine import BattleEngine def choose_move(pokemon): 让玩家为宝可梦选择一个技能 print(f\n{pokemon.name} 的技能) for i, move in enumerate(pokemon.moves, 1): print(f {i}. {move}) while True: try: choice int(input(请选择技能编号 (1-4): )) if 1 choice 4: selected_move pokemon.moves[choice - 1] if selected_move.current_pp 0: return selected_move else: print(f{selected_move.name} 的PP已经用完了请选择其他技能。) else: print(请输入有效的编号 (1-4)。) except ValueError: print(请输入数字。) def main(): print( 宝可梦对战模拟器 ) print(随机选择对战双方...) # 随机选择两只不同的宝可梦 pokemon1, pokemon2 random.sample(POKEMON_POOL, 2) print(f\n对战开始) print(f{pokemon1} VS {pokemon2}) battle_engine BattleEngine() turn 1 # 对战主循环 while True: print(f\n----- 第 {turn} 回合 -----) print(pokemon1) print(pokemon2) # 玩家1选择技能 (这里简化未来可扩展为双人) print(f\n{pokemon1.name} 的行动) move1 choose_move(pokemon1) # 玩家2电脑随机选择技能 available_moves [m for m in pokemon2.moves if m.current_pp 0] if available_moves: move2 random.choice(available_moves) print(f{pokemon2.name} 选择了 {move2.name}。) else: move2 None print(f{pokemon2.name} 没有可用的技能了) # 执行本回合 winner battle_engine.execute_turn(pokemon1, pokemon2, move1, move2) # 检查胜负 if winner: print(f\n***** {winner.name} 获胜了 *****) break # 检查是否双方都无可用技能平局 p1_has_pp any(m.current_pp 0 for m in pokemon1.moves) p2_has_pp any(m.current_pp 0 for m in pokemon2.moves) if not p1_has_pp and not p2_has_pp: print(\n***** 双方技能PP全部耗尽平局 *****) break turn 1 print(\n对战结束) if __name__ __main__: main()5.2 运行你的模拟器确保所有文件 (main.py,pokemon.py,move.py,battle_engine.py,data.py) 在同一个目录下。在终端或命令行中进入该目录。运行命令python main.py预期运行示例 宝可梦对战模拟器 随机选择对战双方... 对战开始 喷火龙 (Lv.36 fire) HP: 120/120 VS 水箭龟 (Lv.36 water) HP: 118/118 ----- 第 1 回合 ----- 喷火龙 (Lv.36 fire) HP: 120/120 水箭龟 (Lv.36 water) HP: 118/118 喷火龙 的行动 喷火龙 的技能 1. 喷射火焰 (fire) PP: 15/15 2. 火花 (fire) PP: 25/25 3. 电光一闪 (normal) PP: 30/30 4. 撞击 (normal) PP: 35/35 请选择技能编号 (1-4): 1 水箭龟 选择了 冲浪。 喷火龙 使用了 喷射火焰 效果不理想... 水箭龟 受到了 18 点伤害剩余HP: 100/118 水箭龟 被灼伤了 水箭龟 使用了 冲浪 效果拔群 喷火龙 受到了 42 点伤害剩余HP: 78/120 水箭龟 因灼伤损失了 7 HP ... 后续回合6. 常见问题与排查思路在实现和运行过程中你可能会遇到以下问题问题现象可能原因解决思路导入错误ModuleNotFoundError文件不在同一目录或文件名拼写错误。检查所有.py文件是否位于同一文件夹。检查import语句中的模块名是否正确不含.py后缀。伤害计算为0或异常低1. 属性克制表 (TYPE_CHART) 未正确定义防御类型。2. 攻击/防御数值设置不合理如防御远高于攻击。3. 伤害公式中的除法导致结果为0Python整数除法。1. 检查TYPE_CHART确保攻击属性和防御属性的键都存在。2. 调整data.py中宝可梦的attack和defense值使其处于合理范围如几十到一百多。3. 确保公式中使用了浮点数除法/或者将level_factor等变量转换为float。状态效果没有触发1. 技能效果函数 (effect) 没有正确绑定。2. 效果函数内部逻辑错误没有成功调用apply_status_effect。3.BattleEngine.execute_turn中没有打印效果信息。1. 检查data.py中创建Move对象时effect参数是否传入了函数名如effectburn_effect而不是函数调用effectburn_effect()。2. 在效果函数中添加print语句调试看是否执行。3. 检查execute_turn方法中是否处理了effect_msg并打印。速度相同的宝可梦行动顺序固定execute_turn中速度相同时的处理逻辑有误或未实现随机。检查execute_turn方法中elif pokemon2.speed pokemon1.speed:分支确保使用了random.choice来随机决定先手。宝可梦HP降到负数take_damage方法中没有对current_hp进行下限保护。在take_damage方法中添加if self.current_hp 0: self.current_hp 0。选择技能时出现列表索引错误choose_move函数中用户输入的数字转换或范围判断有误。加强输入验证使用try...except捕获ValueError并确保choice-1在pokemon.moves列表的有效索引范围内。7. 最佳实践与扩展建议一个基础模拟器完成后可以考虑以下方向进行优化和扩展这能让你更深入地理解游戏逻辑和软件设计。7.1 代码结构与设计模式数据与逻辑分离将TYPE_CHART、宝可梦种族值、技能数据完全移出代码放到 JSON 或 YAML 配置文件中。这样无需修改代码就能创建新的宝可梦和技能。使用工厂模式创建PokemonFactory和MoveFactory类根据名称从数据文件中加载并创建对象。状态模式将“灼伤”、“麻痹”等状态抽象为Status类或使用状态模式而不是用简单的字符串和if-else判断。每个状态类实现on_turn_start,on_turn_end,modify_damage等方法使引擎代码更清晰。7.2 功能扩展更完整的属性克制系统实现完整的18种属性克制关系表。技能分类引入“物理”、“特殊”、“变化”技能分类。伤害计算时物理技能看攻击/防御特殊技能看特攻/特防。特性系统为Pokemon类添加ability字段并在战斗引擎的关键节点伤害计算、状态判定等检查特性效果。道具系统增加held_item字段并设计道具效果触发的时机。战斗场景引入“天气”如大晴天、下雨和“场地”效果影响特定属性的技能威力或状态。AI 对手为电脑对手实现更智能的技能选择策略例如根据克制关系、自身状态选择最优技能。图形界面使用Pygame或tkinter库为模拟器添加简单的图形界面显示精灵图和血条。7.3 工程化与健壮性单元测试为BattleEngine.calculate_damage,Pokemon.take_damage,Move.use等核心方法编写单元测试确保逻辑正确。日志系统替换print语句使用 Python 的logging模块记录战斗过程便于调试和复盘。输入验证在主循环和choose_move函数中对用户输入进行更严格的验证防止程序因意外输入而崩溃。异常处理在文件读取、数据加载等可能出错的地方添加try...except块提供友好的错误信息。通过这个项目你不仅实现了一个有趣的游戏模拟器更实践了面向对象设计、模块化编程和状态机逻辑。从被“暴揍”到逐步完善系统的过程正是软件开发能力提升的缩影。 
长河君 · 2026/8/9 22:55:12 · 阅读 1.2k Python实战：从零构建宝可梦对战模拟器，掌握面向对象与游戏逻辑设计
最近在尝试用 Python 实现一个简单的宝可梦对战模拟器本以为掌握了面向对象和基础逻辑就能轻松拿捏结果在实现技能伤害计算、状态异常和战斗流程时被各种边界条件和逻辑分支“暴揍”了好几轮。网上很多教程只讲概念缺一个能从头跑到尾、代码清晰、还能自己扩展的完整案例。本文将分享如何从零构建一个可运行、可扩展的宝可梦对战模拟器。我们会从核心的宝可梦和技能类设计开始逐步实现属性克制、伤害计算、状态异常灼伤、麻痹等以及完整的对战回合流程。最后还会提供一个带简单文本界面的可运行版本。无论你是想学习 Python 面向对象设计还是对游戏逻辑实现感兴趣都能从这篇实战指南中获得可以直接复用的代码和清晰的实现思路。1. 核心概念与设计目标在开始写代码之前我们需要明确这个模拟器要模拟哪些核心机制这决定了我们的类如何设计。什么是宝可梦对战模拟器它本质上是一个基于规则的状态机模拟宝可梦系列游戏中回合制对战的核心逻辑。主要包括以下几个部分实体宝可梦具有生命值HP、攻击、防御、速度等属性以及所属的属性类型如“火”、“水”、“草”。行为技能宝可梦可以使用的招式具有威力、命中率、属性类型并可能附带特殊效果如造成异常状态。交互规则属性克制不同属性之间存在克制关系影响伤害倍数。伤害计算一个简化的公式综合攻击方攻击力、防御方防御力、技能威力和属性克制等因素。状态异常如“灼伤”每回合损失HP且攻击力减半、“麻痹”可能无法行动且速度降低等影响宝可梦的能力和行动。流程控制决定行动顺序通常基于速度、处理回合开始/结束的状态效果如灼伤扣血、判断胜负条件。我们的设计目标模块化将宝可梦、技能、战斗引擎分离便于独立修改和扩展。数据驱动将宝可梦数据、技能数据、属性克制表等定义为易于修改的数据结构如字典而不是硬编码在逻辑里。可运行最终产出一个可以通过命令行交互的简单对战程序。可扩展预留接口方便后续添加更复杂的特性如特性、道具、天气等。2. 环境准备与项目结构本项目只需要标准的 Python 3.6 及以上环境无需安装任何第三方库。我们将使用纯 Python 实现。建议环境操作系统Windows 10/11, macOS, 或 Linux 均可。Python 版本3.6确保支持 f-string 和类型提示的基本语法。开发工具任何你喜欢的文本编辑器或 IDE如 VS Code, PyCharm。项目目录结构 在开始前我们先规划好文件结构这有助于保持代码清晰。pokemon_battle_simulator/ │ ├── main.py # 程序主入口运行对战 ├── pokemon.py # 宝可梦类定义 ├── move.py # 技能类定义 ├── battle_engine.py # 战斗引擎类处理核心逻辑 ├── data.py # 存放宝可梦、技能、属性克制等静态数据 └── README.md # 项目说明可选接下来我们将从最底层的数据和类开始构建。3. 核心类设计与实现3.1 定义技能类 (Move)技能是战斗中最基本的操作单元。我们先在move.py中定义Move类。# move.py class Move: 技能招式类 def __init__(self, name: str, move_type: str, power: int, accuracy: int, max_pp: int, effectNone): 初始化一个技能。 :param name: 技能名称 :param move_type: 技能属性如 ‘fire‘, ‘water‘ :param power: 技能威力 :param accuracy: 技能命中率0-100 :param max_pp: 技能最大使用次数 :param effect: 技能特殊效果函数默认为None self.name name self.type move_type self.power power self.accuracy accuracy self.max_pp max_pp self.current_pp max_pp # 当前剩余PP self.effect effect # 一个可调用对象用于施加异常状态等 def use(self, attacker, defender): 使用技能。主要逻辑扣除PP判断命中计算伤害应用效果。 :param attacker: 攻击方宝可梦对象 :param defender: 防御方宝可梦对象 :return: (是否命中, 造成的伤害, 效果信息) if self.current_pp 0: print(f{self.name} 的PP耗尽了) return False, 0, PP不足 self.current_pp - 1 # 命中判定 import random if random.randint(1, 100) self.accuracy: print(f{attacker.name} 使用了 {self.name} ... 但是没有命中) return False, 0, 未命中 # 伤害计算 (将在BattleEngine中详细实现这里先返回一个占位值) # damage calculate_damage(attacker, defender, self) # 为保持类职责清晰伤害计算放在战斗引擎中 damage 0 effect_msg # 如果技能有特殊效果则尝试应用 if self.effect: effect_msg self.effect(defender) print(f{attacker.name} 使用了 {self.name}) return True, damage, effect_msg def __str__(self): return f{self.name} ({self.type}) PP: {self.current_pp}/{self.max_pp}关键点说明effect参数是一个函数或可调用对象它接收defender作为参数并返回一个描述效果信息的字符串。这种设计将技能效果与技能本身解耦非常灵活。use方法返回一个元组包含命中状态、伤害值和效果信息方便战斗引擎处理后续逻辑。目前damage计算为0我们将在战斗引擎中实现具体的公式。3.2 定义宝可梦类 (Pokemon)宝可梦是对战的主体。我们在pokemon.py中定义Pokemon类。# pokemon.py class Pokemon: 宝可梦类 def __init__(self, name: str, pokemon_type: str, level: int, max_hp: int, attack: int, defense: int, speed: int, moves: list): 初始化一只宝可梦。 :param name: 宝可梦名称 :param pokemon_type: 宝可梦属性如 ‘fire‘ :param level: 等级 :param max_hp: 最大生命值 :param attack: 攻击力 :param defense: 防御力 :param speed: 速度 :param moves: 技能列表Move对象列表 self.name name self.type pokemon_type self.level level self.max_hp max_hp self.current_hp max_hp self.attack attack self.defense defense self.speed speed self.moves moves # 技能列表 self.status None # 当前状态异常如 ‘burn‘, ‘paralysis‘ self.status_turns 0 # 异常状态持续回合数 def take_damage(self, damage: int): 承受伤害 self.current_hp - damage if self.current_hp 0: self.current_hp 0 print(f{self.name} 受到了 {damage} 点伤害剩余HP: {self.current_hp}/{self.max_hp}) def is_fainted(self): 判断是否失去战斗能力 return self.current_hp 0 def apply_status_effect(self, status: str): 施加状态异常 if self.status is None: # 简化不能叠加状态 self.status status self.status_turns 0 status_names {burn: 灼伤, paralysis: 麻痹} print(f{self.name} {status_names.get(status, status)}了) return True return False def on_turn_end(self): 回合结束时触发例如状态异常的效果 if self.status burn: # 灼伤每回合损失最大HP的1/16并攻击减半在伤害计算时处理 burn_damage self.max_hp // 16 self.current_hp - burn_damage print(f{self.name} 因灼伤损失了 {burn_damage} HP) if self.current_hp 0: self.current_hp 0 # 麻痹、中毒等效果可以在这里扩展 self.status_turns 1 def __str__(self): status_str f [{self.status}] if self.status else return f{self.name} (Lv.{self.level} {self.type}) HP: {self.current_hp}/{self.max_hp}{status_str}关键点说明status字段记录当前异常状态我们使用简单的字符串标识如‘burn‘。on_turn_end方法在每个回合结束时被战斗引擎调用用于处理状态异常的持续效果如灼伤扣血。apply_status_effect方法用于在战斗中附加新的状态。3.3 实现战斗引擎 (BattleEngine)战斗引擎是模拟器的大脑负责协调所有规则。我们在battle_engine.py中实现。首先我们需要定义属性克制关系。这是一个典型的“数据”我们将其放在引擎内部但更好的做法是放在data.py这里为了流程清晰先写在引擎里。# battle_engine.py import random class BattleEngine: 战斗引擎处理对战的核心逻辑 # 简化版属性克制表 (攻击属性 - 防御属性 - 倍数) TYPE_CHART { fire: {grass: 2.0, fire: 0.5, water: 0.5}, water: {fire: 2.0, water: 0.5, grass: 0.5}, grass: {water: 2.0, grass: 0.5, fire: 0.5}, electric: {water: 2.0, electric: 0.5, grass: 0.5}, normal: {} # 普通系没有克制 } staticmethod def calculate_type_multiplier(attack_type: str, defend_type: str) - float: 计算属性克制倍数 return BattleEngine.TYPE_CHART.get(attack_type, {}).get(defend_type, 1.0) staticmethod def calculate_damage(attacker, defender, move): 简化版伤害计算公式 (基于第二代/第三世代的公式) # 基础伤害 ((2 * 等级 / 5 2) * 威力 * (攻击/防御)) / 50 2 level_factor (2 * attacker.level / 5) 2 attack_def_ratio attacker.attack / defender.defense base_damage (level_factor * move.power * attack_def_ratio) / 50 2 # 属性克制倍数 type_multiplier BattleEngine.calculate_type_multiplier(move.type, defender.type) # 随机因子 (0.85 ~ 1.00) random_factor random.uniform(0.85, 1.0) # 状态修正 (例如灼伤攻击减半) status_multiplier 1.0 if attacker.status burn: status_multiplier 0.5 # 注意宝可梦官方设定中灼伤时物理招式伤害减半特殊招式不减。 # 我们这里简化处理所有攻击都减半。 final_damage int(base_damage * type_multiplier * random_factor * status_multiplier) # 确保至少造成1点伤害除非免疫这里简化 if final_damage 1 and type_multiplier 0: final_damage 1 # 打印克制信息 if type_multiplier 1: print(效果拔群) elif type_multiplier 1: print(效果不理想...) return final_damage def execute_turn(self, pokemon1, pokemon2, move1, move2): 执行一个回合。 规则速度快的先行动。如果选择技能为None可能PP不足则跳过。 :return: (胜利者Pokemon对象, 如果未分出胜负则为None) # 决定行动顺序 first, second, first_move, second_move (pokemon1, pokemon2, move1, move2) if pokemon2.speed pokemon1.speed: first, second, first_move, second_move (pokemon2, pokemon1, move2, move1) elif pokemon2.speed pokemon1.speed: # 速度相同随机决定 if random.choice([True, False]): first, second, first_move, second_move (pokemon2, pokemon1, move2, move1) winner None # 第一只宝可梦行动 if first_move and not first.is_fainted(): hit, damage, effect_msg first_move.use(first, second) if hit: actual_damage self.calculate_damage(first, second, first_move) second.take_damage(actual_damage) if effect_msg: print(effect_msg) if second.is_fainted(): winner first return winner # 第二只宝可梦行动 if second_move and not second.is_fainted(): hit, damage, effect_msg second_move.use(second, first) if hit: actual_damage self.calculate_damage(second, first, second_move) first.take_damage(actual_damage) if effect_msg: print(effect_msg) if first.is_fainted(): winner second return winner # 回合结束处理状态效果 if not first.is_fainted(): first.on_turn_end() if not second.is_fainted(): second.on_turn_end() return winner # 本回合未决出胜负关键点说明TYPE_CHART定义了属性克制关系。这是一个嵌套字典方便查询。calculate_damage实现了简化的伤害公式。真实的宝可梦伤害公式更复杂涉及种族值、个体值、努力值等这里做了大量简化以突出核心逻辑。execute_turn这是引擎的核心方法。它处理行动顺序、技能使用、伤害计算、状态结算的完整流程。注意它需要接收双方宝可梦和它们本回合选择的技能。4. 数据定义与效果函数为了让我们的模拟器“活”起来需要定义一些具体的宝可梦和技能数据以及技能效果。4.1 在data.py中定义数据# data.py from move import Move from pokemon import Pokemon # ---------- 技能效果函数 ---------- def burn_effect(target): 灼伤效果 if target.apply_status_effect(burn): return f{target.name} 被灼伤了 return def paralysis_effect(target): 麻痹效果 if target.apply_status_effect(paralysis): return f{target.name} 麻痹了可能无法行动 return # ---------- 技能定义 ---------- # 火系技能 flamethrower Move(喷射火焰, fire, 90, 100, 15, effectburn_effect) ember Move(火花, fire, 40, 100, 25) # 水系技能 water_gun Move(水枪, water, 40, 100, 25) surf Move(冲浪, water, 90, 100, 15) # 草系技能 vine_whip Move(藤鞭, grass, 45, 100, 25) razor_leaf Move(飞叶快刀, grass, 55, 95, 25) # 电系技能 thunder_shock Move(电击, electric, 40, 100, 30) thunderbolt Move(十万伏特, electric, 90, 100, 15, effectparalysis_effect) # 普通系技能 tackle Move(撞击, normal, 40, 100, 35) quick_attack Move(电光一闪, normal, 40, 100, 30) # ---------- 宝可梦定义 ---------- # 创建宝可梦并分配技能 charizard Pokemon( name喷火龙, pokemon_typefire, level36, max_hp120, attack84, defense78, speed100, moves[flamethrower, ember, quick_attack, tackle] ) blastoise Pokemon( name水箭龟, pokemon_typewater, level36, max_hp118, attack83, defense100, speed78, moves[surf, water_gun, tackle, quick_attack] ) venusaur Pokemon( name妙蛙花, pokemon_typegrass, level36, max_hp120, attack82, defense83, speed80, moves[razor_leaf, vine_whip, tackle, quick_attack] ) pikachu Pokemon( name皮卡丘, pokemon_typeelectric, level30, max_hp90, attack55, defense40, speed90, moves[thunderbolt, thunder_shock, quick_attack, tackle] ) # 一个简单的宝可梦池方便随机选择 POKEMON_POOL [charizard, blastoise, venusaur, pikachu]关键点说明效果函数如burn_effect被定义为独立的函数然后在创建Move对象时通过effect参数传入。这使得技能效果可以灵活定制和复用。宝可梦的种族值HP、攻击等是随意设定的旨在平衡和体现差异性。真实数据可以从宝可梦百科获取。POKEMON_POOL列表方便我们随机选取对战双方。5. 完整实战构建可运行的对战模拟器现在我们将所有模块组合起来在main.py中创建一个简单的命令行对战程序。5.1 主程序逻辑 (main.py)# main.py import random from data import POKEMON_POOL from battle_engine import BattleEngine def choose_move(pokemon): 让玩家为宝可梦选择一个技能 print(f\n{pokemon.name} 的技能) for i, move in enumerate(pokemon.moves, 1): print(f {i}. {move}) while True: try: choice int(input(请选择技能编号 (1-4): )) if 1 choice 4: selected_move pokemon.moves[choice - 1] if selected_move.current_pp 0: return selected_move else: print(f{selected_move.name} 的PP已经用完了请选择其他技能。) else: print(请输入有效的编号 (1-4)。) except ValueError: print(请输入数字。) def main(): print( 宝可梦对战模拟器 ) print(随机选择对战双方...) # 随机选择两只不同的宝可梦 pokemon1, pokemon2 random.sample(POKEMON_POOL, 2) print(f\n对战开始) print(f{pokemon1} VS {pokemon2}) battle_engine BattleEngine() turn 1 # 对战主循环 while True: print(f\n----- 第 {turn} 回合 -----) print(pokemon1) print(pokemon2) # 玩家1选择技能 (这里简化未来可扩展为双人) print(f\n{pokemon1.name} 的行动) move1 choose_move(pokemon1) # 玩家2电脑随机选择技能 available_moves [m for m in pokemon2.moves if m.current_pp 0] if available_moves: move2 random.choice(available_moves) print(f{pokemon2.name} 选择了 {move2.name}。) else: move2 None print(f{pokemon2.name} 没有可用的技能了) # 执行本回合 winner battle_engine.execute_turn(pokemon1, pokemon2, move1, move2) # 检查胜负 if winner: print(f\n***** {winner.name} 获胜了 *****) break # 检查是否双方都无可用技能平局 p1_has_pp any(m.current_pp 0 for m in pokemon1.moves) p2_has_pp any(m.current_pp 0 for m in pokemon2.moves) if not p1_has_pp and not p2_has_pp: print(\n***** 双方技能PP全部耗尽平局 *****) break turn 1 print(\n对战结束) if __name__ __main__: main()5.2 运行你的模拟器确保所有文件 (main.py,pokemon.py,move.py,battle_engine.py,data.py) 在同一个目录下。在终端或命令行中进入该目录。运行命令python main.py预期运行示例 宝可梦对战模拟器 随机选择对战双方... 对战开始 喷火龙 (Lv.36 fire) HP: 120/120 VS 水箭龟 (Lv.36 water) HP: 118/118 ----- 第 1 回合 ----- 喷火龙 (Lv.36 fire) HP: 120/120 水箭龟 (Lv.36 water) HP: 118/118 喷火龙 的行动 喷火龙 的技能 1. 喷射火焰 (fire) PP: 15/15 2. 火花 (fire) PP: 25/25 3. 电光一闪 (normal) PP: 30/30 4. 撞击 (normal) PP: 35/35 请选择技能编号 (1-4): 1 水箭龟 选择了 冲浪。 喷火龙 使用了 喷射火焰 效果不理想... 水箭龟 受到了 18 点伤害剩余HP: 100/118 水箭龟 被灼伤了 水箭龟 使用了 冲浪 效果拔群 喷火龙 受到了 42 点伤害剩余HP: 78/120 水箭龟 因灼伤损失了 7 HP ... 后续回合6. 常见问题与排查思路在实现和运行过程中你可能会遇到以下问题问题现象可能原因解决思路导入错误ModuleNotFoundError文件不在同一目录或文件名拼写错误。检查所有.py文件是否位于同一文件夹。检查import语句中的模块名是否正确不含.py后缀。伤害计算为0或异常低1. 属性克制表 (TYPE_CHART) 未正确定义防御类型。2. 攻击/防御数值设置不合理如防御远高于攻击。3. 伤害公式中的除法导致结果为0Python整数除法。1. 检查TYPE_CHART确保攻击属性和防御属性的键都存在。2. 调整data.py中宝可梦的attack和defense值使其处于合理范围如几十到一百多。3. 确保公式中使用了浮点数除法/或者将level_factor等变量转换为float。状态效果没有触发1. 技能效果函数 (effect) 没有正确绑定。2. 效果函数内部逻辑错误没有成功调用apply_status_effect。3.BattleEngine.execute_turn中没有打印效果信息。1. 检查data.py中创建Move对象时effect参数是否传入了函数名如effectburn_effect而不是函数调用effectburn_effect()。2. 在效果函数中添加print语句调试看是否执行。3. 检查execute_turn方法中是否处理了effect_msg并打印。速度相同的宝可梦行动顺序固定execute_turn中速度相同时的处理逻辑有误或未实现随机。检查execute_turn方法中elif pokemon2.speed pokemon1.speed:分支确保使用了random.choice来随机决定先手。宝可梦HP降到负数take_damage方法中没有对current_hp进行下限保护。在take_damage方法中添加if self.current_hp 0: self.current_hp 0。选择技能时出现列表索引错误choose_move函数中用户输入的数字转换或范围判断有误。加强输入验证使用try...except捕获ValueError并确保choice-1在pokemon.moves列表的有效索引范围内。7. 最佳实践与扩展建议一个基础模拟器完成后可以考虑以下方向进行优化和扩展这能让你更深入地理解游戏逻辑和软件设计。7.1 代码结构与设计模式数据与逻辑分离将TYPE_CHART、宝可梦种族值、技能数据完全移出代码放到 JSON 或 YAML 配置文件中。这样无需修改代码就能创建新的宝可梦和技能。使用工厂模式创建PokemonFactory和MoveFactory类根据名称从数据文件中加载并创建对象。状态模式将“灼伤”、“麻痹”等状态抽象为Status类或使用状态模式而不是用简单的字符串和if-else判断。每个状态类实现on_turn_start,on_turn_end,modify_damage等方法使引擎代码更清晰。7.2 功能扩展更完整的属性克制系统实现完整的18种属性克制关系表。技能分类引入“物理”、“特殊”、“变化”技能分类。伤害计算时物理技能看攻击/防御特殊技能看特攻/特防。特性系统为Pokemon类添加ability字段并在战斗引擎的关键节点伤害计算、状态判定等检查特性效果。道具系统增加held_item字段并设计道具效果触发的时机。战斗场景引入“天气”如大晴天、下雨和“场地”效果影响特定属性的技能威力或状态。AI 对手为电脑对手实现更智能的技能选择策略例如根据克制关系、自身状态选择最优技能。图形界面使用Pygame或tkinter库为模拟器添加简单的图形界面显示精灵图和血条。7.3 工程化与健壮性单元测试为BattleEngine.calculate_damage,Pokemon.take_damage,Move.use等核心方法编写单元测试确保逻辑正确。日志系统替换print语句使用 Python 的logging模块记录战斗过程便于调试和复盘。输入验证在主循环和choose_move函数中对用户输入进行更严格的验证防止程序因意外输入而崩溃。异常处理在文件读取、数据加载等可能出错的地方添加try...except块提供友好的错误信息。通过这个项目你不仅实现了一个有趣的游戏模拟器更实践了面向对象设计、模块化编程和状态机逻辑。从被“暴揍”到逐步完善系统的过程正是软件开发能力提升的缩影。