# zuoye

**Repository Path**: tra1/zuoye

## Basic Information

- **Project Name**: zuoye
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 火山之心 (Heart of the Volcano)

**类型**：养成 + 探索 + 冒险  
**技术栈**：Java + LibGDX 1.12.0  
**开发状态**：🚧 开发中 (MVP)

---

## 📋 项目简介

《火山之心》是一款受《火山女儿》启发的养成类游戏。玩家将扮演一位监护人，培养一位与火山有着神秘联系的女孩。

### 核心玩法
- 🏠 **养成系统**：通过日常活动培养角色属性
- 🗺️ **探索冒险**：派遣角色前往火山探索，触发事件
- ⚔️ **回合制战斗**：策略性的战斗系统
- 📖 **多分支剧情**：玩家的选择将影响结局

---

## 🛠️ 技术栈

| 技术 | 版本 | 用途 |
|------|------|------|
| Java | 1.8+ | 编程语言 |
| LibGDX | 1.12.0 | 游戏开发框架 |
| Gradle | (wrapper) | 构建工具 |

---

## 📂 项目结构

```
HeartOfVolcano/
├── assets/              # 游戏资源（图片、音频、数据）
│   ├── images/         # 图片资源
│   ├── fonts/          # 字体文件
│   ├── music/          # 背景音乐
│   ├── sounds/         # 音效
│   └── data/           # 配置文件（JSON等）
│
├── docs/               # 设计文档
│   ├── 01_vision/     # 愿景与设计支柱
│   ├── 02_core-mechanics/  # 核心机制
│   ├── 03_systems/    # 系统设计
│   ├── 04_content/    # 内容设计
│   ├── 05_ux-ui/      # 用户体验
│   ├── sdd/           # 原子任务文档
│   └── tmp/           # 临时文档与Handoff
│
├── src/                # 源代码
│   └── main/
│       ├── java/com/heartofvolcano/
│       │   ├── game/       # 游戏主类
│       │   ├── screens/    # 游戏画面
│       │   ├── entities/   # 游戏实体
│       │   ├── systems/    # 游戏系统
│       │   ├── components/ # 组件
│       │   ├── ui/        # UI相关
│       │   ├── utils/     # 工具类
│       │   ├── data/      # 数据配置
│       │   └── desktop/   # 桌面启动器
│       └── resources/      # 资源文件（备用）
│
├── build.gradle         # Gradle构建文件
├── README.md           # 本文档
└── .gitignore         # Git忽略规则
```

---

## 🚀 快速开始

### 前置要求

- ☕ Java JDK 1.8 或更高版本
- 🐘 Gradle 6.0+（或使用Gradle Wrapper）
- 💻 支持OpenGL 2.0的显卡

### 构建项目

```bash
# 克隆项目
git clone <repository-url>
cd HeartOfVolcano

# 使用Gradle Wrapper构建（推荐）
./gradlew build    # Linux/Mac
gradlew.bat build # Windows

# 或直接使用系统安装的Gradle
gradle build
```

### 运行游戏

```bash
# 运行桌面版
./gradlew run      # Linux/Mac
gradlew.bat run   # Windows

# 或直接运行DesktopLauncher
java -cp build/libs/*.jar com.heartofvolcano.desktop.DesktopLauncher
```

---

## 🎮 操作说明（开发中）

### 当前版本（v0.1.0）
- ✅ 项目初始化完成
- ⏳ 玩家移动机制（待实现）
- ⏳ 场景管理系统（待实现）
- ⏳ 对话系统（待实现）

### 计划功能
- [ ] 玩家移动（WASD）
- [ ] 场景切换
- [ ] 对话与选择
- [ ] 时间系统
- [ ] 战斗系统
- [ ] 多结局

---

## 📚 设计文档

所有设计文档位于 `docs/` 目录下：

1. **总索引**：`docs/INDEX.md` - 所有文档的入口
2. **任务流程**：`docs/sdd/00_TASK_FLOW_GUIDE.md` - 开发任务指引
3. **设计支柱**：`docs/01_vision/01_design-pillars.md` - 核心设计理念

---

## 🤝 贡献指南

### 开发流程

1. 查看 `docs/sdd/00_TASK_FLOW_GUIDE.md` 了解当前任务
2. 选择一个"待执行"任务
3. 读取对应的原子任务文档（`docs/sdd/sdd.TXXX...md`）
4. 按要求执行任务
5. 完成后更新任务状态
6. 生成Handoff文档（`docs/tmp/`）

### 代码规范

- **包命名**：`com.heartofvolcano.*`
- **类命名**：大驼峰命名法（例如：`HeartOfVolcanoGame`）
- **方法命名**：小驼峰命名法（例如：`create()`）
- **常量命名**：全大写+下划线（例如：`MAX_HP`）

---

## 📝 更新日志

### v0.1.0 (2026-06-17)
- ✅ 项目初始化
- ✅ LibGDX配置完成
- ✅ 基础目录结构创建
- ✅ 游戏主类和启动画面创建

---

## 📄 许可证

[待定]

---

## 📧 联系方式

- **项目地址**：[待定]
- **Issue追踪**：[待定]

---

**感谢您关注《火山之心》项目！**