# scary-text-game

**Repository Path**: shadow_14/scary-text-game

## Basic Information

- **Project Name**: scary-text-game
- **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-02-25
- **Last Updated**: 2026-02-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 疯人院噩梦 (Asylum Nightmare)

一个恐怖风格的文字冒险游戏，玩家需要在一个充满谜团和危险的疯人院中生存并寻找真相。

## 项目简介

《疯人院噩梦》是一款基于 Web 的恐怖文字冒险游戏，玩家扮演一名在精神病院中醒来的患者，需要通过探索、收集线索、解开谜题来揭示隐藏在这座疯人院中的恐怖真相。

游戏采用分支剧情设计，玩家的不同选择将影响故事发展，最终导向多个不同的结局。

## 功能特性

### 🎮 核心玩法
- **分支剧情**：丰富的选择系统，每个决定都可能影响后续剧情
- **多结局系统**：8+ 个不同结局，探索所有路线以揭开全部真相
- **状态系统**：生命值SAN值管理，不同状态影响游戏体验
- **道具系统**：收集和使用各种道具帮助通关

### 🏥 场景探索
- **病房区域**：初始苏醒地点，包含多种探索选项
- **走廊区域**：连接各处的通道，充满危险与机遇
- **地下室**：隐藏着最黑暗的秘密
- **隐藏区域**：包含镜中世界、真相之屋等特殊场景

### 🎨 视觉与音效
- **恐怖氛围**：沉浸式的黑暗主题 UI 设计
- **场景图片**：AI 生成的精美场景插图
- **音效系统**：根据场景切换的背景音乐和音效
- **打字机效果**：文字逐步显示，增强恐怖感

### 🛠️ 开发工具
- **场景编辑器**：内置剧本编辑功能
- **图片生成工具**：集成火山引擎 AI 图片生成
- **场景检查器**：自动检测和修复场景连接问题

## 技术栈

- **前端框架**：React + Vite
- **游戏引擎**：原生 JavaScript
- **样式**：CSS3（恐怖主题设计）
- **AI 集成**：火山引擎（图片生成）

## 项目结构

```
├── src/                    # React 源代码
│   ├── components/         # React 组件
│   ├── contexts/           # React Context
│   ├── styles/             # 样式文件
│   ├── App.jsx             # 主应用
│   └── main.jsx            # 入口文件
├── js/                     # 原生 JavaScript 版本
│   ├── game.js             # 游戏主逻辑
│   ├── gameEngine.js       # 游戏引擎
│   ├── sceneLoader.js      # 场景加载器
│   └── ...
├── scenes/                 # 场景文件目录
│   ├── prologue/           # 序章场景
│   ├── room/               # 病房场景
│   ├── corridor/           # 走廊场景
│   ├── basement/           # 地下室场景
│   ├── ending/             # 结局场景
│   └── secret/             # 隐藏场景
├── scripts/                # 剧本文件
├── tools/                  # 开发工具脚本
├── assets/                 # 静态资源
└── css/                    # 样式文件
```

## 快速开始

### 安装依赖

```bash
npm install
```

### 启动开发服务器

```bash
npm run dev
```

### 构建生产版本

```bash
npm run build
```

## 游戏操作

1. **开始游戏**：选择剧本进入游戏
2. **探索场景**：阅读剧情文字，了解当前处境
3. **做出选择**：点击选项按钮决定下一步行动
4. **管理状态**：注意生命值和SAN值，合理使用道具
5. **探索真相**：收集线索，解开疯人院隐藏的秘密

## 开发指南

### 添加新场景

在 `scenes/` 目录下创建新的 JSON 文件，遵循场景格式规范。

### 使用场景编辑器

通过游戏内置的编辑器可以：
- 创建和编辑场景
- 设置场景连接
- 添加选择分支
- 配置触发条件

### 运行开发工具

```bash
# 检查场景连接
python tools/scene_checker.py

# 修复场景问题
python tools/connection_fixer.py

# 生成场景图片
python tools/generate_scene_images.py
```

## 配置说明

### API 密钥配置

在 `.api_keys.md` 文件中配置火山引擎 API 密钥以启用 AI 图片生成功能。

### 游戏设置

通过设置面板可以调整：
- 文字显示速度
- 音效音量
- 背景音乐开关
- 震动效果

## 许可证

本项目仅供学习和交流使用。

## 贡献者

感谢所有为项目提供帮助的开发者。