# 面向对象课程

**Repository Path**: LambdaH/object-oriented-courses

## Basic Information

- **Project Name**: 面向对象课程
- **Description**: 面向对象课程作业（第一组）：针对复杂项目（开源版Minecraft，曾叫Minetest现叫Luanti）的分析。包含了用例图分析、类图分析、顺序图分析和状态图分析。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-22
- **Last Updated**: 2025-12-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Minetest (Luanti) 面向对象分析项目

## 分析对象简介

- **Minetest** 是一个开源的沙盒游戏引擎，类似于Minecraft，但采用C++和Lua编写，具有高度可扩展性。本项目使用面向对象分析方法对Minetest游戏引擎的**核心游戏功能**进行系统建模和分析。
- 项目源代码网址：https://github.com/luanti-org/luanti

### 分析对象特点
- **开源沙盒游戏引擎**：支持多人游戏、模组扩展
- **C++核心引擎**：高性能的游戏逻辑实现
- **Lua脚本系统**：灵活的模组开发支持
- **客户端-服务器架构**：支持多人联机游戏
- **跨平台支持**：Windows、Linux、macOS等

## 作业内容与结构

本项目采用面向对象分析方法，对Minetest游戏引擎在windows平台的实现进行**核心游戏功能**的UML建模，包括用例图、类图、顺序图和状态图。

### 系统边界定义

**建模范围**（包含）：
- ✅ **玩家交互功能**：连接服务器、角色移动、方块交互、物品管理、玩家通信、游戏进度保存
- ✅ **游戏逻辑核心**：世界生成、物理模拟、网络通信、游戏状态管理、界面渲染
- ✅ **服务器管理功能**：服务器启停、权限管理、配置设置、状态监控、数据备份
- ✅ **基础扩展功能**：模组管理、玩家数据管理

**建模范围外**（不包含）：
- ❌ **底层技术实现**：Lua脚本系统、渲染引擎、数据库层、网络协议细节、性能优化机制
- ❌ **平台特定实现**：Android/iOS移动端适配、不同操作系统的底层差异

**建模层次**：
- 主要关注**功能需求层面**而非**技术实现层面**
- 重点描述**用户可见功能**而非**内部技术细节**

### 项目结构树状图

```
面向对象分析/
├── 1.0-README.pdf                    # 项目说明PDF文档
├── 1.1-用例图分析.pdf                # 用例图分析PDF
├── 1.2-类图分析.pdf                  # 类图分析PDF
├── 1.3-顺序图分析.pdf                # 顺序图分析PDF
├── 1.5-状态图分析.pdf                # 状态图分析PDF
├── README.md                         # 项目说明文档
├── 2.图表集合/                       # UML图表输出目录
│   ├── 用例图/
│   │   └── Minetest用例图.png
│   ├── 类图/
│   │   └── Minetest类图.png
│   ├── 顺序图/
│   │   ├── SD-001-玩家连接服务器.png
│   │   ├── SD-001-E1-服务器满员.png
│   │   ├── SD-001-E2-网络超时.png
│   │   ├── SD-002-玩家移动控制.png
│   │   ├── SD-003-方块交互流程.png
│   │   ├── SD-004-网络断开处理.png
│   │   ├── SD-005-聊天系统交互流程.png
│   │   ├── SD-006-物品栏操作流程.png
│   │   ├── SD-007-世界生成流程.png
│   │   ├── SD-008-伤害处理流程.png
│   │   └── SD-009-动态区块加载流程.png
│   └── 状态图/
│       ├── ST-001-游戏引擎状态图.png
│       ├── ST-002-玩家状态图.png
│       ├── ST-003-连接状态图.png
│       ├── ST-004-方块状态图.png
│       ├── ST-005-物品状态图.png
│       ├── ST-006-服务器环境状态图.png
│       ├── ST-007-客户端渲染状态图.png
│       ├── ST-008-物品栏和合成状态图.png
│       ├── ST-009-世界生成状态图.png
│       └── ST-010-状态图交互关系.png
├── 附录1：编写文档：md和puml文件/     # 分析文档和源码目录
│   ├── puml文件/
│   │   ├── use-case.puml
│   │   ├── 类图.puml
│   │   ├── 顺序图.puml
│   │   └── 状态图.puml
│   ├── 用例图分析.md
│   ├── 类图分析.md
│   ├── 顺序图分析.md
│   └── 状态图分析.md
└── 附录2：分析对象核心源码/           # 核心源码参考目录
    ├── builtin/                      # 内置Lua脚本
    ├── doc/                          # 开发文档
    └── src/                          # C++核心源码
```
## 使用说明

### 快速查看（推荐给批改者）
1. **查看PDF分析文档**: 直接打开根目录下的PDF文件（如 `1.0-README.pdf`、`1.1-用例图分析.pdf` 等）
2. **查看UML图表**: 在 `2.图表集合/` 目录下查看对应的PNG图表文件

### 详细查看（推荐给开发者）
1. **查看分析文档**: 在 `附录1：编写文档：md和puml文件/` 目录下查看对应的 `.md` 文件
2. **查看UML源码**: 在 `附录1：编写文档：md和puml文件/puml文件/` 目录下查看PlantUML源码
3. **编辑UML源码**: 修改对应的 `.puml` 文件后重新生成图表
4. **生成图表**: 使用PlantUML工具生成PNG文件

### 源码参考
- **核心源码**: 在 `附录2：分析对象核心源码/` 目录下查看Minetest的核心源码
  - **C++源码**: `src/` 目录包含游戏引擎的核心C++实现
  - **Lua脚本**: `builtin/` 目录包含内置Lua脚本
  - **开发文档**: `doc/` 目录包含开发文档和API参考


## UML建模内容

### 1. 用例图 (Use Case Diagram)
**文件**: `附录1：编写文档：md和puml文件/用例图分析.md`, `附录1：编写文档：md和puml文件/puml文件/use-case.puml`
**图表**: `2.图表集合/用例图/Minetest用例图.png`
- **系统边界**: Minetest游戏系统
- **主要参与者**: 玩家、服务器管理员、模组开发者
- **核心用例**: 连接游戏、移动控制、方块交互、物品管理、聊天系统等
- **扩展用例**: 模组开发、服务器管理、世界生成

### 2. 类图 (Class Diagram)
**文件**: `附录1：编写文档：md和puml文件/类图分析.md`, `附录1：编写文档：md和puml文件/puml文件/类图.puml`
**图表**: `2.图表集合/类图/Minetest类图.png`
- **核心类**: Game、Client、Server、Player、Map、Inventory等
- **类关系**: 继承、关联、聚合、组合、依赖
- **设计模式**: 观察者模式、工厂模式、单例模式
- **系统架构**: 客户端-服务器架构、组件化设计

### 3. 顺序图 (Sequence Diagram)
**文件**: `附录1：编写文档：md和puml文件/顺序图分析.md`, `附录1：编写文档：md和puml文件/puml文件/顺序图.puml`
**图表**: `2.图表集合/顺序图/` 目录下的所有PNG文件
- **SD-001**: 玩家连接服务器流程（含异常处理）
- **SD-002**: 玩家移动控制流程
- **SD-003**: 方块交互流程
- **SD-004**: 网络断开处理流程
- **SD-005**: 聊天系统交互流程
- **SD-006**: 物品栏操作流程
- **SD-007**: 世界生成流程（服务器初始化）
- **SD-008**: 伤害处理流程
- **SD-009**: 动态区块加载流程（游戏过程中）

### 4. 状态图 (State Diagram)
**文件**: `附录1：编写文档：md和puml文件/状态图分析.md`, `附录1：编写文档：md和puml文件/puml文件/状态图.puml`
**图表**: `2.图表集合/状态图/` 目录下的所有PNG文件
- **ST-001**: 游戏引擎状态图
- **ST-002**: 玩家状态图
- **ST-003**: 连接状态图
- **ST-004**: 方块状态图
- **ST-005**: 物品状态图
- **ST-006**: 服务器环境状态图
- **ST-007**: 客户端渲染状态图
- **ST-008**: 物品栏与合成状态图
- **ST-009**: 世界生成状态图
- **ST-010**: 状态图交互关系图

## 技术规格

### 建模标准
- **UML版本**: UML 2.5
- **建模工具**: PlantUML

### 文件命名规范
- **分析文档**: `{图表类型}分析.md`
- **源码文件**: `{图表类型}.puml`
- **输出文件**: `{图表编号}-{图表名称}.png`



## 更新历史

- **2025-12-19**: 修正顺序图SD-009名称，从"世界生成流程"改为"动态区块加载流程"
- **2025-12-20**: 更新项目结构，统一文件组织方式
- **2025-12-22**: 完善各分析文档内容