# beast-legend

**Repository Path**: GProReat_admin/beast-legend

## Basic Information

- **Project Name**: beast-legend
- **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-05-03
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Beast Legend - 神兽传说

2D 俯视角即时战斗 ARPG，基于 LÖVE2D 引擎。

## 操作

| 按键 | 功能 |
|------|------|
| W A S D | 移动 |
| J | 攻击（近战斩击） |
| ESC | 退出游戏 |

## 玩法

- 在随机生成的地图上探索，**野怪**会在地图上随机刷新
- 靠近野怪会自动攻击你，靠近敌人按 **J** 攻击
- **神兽**会跟随你自动战斗，遇敌自动靠近攻击
- 击败野怪获得**经验值**，攒满经验升级
- 每升 1 级：HP+20, ATK+3, DEF+2

## 神兽

初始神兽：**炎龙** 🔥

神兽种类：
- 炎龙（火属性）
- 冰凤（冰属性）
- 雷狼（雷属性）
- 岩龟（地属性）
- 暗影豹（暗属性）

## 野怪

- 野狼、毒蛇、野猪、蝙蝠、熊

## 字体

游戏目录需要放置 `msyh.ttc`（微软雅黑字体文件）以正常显示中文字体。
没有该文件则使用默认字体，英文可正常显示。

## 启动

双击 `start.bat` 或拖拽游戏目录到 `love.exe` 上运行。

---

## UML 类图 & 时序图查看器

`uml/` 文件夹是一个独立的 LÖVE2D 项目，用于可视化查看 Beast Legend 的架构设计。

### 启动

```bash
cd H:\lovegame\beast-legend\uml
"D:\softdir\love-11.5-win64\love.exe" .
```

或双击 `uml/start.bat`。

### 功能

- **Tab 键** 切换：类图 (Class Diagram) ↔ 时序图 (Sequence Diagram)
- **鼠标拖拽** 移动类图位置
- **滚轮** 缩放
- **鼠标悬停** 高亮关联关系

### 模块关系图 (类图)

展示了 Beast Legend 的核心模块结构与关系：

| 类 | 说明 |
|------|------|
| `Entity` | 实体基类：HP, ATK, DEF, 移动, 攻击 |
| `Hero` | 玩家角色，继承自 `Entity` |
| `Beast` | 神兽，继承自 `Entity`，通过 `Spawner` 生成 |
| `Monster` | 野怪，继承自 `Entity` |
| `SceneManager` | 场景管理：村庄、草原、沙漠、雪原等区域切换 |
| `MapManager` | 地图系统：小地图 + 大地图 |
| `Spawner` | 怪物生成器：按区域类型生成对应怪物 |
| `NPCDialogue` | NPC 对话系统 |
| `QuestManager` | 任务系统：主线 + 支线 |
| `BattleManager` | 战斗系统：近战、技能、属性克制 |
| `Camera` | 相机跟随 |
| `SaveManager` | 存档管理 |

### 关系说明

| 关系 | 含义 |
|------|------|
| 实线箭头 → | 关联：一个类使用另一个类 |
| 空心三角 → | 继承：子类继承父类 |
| 虚线箭头 → | 依赖：临时使用 |
| 空心菱形 → | 聚合：整体包含部分 |
| 实心菱形 → | 组合：强归属关系 |

### 时序图

预设了关键流程的时序图，例如：

- **战斗流程**：Hero → Monster 攻击 → Beast 协助
- **场景切换流程**：Hero → SceneManager 切场景 → MapManager 更新
- **任务流程**：Hero → NPC 接任务 → QuestManager 追踪 → 完成奖励