# sea2_sailwinds

**Repository Path**: e4glet/sea2_sailwinds

## Basic Information

- **Project Name**: sea2_sailwinds
- **Description**: 大航海时代2复刻版
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-05
- **Last Updated**: 2026-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Sailwinds 大航海时代II 复刻版

基于 Web 技术（Vite + TypeScript + Canvas）复刻《大航海时代2》（KOEI，1994）核心玩法。

![alt text](image1.png)

## 运行

```bash
npm install
npm run dev        # 开发模式 http://localhost:5173
npm run build      # 生产构建（输出 dist/）
npm run preview    # 预览构建产物
npm test           # 核心逻辑冒烟测试
```

## 玩法

- **主菜单**：继续航海（读档）/ 开始新航海（选六位主角之一）/ 环境设定 / 结束
- **航海**：`方向键` 或 屏幕舵盘 控制转向，`↑/张帆`、`↓/收帆`，实时风向影响航速，消耗补给
- **港口**：造船厂（买船/修船/改造）、集市（买卖商品/补给）、酒馆（招水手）、银行、教堂、占卜师、总督府（报告发现物）
- **海战**：航行中随机遭遇海盗，炮击 / 肉搏 / 单挑，胜利获得赏金与战斗经验
- **探索**：航行靠近未知坐标可发现遗迹/奇迹/宝藏，向总督报告换取金钱与冒险声望
- **剧情**：六位主角各有独立事件线，在特定港口触发

## 快捷键

| 按键 | 功能 |
|------|------|
| ↑ / W | 张帆 |
| ↓ / S | 收帆 |
| ← / A | 左转 |
| → / D | 右转 |
| Enter / M | 航海菜单 |

## 存档

游戏自动保存至浏览器 LocalStorage（航海菜单中也可手动存盘）。标题画面"继续航海"读取存档。

## 目录结构

```
src/
├── core/       # 引擎（StateManager、Navigation、GameLoop、Audio）
├── data/       # 游戏数据（港口、船只、商品、角色、发现物、剧情）
├── systems/    # 海战系统
├── renderer/   # 世界地图 Canvas 渲染
└── ui/         # 界面（主菜单、选人、航海、港口、战斗）
```

## 测试

```bash
node scripts/smoke-test.ts   # 核心逻辑
node scripts/deep-test.cjs   # UI 流程（需 Chrome + dev server）
```

## 素材说明

背景音乐位于 `music/`（main.mp3 航海用 / city.mp3 港口用）。其他像素素材需求见 `人工协助.md`。