pet_data/README.md

# 虛擬寵物系統 - Nuxt 版本

基於 PRD v2.1 的資料驅動虛擬寵物系統，支援事件觸發、Buff 管理、神明系統等核心功能。

## 🚀 快速開始

### 安裝依賴

```bash
npm install
```

### 啟動開發伺服器

```bash
npm run dev
```

### 使用 Console 互動版

1. 訪問：`http://localhost:3000/console-demo.html`
2. 打開瀏覽器開發者工具（F12）
3. 在 Console 中輸入命令，例如：
   - `help()` - 查看所有命令
   - `showStatus()` - 顯示寵物狀態
   - `start()` - 啟動遊戲循環
   - `feed(20)` - 餵食
   - `play(15)` - 玩耍
   - `pray()` - 祈福

詳細使用說明請參考 [docs/USAGE.md](./docs/USAGE.md)

## 📁 專案結構

- `data/` - 資料配置（寵物種族、神明、事件、道具、籤詩）
- `core/` - 核心系統（API 服務、寵物系統、事件系統、神明系統）
- `console-demo.js` - Console 互動介面
- `public/console-demo.html` - 瀏覽器版本
- `docs/` - 文檔（API 結構、使用說明）

## 🔌 API 整合

系統支援 Mock 和真實 API 切換：

- **Mock 模式**（預設）：資料儲存在 localStorage
- **真實 API**：修改 `console-demo.js` 中的 `useMock: false`

API 端點結構詳見 [docs/API_STRUCTURE.md](./docs/API_STRUCTURE.md)

## 📚 文檔

- [使用說明](./docs/USAGE.md) - 完整的使用指南和命令列表
- [API 結構](./docs/API_STRUCTURE.md) - API 端點設計文檔

## 🎮 核心功能

- ✅ 寵物狀態管理（飢餓、快樂、健康等）
- ✅ Tick 循環系統（每 3 秒）
- ✅ 事件系統（資料驅動，10% 機率觸發）
- ✅ Buff 系統（flat + percent 加成）
- ✅ 神明系統（5 位神明，祈福、抽籤）
- ✅ API 服務層（支援 mock/real 切換）
- ✅ Console 互動介面

## 🛠️ 開發

Look at the [Nuxt documentation](https://nuxt.com/docs/getting-started/introduction) to learn more.

## Setup

Make sure to install dependencies:

```bash
# npm
npm install

# pnpm
pnpm install

# yarn
yarn install

# bun
bun install
```

## Development Server

Start the development server on `http://localhost:3000`:

```bash
# npm
npm run dev

# pnpm
pnpm dev

# yarn
yarn dev

# bun
bun run dev
```

## Production

Build the application for production:

```bash
# npm
npm run build

# pnpm
pnpm build

# yarn
yarn build

# bun
bun run build
```

Locally preview production build:

```bash
# npm
npm run preview

# pnpm
pnpm preview

# yarn
yarn preview

# bun
bun run preview
```

Check out the [deployment documentation](https://nuxt.com/docs/getting-started/deployment) for more information.