|
|
||
|---|---|---|
| app | ||
| core | ||
| data | ||
| docs | ||
| public | ||
| .gitignore | ||
| README.md | ||
| eslint.config.mjs | ||
| liushijiazi_60_lot.json | ||
| nuxt.config.ts | ||
| package-lock.json | ||
| package.json | ||
| tailwind.config.ts | ||
| tsconfig.json | ||
README.md
虛擬寵物系統 - Nuxt 版本
基於 PRD v2.1 的資料驅動虛擬寵物系統,支援事件觸發、Buff 管理、神明系統等核心功能。
🚀 快速開始
安裝依賴
npm install
啟動開發伺服器
npm run dev
使用 Console 互動版
- 訪問:
http://localhost:3000/console-demo.html - 打開瀏覽器開發者工具(F12)
- 在 Console 中輸入命令,例如:
help()- 查看所有命令showStatus()- 顯示寵物狀態start()- 啟動遊戲循環feed(20)- 餵食play(15)- 玩耍pray()- 祈福
詳細使用說明請參考 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
📚 文檔
🎮 核心功能
- ✅ 寵物狀態管理(飢餓、快樂、健康等)
- ✅ Tick 循環系統(每 3 秒)
- ✅ 事件系統(資料驅動,10% 機率觸發)
- ✅ Buff 系統(flat + percent 加成)
- ✅ 神明系統(5 位神明,祈福、抽籤)
- ✅ API 服務層(支援 mock/real 切換)
- ✅ Console 互動介面
🛠️ 開發
Look at the Nuxt documentation to learn more.
Setup
Make sure to install dependencies:
# npm
npm install
# pnpm
pnpm install
# yarn
yarn install
# bun
bun install
Development Server
Start the development server on http://localhost:3000:
# npm
npm run dev
# pnpm
pnpm dev
# yarn
yarn dev
# bun
bun run dev
Production
Build the application for production:
# npm
npm run build
# pnpm
pnpm build
# yarn
yarn build
# bun
bun run build
Locally preview production build:
# npm
npm run preview
# pnpm
pnpm preview
# yarn
yarn preview
# bun
bun run preview
Check out the deployment documentation for more information.