# Regicide - 单人卡牌游戏

基于 Phaser 3 + boardgame-core 框架实现的 Regicide 合作卡牌游戏单人模式。

## 游戏简介

Regicide 是一款合作奇幻卡牌游戏，使用标准扑克牌进行游戏。玩家需要击败12个强大的敌人（4个J、4个Q、4个K）来取得胜利。

## 游戏规则

### 目标
按任意顺序击败城堡牌堆中的所有12个敌人（J/Q/K）。

### 设置
- **城堡牌堆**: 12张敌人卡（4J、4Q、4K）
- **酒馆牌堆**: 所有数字牌（2-10）和A
- **初始手牌**: 8张
- **小丑牌**: 2张（用于重抽手牌）

### 敌人属性
| 敌人 | HP | 反击伤害 | 分值 |
|------|----|----------|------|
| J    | 20 | 10       | 10   |
| Q    | 30 | 15       | 15   |
| K    | 40 | 20       | 20   |

### 花色效果
- **红桃 ♥**: 从弃牌堆回收卡牌到酒馆牌堆
- **方片 ♦**: 抽取等量卡牌
- **梅花 ♣**: 攻击力翻倍
- **黑桃 ♠**: 减免反击伤害

### 游戏流程
1. **出牌阶段**: 打出一张或多张同点数的牌（总点数≤10）
2. **伤害结算**: 对敌人造成等同于牌面点数的伤害
3. **反击阶段**: 如果敌人未被击败，它会反击
4. **抵消反击**: 弃置点数总和≥反击伤害的牌

### 特殊规则
- **敌人免疫**: 每个敌人免疫与其花色相同的卡牌效果
- **组合牌**: 可打出多张同点数牌，但总点数不能超过10
- **小丑牌**: 可弃光手牌并重新抽取8张（整局限用2次）

### 胜利等级
- 🥇 **金胜利**: 未使用小丑牌获胜
- 🥈 **银胜利**: 使用1张小丑牌获胜
- 🥉 **铜胜利**: 使用2张小丑牌获胜

## 运行游戏

```bash
# 安装依赖
pnpm install

# 启动开发服务器
cd packages/regicide-game
pnpm dev

# 构建生产版本
pnpm build

# 预览生产版本
pnpm preview
```

## 项目结构

```
packages/regicide-game/
├── src/
│   ├── game/
│   │   ├── types.ts          # 类型定义
│   │   ├── card-utils.ts     # 卡牌工具函数
│   │   └── regicide.ts       # 游戏逻辑和命令
│   ├── scenes/
│   │   ├── GameScene.ts      # 主游戏场景
│   │   └── effects.ts        # 特效系统
│   └── ui/
│       └── App.tsx           # Preact UI组件
├── index.html
├── package.json
└── vite.config.ts
```

## 技术栈

- **Phaser 3**: 游戏引擎
- **boardgame-core**: 状态管理（Preact Signals + Mutative）
- **boardgame-phaser**: Phaser 集成框架
- **Preact**: UI 组件
- **TypeScript**: 类型安全
- **Vite**: 构建工具
- **Tailwind CSS**: UI 样式

## 开发说明

### 命令系统
游戏使用 boardgame-core 的命令系统：
- `setup` - 初始化游戏
- `play <cardId>` - 打出单张卡牌
- `combo <cardIds>` - 打出组合牌
- `yield` - 放弃回合
- `counterattack <cardIds>` - 反击时弃牌
- `useJester` - 使用小丑牌重抽

### 状态管理
游戏状态使用 MutableSignal 响应式系统，通过 `game.produce()` 进行不可变更新。

### 场景系统
GameScene 继承自 GameHostScene，使用 `spawnEffect` 和 `effect()` 实现响应式渲染。

## 许可证

MIT