建回合制RPG:數(shù)據(jù)驅(qū)動(dòng)與狀態(tài)機(jī)設(shè)計(jì)實(shí)戰(zhàn))
很多人一提到“用代碼寫一個(gè)游戲”第一反應(yīng)是下載引擎、學(xué)渲染、調(diào)物理。如果你只是想鍛煉編程能力這條路其實(shí)有點(diǎn)繞。今天這篇文章我想用《寶可夢(mèng)百變怪與喵喵的冒險(xiǎn)》這個(gè) Python 小項(xiàng)目完整地演示一個(gè)回合制 RPG 是怎么從零搭起來的。這里的“全本”不是復(fù)刻官方劇情而是指把一個(gè)最小的完整冒險(xiǎn)閉環(huán)打通有精靈數(shù)據(jù)、有屬性克制、有回合制戰(zhàn)斗、有劇情分支、有可運(yùn)行入口。你會(huì)發(fā)現(xiàn)游戲開發(fā)里真正難的不是“做畫面”而是把一堆規(guī)則用數(shù)據(jù)驅(qū)動(dòng)的方式組織起來。讀完本文你會(huì)拿到一個(gè)可以直接運(yùn)行的 Python 項(xiàng)目骨架并且知道每個(gè)模塊為什么這樣設(shè)計(jì)。先給結(jié)論這篇文章的價(jià)值不在于“我又寫了一個(gè)命令行游戲”而在于三個(gè)可遷移的技能點(diǎn)。第一數(shù)據(jù)與邏輯分離——精靈、技能、劇情腳本都放在獨(dú)立的數(shù)據(jù)結(jié)構(gòu)里不寫死在 if/else 中。第二狀態(tài)機(jī)思維——回合制戰(zhàn)斗就是一個(gè)典型的有限狀態(tài)機(jī)。第三原型迭代方法——先用文本界面把核心機(jī)制跑通再考慮圖形化。很多商業(yè)游戲項(xiàng)目也是同一個(gè)路子。1. 為什么選用“百變怪和喵喵”這個(gè)案例如果只看表面百變怪是一只能變形的寶可夢(mèng)喵喵是一只會(huì)用聚寶功的普通系寶可夢(mèng)它們湊在一起更像一個(gè)搞笑冒險(xiǎn)組合。但從編程角度看這兩個(gè)角色剛好覆蓋了兩類非常典型的設(shè)計(jì)難點(diǎn)。百變怪的核心機(jī)制是“變身”。在戰(zhàn)斗里變身意味著什么意味著一個(gè)對(duì)象在運(yùn)行過程中要?jiǎng)討B(tài)修改自己的屬性、屬性和技能列表。這在業(yè)務(wù)系統(tǒng)中非常常見用戶切換角色、訂單切換狀態(tài)、任務(wù)切換執(zhí)行器本質(zhì)都是運(yùn)行時(shí)狀態(tài)遷移。處理百變怪的變身邏輯比寫一百個(gè) if/else 更能讓人理解“什么才是好的對(duì)象設(shè)計(jì)”。喵喵則代表最傳統(tǒng)的物理輸出型角色血不高、攻不低、技能槽有限。它讓玩家必須認(rèn)真考慮技能搭配和回合策略。它的聚寶功、抓、叫聲這些技能又涉及“技能可能沒有傷害只產(chǎn)生特殊效果”的情況。這個(gè)點(diǎn)在戰(zhàn)斗引擎中很容易被忽略但真實(shí)游戲里非常重要。還有一個(gè)現(xiàn)實(shí)原因?qū)毧蓧?mèng)題材自帶一套清晰易懂的規(guī)則。屬性克制表、速度決定先手、技能有威力與命中這些規(guī)則不需要我額外解釋讀者一看就懂。用熟悉規(guī)則去理解陌生代碼學(xué)習(xí)成本會(huì)低很多。從這個(gè)項(xiàng)目中你能遷移到的不只是游戲邏輯。比如訂單狀態(tài)機(jī)、審批流節(jié)點(diǎn)、規(guī)則引擎的配置化甚至自動(dòng)化測(cè)試中的“模擬用戶操作路徑”都和這里的實(shí)現(xiàn)思路高度相似。所以這篇文章雖然標(biāo)題看起來像“游戲項(xiàng)目”實(shí)際上講的是如何用 Python 寫一個(gè)可擴(kuò)展的規(guī)則系統(tǒng)。2. 核心原理數(shù)據(jù)驅(qū)動(dòng)、狀態(tài)機(jī)與屬性克制在正式寫代碼前先把三個(gè)核心設(shè)計(jì)原理講清楚。很多新手項(xiàng)目的最大問題就是所有內(nèi)容都堆在 main 函數(shù)里遇到什么怪寫一段邏輯拿到什么道具寫一段邏輯。這樣的代碼在只有兩個(gè)精靈時(shí)沒問題但一旦擴(kuò)展到十幾只精靈代碼會(huì)迅速失控。數(shù)據(jù)驅(qū)動(dòng)的意思是把“有哪些精靈”“每個(gè)精靈會(huì)哪些技能”“技能威力是多少”“屬性之間如何克制”這些信息全部抽成數(shù)據(jù)表。戰(zhàn)斗引擎和劇情引擎只負(fù)責(zé)讀取這些數(shù)據(jù)然后執(zhí)行通用規(guī)則而不關(guān)心具體的精靈是誰。也就是說將來你要加一只新精靈不需要改戰(zhàn)斗代碼只需要加一段數(shù)據(jù)。狀態(tài)機(jī)是回合制戰(zhàn)斗的骨架。一場(chǎng)戰(zhàn)斗可以拆成選擇技能狀態(tài)、執(zhí)行攻擊狀態(tài)、檢查勝負(fù)狀態(tài)、切換回合狀態(tài)。每一步都是一個(gè)確定性的狀態(tài)遷移不滿足條件就不能進(jìn)入下一步。這是非常標(biāo)準(zhǔn)的有限狀態(tài)機(jī)模型也是后端開發(fā)中任務(wù)調(diào)度的常見抽象。屬性克制則是典型的二維矩陣數(shù)據(jù)?;鸫虿菪Ч稳核蚧鹦Ч稳翰荽蛩Ч稳骸?shù)據(jù)可以表達(dá)為字典的元組鍵(火, 草)對(duì)應(yīng)倍率 2.0。代碼本身不關(guān)心寶可夢(mèng)世界到底有幾套屬性它只負(fù)責(zé)“查表、取倍率、參與傷害計(jì)算”。理解了這三個(gè)原理后面的代碼其實(shí)就是把這些思想翻譯成 Python。數(shù)據(jù)表用字典和 dataclass狀態(tài)遷移用 while 循環(huán)加條件判斷屬性克制用帶元組鍵的字典。沒有任何黑魔法全部都是基礎(chǔ)語法。3. 環(huán)境準(zhǔn)備與項(xiàng)目結(jié)構(gòu)這個(gè)項(xiàng)目不依賴任何第三方庫(kù)只需要 Python 3.9 及以上版本。為什么選 3.9不是因?yàn)榈桶姹静荒苡枚菫榱擞蒙蟣ist[str]這類內(nèi)置泛型語法寫起來更簡(jiǎn)潔。如果你環(huán)境里只有 Python 3.8也可以把類型注解改成List[str]代碼照樣能跑。項(xiàng)目結(jié)構(gòu)建議這樣組織pokemon_adventure/ ├── data.py # 精靈、技能、屬性克制數(shù)據(jù) ├── monster.py # 數(shù)據(jù)模型 dataclass ├── battle.py # 戰(zhàn)斗引擎 ├── story.py # 劇情腳本 ├── main.py # 程序入口 └── README.md # 項(xiàng)目說明每個(gè)文件只負(fù)責(zé)一件事。data.py 是數(shù)據(jù)庫(kù)monster.py 是數(shù)據(jù)結(jié)構(gòu)定義battle.py 是戰(zhàn)斗規(guī)則story.py 是劇情腳本main.py 負(fù)責(zé)把它們串起來。運(yùn)行項(xiàng)目只需要在項(xiàng)目目錄執(zhí)行python main.py不需要 pip install也沒有其他依賴安裝步驟。這樣設(shè)計(jì)的目的是讓讀者把精力完全放在邏輯理解上而不是環(huán)境問題。如果你使用的是 Windows 系統(tǒng)并且運(yùn)行后出現(xiàn)中文亂碼可以在命令行臨時(shí)設(shè)置編碼set PYTHONIOENCODINGutf-8 python main.py在 macOS 和 Linux 上通常沒有這個(gè)煩惱。4. 數(shù)據(jù)建模精靈、技能與屬性克制表數(shù)據(jù)模型是整個(gè)項(xiàng)目的底座。先定義技能和精靈兩個(gè) dataclass。技能需要名稱、威力、屬性和 PP 值精靈需要名字、等級(jí)、血量、攻防、速度、屬性和技能字典。# monster.py from dataclasses import dataclass from typing import Dict, List dataclass class Skill: name: str power: int skill_type: str pp: int dataclass class Monster: name: str level: int max_hp: int hp: int attack: int defense: int speed: int types: List[str] skills: Dict[str, Skill]這里有一個(gè)容易忽略的細(xì)節(jié)types用列表而不是字符串。雖然絕大多數(shù)寶可夢(mèng)只有一個(gè)屬性但從設(shè)計(jì)角度必須支持雙屬性。雙屬性在戰(zhàn)斗中會(huì)同時(shí)參與屬性克制計(jì)算比如“水 飛行”的屬性被電屬性攻擊時(shí)可能造成更高傷害。提前用列表模型化后續(xù)擴(kuò)展時(shí)不會(huì)重構(gòu)。技能庫(kù)和精靈工廠函數(shù)放在 data.py。為了簡(jiǎn)單先創(chuàng)建四個(gè)技能撞擊、抓、叫聲、變身。有了技能庫(kù)之后用函數(shù)創(chuàng)建百變怪和喵喵而不是直接寫大量重復(fù)數(shù)據(jù)。# data.py from monster import Monster, Skill skill_lib { 撞擊: Skill(name撞擊, power40, skill_type普通, pp35), 抓: Skill(name抓, power40, skill_type普通, pp35), 叫聲: Skill(name叫聲, power0, skill_type普通, pp40), 變身: Skill(name變身, power0, skill_type普通, pp10), 火花: Skill(name火花, power40, skill_type火, pp25), 水槍: Skill(name水槍, power40, skill_type水, pp25), 飛葉快刀: Skill(name飛葉快刀, power45, skill_type草, pp25), } TYPE_CHART { (火, 草): 2.0, (火, 水): 0.5, (水, 火): 2.0, (水, 草): 0.5, (草, 水): 2.0, (草, 火): 0.5, (電, 水): 2.0, (電, 草): 0.5, } def create_ditto() - Monster: return Monster( name百變怪, level5, max_hp35, hp35, attack8, defense8, speed10, types[普通], skills{撞擊: skill_lib[撞擊], 變身: skill_lib[變身]}, ) def create_meowth() - Monster: return Monster( name喵喵, level5, max_hp40, hp40, attack9, defense7, speed9, types[普通], skills{抓: skill_lib[抓], 叫聲: skill_lib[叫聲]}, )TYPE_CHART 是這個(gè)項(xiàng)目里最像“規(guī)則配置”的地方。它本質(zhì)是一個(gè)二維矩陣但因?yàn)樽值涞脑M鍵寫法比二維數(shù)組更直觀所以被廣泛使用。這里的倍率規(guī)則非常簡(jiǎn)化只寫了本案例會(huì)用到的幾組克制關(guān)系實(shí)際項(xiàng)目可以根據(jù)需要補(bǔ)全。將“數(shù)據(jù)”與“對(duì)象實(shí)例”分開的意義在于以后加一個(gè)皮卡丘只需要在create_pikachu里填入電屬性技能戰(zhàn)斗引擎不需要變動(dòng)。這才是真正可擴(kuò)展的設(shè)計(jì)。5. 戰(zhàn)斗引擎實(shí)現(xiàn)回合制對(duì)戰(zhàn)與勝負(fù)判定戰(zhàn)斗引擎是整個(gè)項(xiàng)目中最具復(fù)用價(jià)值的部分。它要解決三個(gè)問題傷害怎么算、誰先出手、技能效果怎么處理。傷害公式參考了經(jīng)典角色扮演游戲的思路基礎(chǔ)傷害由攻擊、防御、技能威力共同決定最后乘上屬性克制倍率和隨機(jī)浮動(dòng)值。這個(gè)公式不需要很精確但一定要能體現(xiàn)“攻高打防低更疼”和“屬性克制明顯影響戰(zhàn)局”這兩個(gè)基本直覺。# battle.py import random from monster import Monster, Skill from data import TYPE_CHART def calculate_damage(attacker: Monster, defender: Monster, skill: Skill) - int: if skill.power 0: return 0 base ((attacker.attack * skill.power / defender.defense) / 50 2) modifier 1.0 for atype in attacker.types: for dtype in defender.types: modifier * TYPE_CHART.get((atype, dtype), 1.0) damage int(base * modifier * random.uniform(0.85, 1.0)) return damage這個(gè)函數(shù)的關(guān)鍵不是公式本身而是“查表”邏輯。它遍歷攻擊方和防守方的所有屬性組合從 TYPE_CHART 里取倍率。如果屬性關(guān)系不在表中就用默認(rèn)倍率 1.0。這樣即使后面加入龍系、鋼系等復(fù)雜屬性也不需要改這段代碼只需要擴(kuò)展數(shù)據(jù)表。接著實(shí)現(xiàn)攻擊函數(shù)。這里要特別注意技能威力為 0 不代表技能沒用。叫聲能降低對(duì)手攻擊變身能讓百變怪復(fù)制對(duì)手的數(shù)據(jù)。所以執(zhí)行技能前必須先判斷技能名稱和特殊邏輯。def transform_logic(actor: Monster, target: Monster) - None: actor.types target.types[:] actor.attack target.attack actor.defense target.defense actor.speed target.speed actor.skills dict(target.skills) def attack(actor: Monster, target: Monster, skill: Skill) - None: if skill.name 變身: transform_logic(actor, target) print(f{actor.name} 變身成了 {target.name}) print(f{actor.name} 的屬性變成了 {actor.types}技能變成了 {list(actor.skills.keys())}。) return if skill.power 0: print(f{actor.name} 使用了 {skill.name}。) return damage calculate_damage(actor, target, skill) target.hp - damage print(f{actor.name} 對(duì) {target.name} 使用 {skill.name}造成 {damage} 點(diǎn)傷害。)變身邏輯之所以單獨(dú)抽出來是因?yàn)樗薷牧?actor 的屬性數(shù)組和技能字典。如果不注意“復(fù)制 skills 而不是引用”可能會(huì)出現(xiàn)一個(gè)精靈變身導(dǎo)致另一個(gè)精靈技能也改變的情況。這里的dict(target.skills)和target.types[:]就是做淺拷貝保證兩個(gè)對(duì)象之間不互相干擾。戰(zhàn)斗主循環(huán)使用 while 循環(huán)直到某一方血量歸零。先手順序通過比較速度決定速度相同則玩家優(yōu)先這是對(duì)玩家友好的約定。AI 方隨機(jī)選擇一個(gè)可用技能玩家方從終端輸入技能編號(hào)。def choose_skill(me: Monster) - Skill: names list(me.skills.keys()) print(可用技能) for i, name in enumerate(names, 1): print(f{i}. {name}) while True: raw input(請(qǐng)選擇技能編號(hào): ).strip() if raw.isdigit() and 1 int(raw) len(names): return me.skills[names[int(raw) - 1]] print(輸入無效請(qǐng)重新輸入。) def start_battle(player: Monster, enemy: Monster) - bool: print(f野生的 {enemy.name} 出現(xiàn)了) while player.hp 0 and enemy.hp 0: actors [player, enemy] if player.speed enemy.speed else [enemy, player] for actor in actors: if player.hp 0 or enemy.hp 0: break target enemy if actor is player else player if actor is player: skill choose_skill(player) else: skill random.choice(list(enemy.skills.values())) attack(actor, target, skill) if player.hp 0 and enemy.hp 0: print(f{player.name}: {player.hp}/{player.max_hp} {enemy.name}: {enemy.hp}/{enemy.max_hp}) input(按回車進(jìn)入下一回合...) if player.hp 0: print(戰(zhàn)斗勝利) return True print(戰(zhàn)斗失敗...) return False這里用了actor is player而不是actor.name player.name。因?yàn)閷?duì)象可能重名但身份比較應(yīng)該用對(duì)象身份而不是字符串。這是很多新手容易踩的坑。戰(zhàn)斗引擎還有一個(gè)重要細(xì)節(jié)PP 值雖然沒有在戰(zhàn)斗主循環(huán)里強(qiáng)制扣減但在數(shù)據(jù)模型中已經(jīng)預(yù)留。實(shí)際項(xiàng)目中每次使用技能都應(yīng)該判斷 PP 是否大于 0否則技能不能使用。為了避免這篇文章過于冗長(zhǎng)這里先不展開但它應(yīng)當(dāng)放在擴(kuò)展清單中。6. 冒險(xiǎn)劇情實(shí)現(xiàn)基于腳本的事件推進(jìn)游戲的另一大塊是劇情。如果把劇情也寫成 if/else例如“如果玩家進(jìn)入森林則打印森林描述如果玩家選擇右邊則進(jìn)入湖泊”那當(dāng)劇情分支多起來后會(huì)非常痛苦。正確做法是把劇情定義成一張“場(chǎng)景表”。每個(gè)場(chǎng)景包含顯示文本、可選項(xiàng)列表、每個(gè)選項(xiàng)對(duì)應(yīng)的下一個(gè)場(chǎng)景。部分場(chǎng)景還包含戰(zhàn)斗事件戰(zhàn)斗勝利后進(jìn)入下一步。# story.py STORY { start: { text: 你拿著精靈球走出家門遇到了在路邊玩耍的百變怪。\n百變怪跳上你的肩膀表示想和你一起冒險(xiǎn)。, choices: [(1, 讓它加入), (2, 猶豫一下)], next: {1: meet_meowth, 2: hesitate}, }, hesitate: { text: 你猶豫了一會(huì)兒決定還是帶上百變怪一起走。, choices: [(1, 繼續(xù)前進(jìn))], next: {1: meet_meowth}, }, meet_meowth: { text: 路邊忽然竄出一只喵喵叼著一枚金幣對(duì)你發(fā)出喵喵的叫聲。\n它看起來想加入隊(duì)伍。, choices: [(1, 邀請(qǐng)喵喵一起冒險(xiǎn))], next: {1: forest_entry}, }, forest_entry: { text: 你和百變怪、喵喵一起進(jìn)入了青木森林。前方草叢里傳來窸窣聲。, battle: wild_grass, choices: [(1, 繼續(xù)深入森林)], next: {1: forest_clearing}, }, forest_clearing: { text: 森林深處有一片空地你遇見了一位正在訓(xùn)練的少年。\n少年提出要和你來一場(chǎng)對(duì)戰(zhàn)。, battle: trainer_battle, choices: [(1, 結(jié)束今天的冒險(xiǎn))], next: {1: end}, }, end: { text: 冒險(xiǎn)暫告一段落。你帶著兩只精靈回到了家中把它們介紹給家人。, choices: [], next: {}, }, }這個(gè)腳本表非常像后端路由表start是入口 URLnext是跳轉(zhuǎn)路由battle是攔截器。這種模式在游戲開發(fā)、配置化工作流、低代碼平臺(tái)中非常常見。劇情驅(qū)動(dòng)函數(shù)需要做三件事根據(jù)當(dāng)前場(chǎng)景名讀取場(chǎng)景數(shù)據(jù)打印文本如果場(chǎng)景配置了戰(zhàn)斗則先觸發(fā)戰(zhàn)斗戰(zhàn)斗勝利后才能繼續(xù)選擇。# story.py from battle import start_battle from data import create_meowth, create_ditto from data import Monster def create_enemy(name: str) - Monster: enemies { wild_grass: Monster( name喇叭芽, level3, max_hp30, hp30, attack6, defense6, speed8, types[草], skills{飛葉快刀: __import__(data).skill_lib[飛葉快刀]}, ), trainer_battle: Monster( name小火龍, level5, max_hp34, hp34, attack9, defense7, speed9, types[火], skills{火花: __import__(data).skill_lib[火花]}, ), } return enemies[name]上面這個(gè)敵人構(gòu)造方式有一個(gè)明顯的壞味道它用__import__(data)來訪問技能庫(kù)可讀性很差。更好的寫法是在 story.py 頂部直接導(dǎo)入 skill_lib。這里為了展示一種“不要這樣做”的反例刻意寫成了動(dòng)態(tài)導(dǎo)入。讀者在實(shí)際項(xiàng)目中應(yīng)該把敵人數(shù)據(jù)也放到 data.py 中統(tǒng)一管理。劇情主循環(huán)使用while scene:來推進(jìn)。當(dāng)場(chǎng)景名為空字符串或 None 時(shí)循環(huán)自然結(jié)束。def run_story(team) - None: scene start while scene: content STORY[scene] print(content[text]) if battle in content: print(戰(zhàn)斗開始) enemy create_enemy(content[battle]) result start_battle(team[0], enemy) if not result: print(你失去了戰(zhàn)斗故事結(jié)束了。) break for m in team: m.hp m.max_hp if not content[choices]: break for key, desc in content[choices]: print(f{key}. {desc}) choice input( ).strip() next_scene content[next].get(choice) if next_scene: scene next_scene else: print(輸入無效請(qǐng)重新選擇。)戰(zhàn)斗結(jié)束后恢復(fù)全隊(duì)血量是一種典型的“劇情模式”處理方式。真實(shí)游戲里可能只是回到寶可夢(mèng)中心但這里為了演示流程而簡(jiǎn)化。這個(gè)處理邏輯讓我想強(qiáng)調(diào)demo 可以用簡(jiǎn)化規(guī)則但簡(jiǎn)化規(guī)則要注釋清楚方便以后替換成完整規(guī)則。7. 游戲入口 main.py 與運(yùn)行驗(yàn)證入口文件負(fù)責(zé)初始化玩家隊(duì)伍然后調(diào)用劇情函數(shù)。# main.py from data import create_ditto, create_meowth from story import run_story def main() - None: print() print( 《寶可夢(mèng)百變怪與喵喵的冒險(xiǎn)》Python 文本版) print() team [create_ditto(), create_meowth()] print(f隊(duì)伍組建完成{, .join(m.name for m in team)}) run_story(team) print(感謝游玩再見) if __name__ __main__: main()在項(xiàng)目目錄執(zhí)行python main.py預(yù)期效果如下 《寶可夢(mèng)百變怪與喵喵的冒險(xiǎn)》Python 文本版 隊(duì)伍組建完成百變怪, 喵喵 你拿著精靈球走出家門遇到了在路邊玩耍的百變怪。 百變怪跳上你的肩膀表示想和你一起冒險(xiǎn)。 1. 讓它加入 2. 猶豫一下 1接著進(jìn)入下一段劇情直到遇到野生寶可夢(mèng)后進(jìn)入戰(zhàn)斗流程。你可以在戰(zhàn)斗中選擇“變身”或“撞擊”觀察百變怪變身后的數(shù)據(jù)和普通攻擊的差異。判斷運(yùn)行成功有三個(gè)標(biāo)準(zhǔn)劇情能一步步從 home 推進(jìn)到森林戰(zhàn)斗能正常進(jìn)行輸入技能編號(hào)后能輸出傷害信息百變怪使用“變身”后技能列表會(huì)變成對(duì)方的技能列表。如果這三個(gè)現(xiàn)象都出現(xiàn)就說明核心鏈路已經(jīng)跑通。如果運(yùn)行失敗第一步不是改代碼而是看報(bào)錯(cuò)信息。大部分問題通常是縮進(jìn)錯(cuò)誤、類型注解不兼容、或者控制臺(tái)編碼問題。常見問題在下一節(jié)單獨(dú)列出。8. 常見問題與排查思路把最容易遇到的坑整理成一張排查表方便收藏復(fù)用。問題現(xiàn)象可能原因排查方式解決方案中文亂碼Windows 控制臺(tái)默認(rèn)編碼不是 UTF-8觀察錯(cuò)誤信息是否包含 UnicodeEncodeError設(shè)置PYTHONIOENCODINGutf-8后運(yùn)行程序報(bào)NameError函數(shù)或變量拼寫不一致查看報(bào)錯(cuò)行號(hào)檢查調(diào)用名統(tǒng)一命名避免中英文混用變身之后技能沒變化直接修改了技能字典引用打印變身前后 skills 的 id使用dict(target.skills)拷貝傷害總是最小值屬性克制的表 key 與精靈 types 不一致打印 attacker.types 和 defender.types確認(rèn)屬性表使用完全相同的大小寫劇情推進(jìn)卡住next字典缺失對(duì)應(yīng)的選擇鍵打印content.keys()檢查劇情場(chǎng)景 ID 是否一致戰(zhàn)斗后 HP 沒有恢復(fù)沒有在戰(zhàn)斗結(jié)束后手動(dòng)回血檢查劇情循環(huán)里是否執(zhí)行m.hp m.max_hp在戰(zhàn)斗結(jié)算后統(tǒng)一處理輸入數(shù)字后無反應(yīng)input 讀到了換行或空格用repr(raw)打印輸入內(nèi)容先執(zhí)行strip()再判斷技能威力為 0 但不想消耗回合沒有特殊技能分支在 attack 中增加if skill.name 變身對(duì)特殊技能單獨(dú)處理代碼復(fù)制后報(bào)縮進(jìn)錯(cuò)誤Markdown 復(fù)制時(shí)把空格轉(zhuǎn)成了 Tab 或丟失縮進(jìn)用 Python 解釋器重新編譯直接下載源碼或在 IDE 中自動(dòng)格式化想加新精靈但代碼到處改精靈創(chuàng)建邏輯散落在多個(gè)文件檢查創(chuàng)建函數(shù)是否集中在 data.py把新精靈創(chuàng)建函數(shù)統(tǒng)一放回 data.py這些坑大多數(shù)不是邏輯太難而是數(shù)據(jù)沒有規(guī)范化導(dǎo)致。如果精靈屬性、技能名、技能類型、場(chǎng)景 ID 全部用統(tǒng)一命名規(guī)范至少能減少一半問題。9. 工程化建議與后續(xù)擴(kuò)展項(xiàng)目骨架跑通以后下一步不是急著加更多精靈而是考慮工程化和可維護(hù)性。第一把數(shù)據(jù)類型和工廠函數(shù)拆得更徹底。目前 data.py 里的 TYPE_CHART 還是一個(gè)純字典如果屬性關(guān)系越來越多建議換成二維數(shù)組或者 JSON 文件加載。把“數(shù)據(jù)”和“代碼”完全分離能讓策劃或數(shù)據(jù)配置人員不碰代碼也能調(diào)參數(shù)。第二引入簡(jiǎn)單存檔。通過 JSON 保存當(dāng)前場(chǎng)景、隊(duì)伍 H 和背包重啟游戲后從存檔繼續(xù)。這個(gè)功能操作量不大但能體現(xiàn)“狀態(tài)持久化”的概念。需要注意保存前要把 dataclass 對(duì)象轉(zhuǎn)換為可序列化的字典加載時(shí)再還原。第三增加技能效果系統(tǒng)。現(xiàn)在的“叫聲”只打印文本沒有實(shí)際效果。正式項(xiàng)目中技能效果可以用一個(gè)effects字段描述比如{target: enemy, stat: attack, stage: -1}再用一個(gè)通用效果解析器去執(zhí)行。這是把“數(shù)據(jù)驅(qū)動(dòng)”再向前推一步的關(guān)鍵設(shè)計(jì)。第四補(bǔ)充自動(dòng)化測(cè)試。戰(zhàn)斗引擎非常適合寫單元測(cè)試給定特定攻擊方、防御方和技能斷言傷害值是否落在合理區(qū)間。測(cè)試能防止改一個(gè)數(shù)據(jù)導(dǎo)致整個(gè)戰(zhàn)斗失衡。一個(gè)小建議傷害公式涉及隨機(jī)數(shù)測(cè)試時(shí)要 mock 掉隨機(jī)函數(shù)或者直接測(cè)試“基礎(chǔ)傷害”公式而不是完整傷害。第五從代碼倉(cāng)庫(kù)的角度建議給這個(gè)項(xiàng)目加一個(gè)簡(jiǎn)單的 README記錄玩法說明和擴(kuò)展計(jì)劃。即使是一個(gè)練習(xí)項(xiàng)目也能讓你提前養(yǎng)成文檔習(xí)慣。最后想說一點(diǎn)關(guān)于素材邊界的提醒。寶可夢(mèng)是受版權(quán)保護(hù)的游戲 IP本文項(xiàng)目?jī)H用于學(xué)習(xí)和演示。如果你真的想發(fā)布一個(gè)完整游戲建議使用原創(chuàng)精靈模型或者只保留“回合制 屬性克制”這套玩法機(jī)制而不使用官方角色的美術(shù)素材和世界觀文本。玩法機(jī)制本身不受版權(quán)保護(hù)但角色形象和名稱不能隨意商用。做一個(gè)學(xué)習(xí)項(xiàng)目沒有問題發(fā)布到應(yīng)用商店則需要謹(jǐn)慎。這個(gè)項(xiàng)目骨架的價(jià)值在于它證明了一個(gè)核心觀點(diǎn)游戲邏輯并不復(fù)雜復(fù)雜的是規(guī)則之間的耦合。把規(guī)則變成數(shù)據(jù)表把流程變成狀態(tài)機(jī)把角色做成可復(fù)制的對(duì)象這三件事一旦想明白不止游戲開發(fā)能用很多業(yè)務(wù)系統(tǒng)開發(fā)也通用。下一步你可以試著加入第三只精靈、設(shè)計(jì)一個(gè)新劇情分支、或者寫一個(gè)簡(jiǎn)單的電腦 AI 對(duì)手。每加一個(gè)功能都會(huì)發(fā)現(xiàn)這個(gè)骨架的擴(kuò)展點(diǎn)這正是學(xué)習(xí)編程最有意思的地方。