卡牌冒險：做一款自己的爬塔卡牌遊戲

卡牌冒險：做一款自己的爬塔卡牌遊戲

卡牌冒險是 Larch 的擴充功能，用來做爬塔卡牌遊戲：選角色、在分岔的地圖上往上爬、出牌戰鬥、收集遺物，最後打倒塔頂的魔王。卡牌、角色和敵人都可以自己改，也能接進你的劇情，和朋友一起連線玩。

1. 安裝與範例

1. 打開 擴充功能 商店，找到 卡牌冒險，安裝到你的專案。
2. 在白板按 新增卡片 → 擴充功能，會多出三個選項：卡牌地圖、卡牌戰鬥、卡牌資料庫。
3. 放一張 卡牌地圖 當開始卡片，按試玩就能從標題畫面開始爬塔。

想先看完整的例子：在 卡牌冒險 的擴充功能頁按 Remix 範例遊戲（或 專案設定 → 擴充功能 → 開啟範例遊戲《月蝕之塔》），會開一個新專案，序章、卡牌地圖、RPG 村子、劇情對話、魔王戰到兩個結局都已經接好。

新手教學

第一次用，按這篇最上面的 開啟操作引導，或在 新增卡片 → 擴充功能 裡 卡牌冒險 旁邊的問號。教學會一步步帶你放卡牌地圖、設計一張自己的卡牌、換卡面顏色、試玩，再接回故事；每一步都可以按 幫我… 讓 Larch 直接示範。

2. 三種卡片

• 卡牌地圖：一張卡片是一章地圖。從頭開新的一局，或接著目前這一局往上走。在卡片上點兩下打開設定：左邊是地圖預覽，右邊調層數、路線、房間和魔王。
• 卡牌戰鬥：劇情中間打一場，例如魔王戰。用目前這一局的牌組，或指定角色；勝負寫進變數。
• 卡牌資料庫：整個專案共用一份。卡牌、角色、敵人都在這裡改，不用先放卡片。

3. 卡牌資料庫

左邊是分類：卡牌、角色與立繪、敵人、敵人組合、遺物、藥水、奇遇、地圖、冒險設定、多人連線。左右兩欄可以拖曳調整寬度。

點一張卡牌會跳出設定視窗：左邊是卡面預覽，右邊改名稱、費用、類型、所屬角色、稀有度、插圖和效果，改了左邊馬上跟著變。費用的圓章在卡框外面；稀有度越高，卡面越閃：SSR 有金色掃光，UR 有流光外框和全像箔。

角色和敵人的設定視窗也是左右兩欄：左邊看立繪（可以調大小、位置），右邊改生命、能量、起始牌組、招式這些數值。

• 效果可以疊好幾個：傷害、格擋、施加狀態（中毒、易傷、虛弱…）、抽牌、能量、回血等等，也能選目標是一個敵人、全部敵人或自己。
• AI 生成：寫一句想要的卡牌、角色或敵人，AI 會幫你填好數值；插圖也能用 AI 畫，會參考專案裡現有素材的畫風。
• 解鎖條件：卡牌、角色、遺物、藥水可以設定解鎖條件，例如贏幾次、玩幾局、打到第幾章、用某個角色通關、打倒某個敵人，或看劇情變數。還沒解鎖的不會出現在獎勵裡。
• 複製 Skills：右上角的 複製 Skills 會複製一份給 AI Agent 看的說明（資料格式、特殊效果、畫面 CSS，加上目前的資料）。貼給 ChatGPT、Claude 這類 AI，請它大量設計卡牌，再把它寫好的 JSON 貼回 冒險設定 最下面的匯入。
• 多選：卡牌分頁按 多選，勾好幾張一次刪掉（角色起始牌組裡的也會一起拿掉）。
• 清空預設內容：右上角的 清空預設內容 會拿掉範例附的卡牌、角色、敵人、遺物…（可以挑哪幾種），只留你自己新增的，方便從頭做自己的遊戲。

卡牌造型

卡牌分頁的 卡牌造型 可以換每種類型（攻擊、技能、能力、協力、詛咒）和每個稀有度外框的顏色，還有卡面底色和文字顏色；資料庫、手牌、戰利品和圖鑑裡的牌都會一起換。排版可以用卡面 Skills（CSS）改，按 複製給 AI 修改 交給 ChatGPT、Claude 寫。

4. 特殊效果：一句話描述，AI 寫程式

內建效果不夠用的時候，效果選 特殊效果（AI 寫程式），用一句話描述，例如「所有敵人每有 1 層中毒，受到 {n} 點傷害」，再按 AI 寫程式。{n} 會換成你設定的數值，卡面上也會顯示這句話。

• AI 寫好後會先試跑一次，顯示「程式可以執行」才算完成。每次用 2 點 AI 點數。
• 卡牌、敵人、遺物、藥水、奇遇都可以加特殊效果。
• 不想花點數：按 複製給 AI，交給自己的 AI Agent 寫，再把程式貼回來。

特殊效果只能用遊戲提供的動作（傷害、格擋、狀態、抽牌、能量、金幣…），不能連網，也碰不到玩家的其他資料。

5. 地圖與章節

資料庫的 地圖 分頁可以新增章節（最多 8 章），每一章可以設定層數、寬度、房間比例和魔王。地圖是隨機產生的，按 換一張預覽 可以看別種走法。

• 圖示與底圖：每種房間（戰鬥、菁英、奇遇、商店、營火、寶箱、魔王）都能換成自己的圖示，也可以放一張地圖底圖。
• 劇情點：在地圖設定按 新增劇情點。玩家走到這裡會離開卡片、回到故事，變數 cardRunStop 是劇情點的代號。用條件線接到對話卡或 RPG 地圖，演完再接回同一張卡牌地圖，就會從原來的位置繼續往上走。
• 打完魔王：可以回到故事（接下一張卡牌地圖就是下一章），也可以直接在卡片裡走下一章。

6. 戰鬥排版、音樂與 Skills

冒險設定 裡可以選戰鬥排版：

• 殺戮尖塔：主角站在左邊，敵人在右邊。
• 月圓之夜：沒有主角立繪，敵人站在中間，玩家是左下角的小卡。
• 自訂（Skills）：用 CSS 改成自己要的排版。

音樂：地圖、戰鬥、魔王戰可以各放一首，內建兩首配樂，也可以從素材選或上傳。

Skills：地圖畫面和戰鬥畫面都有 複製給 AI 修改，會把畫面的結構說明和目前的 CSS 一起複製。貼給 AI，說你想要的樣子，再把它回的 CSS 貼回來。

7. 和朋友一起連線

在資料庫的 多人連線 分頁打開 開放多人一起爬塔，標題畫面就會多一顆 多人連線，最多 4 個人。

1. 一個人按 開一間房間，把房間代碼給朋友。
2. 朋友打開同一部作品，按 多人連線，輸入代碼加入。有加 Larch 好友的話，可以直接邀請；好友開了房間，也會直接出現在你的多人連線畫面，點一下就加入。
3. 每個人選好角色、按 準備，房主按 開始冒險。

• 路線大家一起投票；戰鬥時各自出牌，所有人都按結束回合，才輪到敵人。
• 協力卡（卡牌類型「協力」）只在多人時出現，可以把格擋、回血、能量給隊友：把卡拖到隊友身上。
• 敵人會跟著人數變強，血量加成可以在資料庫的 多人連線 分頁調整。
• 走到劇情點時，大家一起回到故事；各自看完回來，會接回同一間房間繼續走。

8. 標題畫面、存檔與圖鑑

• 故事有自己的標題畫面時，卡牌冒險就用它：標題畫面多兩顆按鈕 多人連線、圖鑑收藏。開始遊戲＝新的一局，繼續遊戲＝接著存檔，多人連線＝直接進大廳。範例《月蝕之塔》的標題就是這樣，外觀用介面 Skills 做，也能自己改。
• 沒有標題畫面時（例如從卡牌卡片試播），卡牌地圖會出自己的選單：有存檔就選 繼續冒險 或 重新開始。
• 圖鑑收藏：看已經拿到的卡牌、遇過的角色和敵人。
• 故事也能送東西給卡牌冒險：把變數 cardRunGift 設成 gold:50 card:random，回到卡牌地圖時就會拿到 50 金幣和一張隨機卡片。範例專案的 RPG 村子寶箱就是這樣做的。

9. 變數一覽

• cardRunResult：離開卡牌地圖的原因。win 通關、lose 失敗、act 打完這一章的魔王、stop 停在劇情點。
• cardRunStop：停在哪個劇情點（劇情點的代號）。
• cardRunFloor、cardRunGold：爬到第幾層、身上有多少金幣。
• cardRunGift：從故事送進卡牌冒險的東西。
• cardBattleResult、cardBattleHp：卡牌戰鬥卡片的勝負（win／lose）和剩下的生命。

變數名稱可以在 冒險設定 裡改成你專案裡的變數。