# ByGame

**Repository Path**: byusistudio/bygame

## Basic Information

- **Project Name**: ByGame
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-18
- **Last Updated**: 2025-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ByGame

这是一个跨平台的互动小说游戏引擎，提供文本冒险游戏所需的核心功能。项目包含C++和Python两种实现版本。

## 主要功能
- 文字打印效果（打字机效果）
- 游戏状态管理
- 进度保存与加载
- 交互式选择系统
- 跨平台支持（通过不同实现）

## 技术架构
项目包含两个主要实现：
1. C++实现（在`c/`目录下）
   - 使用nlohmann/json进行数据处理
   - 包含终端颜色库实现UI效果
   - 提供两种主程序实现(main.cpp和main2.cpp)

2. Python实现（在`python/`目录下）
   - 面向对象设计
   - 简洁的API接口
   - 更易扩展和修改

## 核心数据结构
### 游戏状态(GameState)
统一的状态管理结构：
```cpp
// C++版本示例
struct GameState {
    string currentNode; // 当前节点
    json data; // 游戏数据
    string playerName; // 玩家名称
    unordered_map<string, string> characterDescriptions; // 角色描述
    // ...其他扩展字段
}
```

```python
# Python版本示例
class GameState:
    def __init__(self):
        self.current_node = "" # 当前节点
        self.data = {} # 游戏数据
        self.player_name = "玩家" # 玩家名称
        self.character_descriptions = {} # 角色描述
```

## 开发者指南
### 构建C++版本
```bash
cd c/
./build.sh
```

### Python依赖
```bash
pip install -r python/requirements.txt
```

## 特色功能
- 文字渐现效果（typewriter effect）
- 动态内容加载
- 多分支剧情支持
- 简单的存档/读档机制

## 许可协议
请查看项目根目录的LICENSE文件获取许可信息。