# Goose Adventure Game

> 《尼尔斯骑鹅旅行记》文字冒险游戏引擎。创建一个基于Python的互动文字游戏，包含完整的剧情系统、状态管理、存档功能和成就系统。当用户需要：创建文字冒险游戏、开发互动故事系统、构建游戏引擎、实现存档管理、设计分支剧情时使用此skill。

- Skill: `insight68/goose-adventure-game` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add insight68/goose-adventure-game`
- Raw SKILL.md: https://api.skillmd.com/api/skills/insight68/goose-adventure-game/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: insight68 (https://skillmd.com/u/insight68)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/insight68/goose-adventure-game

---


# 鹅骑鹅冒险游戏引擎

## 概述

这是一个完整的文字冒险游戏引擎，专为《尼尔斯骑鹅旅行记》故事设计。游戏引擎支持：

- **剧情节点系统** - 分支叙事，多个结局
- **状态管理** - 生命值、道德值、大小值、知识值
- **存档系统** - 多槽位存档，自动保存
- **成就系统** - 追踪玩家成就
- **物品栏管理** - 收集和使用物品
- **条件触发** - 基于状态的选项解锁

## 快速开始

### 1. 运行游戏

```bash
# 使用 Python 运行游戏引擎
python3 scripts/game_engine.py

# 或使用 pnpm（如果需要）
pnpm run game
```

### 2. 游戏文件结构

```
goose-adventure-game/
├── scripts/
│   ├── game_engine.py      # 游戏引擎主类
│   ├── game_script.json    # 游戏剧本数据
│   └── save_manager.py     # 存档管理器
├── saves/                  # 存档目录（自动创建）
└── SKILL.md               # 本文档
```

### 3. 基本使用

```python
from scripts.game_engine import GameEngine, load_script_from_file

# 加载游戏脚本
script = load_script_from_file("scripts/game_script.json")

# 创建游戏引擎
engine = GameEngine(script, save_dir="./saves")

# 渲染当前场景
scene = engine.render_scene()
print(f"{scene['title']}\n{scene['description']}")

# 显示选项
for choice in scene['choices']:
    print(f"{choice['index']}: {choice['text']}")

# 玩家做出选择
engine.make_choice(0)  # 选择第一个选项

# 保存游戏
engine.save_game("slot1")
```

## 核心功能

### 1. 游戏状态系统

游戏状态包含以下属性：

| 属性 | 类型 | 范围 | 说明 |
|------|------|------|------|
| `hp` | int | 0-100 | 生命值 |
| `morality` | int | 0-100 | 道德值（决定结局） |
| `size` | int | 0-100 | 大小值（0=拇指大小，100=正常） |
| `knowledge` | int | 0-1000 | 知识值 |
| `inventory` | list | - | 物品栏 |
| `achievements` | list | - | 成就列表 |
| `flags` | dict | - | 事件标志 |

### 2. 场景系统

每个场景包含：

```json
{
  "id": "scene_id",
  "title": "场景标题",
  "description": "场景描述",
  "choices": [
    {
      "text": "选项文本",
      "next_scene": "下一场景ID",
      "requirements": {
        "morality_min": 50,
        "has_item": "key"
      },
      "effects": {
        "moral_change": 10,
        "add_item": "key",
        "set_flag": {"met_npc": true}
      }
    }
  ]
}
```

### 3. 条件触发系统

支持的触发条件：

- `has_item` - 检查物品
- `flag` - 检查事件标志
- `morality_min/max` - 道德值范围
- `size_min/max` - 大小值范围
- `has_achievement` - 检查成就

### 4. 效果系统

支持的效果类型：

- `add_item` / `remove_item` - 物品管理
- `hp_change` - 生命值变化
- `size_change` - 大小值变化
- `set_flag` - 设置事件标志
- `add_achievement` - 添加成就
- `moral_change` - 道德值变化
- `knowledge_gain` - 获得知识

## 存档系统

### 使用存档管理器

```python
from scripts.save_manager import SaveManager

manager = SaveManager(save_dir="./saves")

# 保存游戏
manager.save_game("slot1", game_data)

# 加载游戏
game_data = manager.load_game("slot1")

# 列出所有存档
saves = manager.list_saves()

# 删除存档
manager.delete_save("slot1")
```

### 自动保存

```python
from scripts.save_manager import AutoSaveManager

auto_save = AutoSaveManager(manager, auto_save_interval=5)

# 每个场景变化后检查
auto_save.on_scene_change("autosave", game_data)

# 强制保存
auto_save.force_save("quicksave", game_data)
```

## 游戏剧本编辑

### 添加新场景

在 `game_script.json` 的 `scenes` 数组中添加：

```json
{
  "id": "my_new_scene",
  "chapter": 1,
  "title": "新场景标题",
  "description": "场景描述...",
  "choices": [
    {
      "text": "选项1",
      "next_scene": "scene_a"
    },
    {
      "text": "选项2",
      "next_scene": "scene_b",
      "requirements": {"morality_min": 50},
      "effects": {"moral_change": 10}
    }
  ]
}
```

### 添加新结局

在 `game_script.json` 的 `endings` 数组中添加：

```json
{
  "id": "special_ending",
  "title": "特殊结局",
  "description": "结局描述...",
  "requirements": {
    "morality_min": 80,
    "flag": ["special_event", true]
  }
}
```

## 成就系统

### 预定义成就

游戏包含以下成就：

- 🥚 初章：变小的人 - 完成第一章
- 🕊️ 翅膀的守护者 - 救下莫顿
- 🦊 狐狸的死敌 - 帮助雁群对抗狐狸
- 🌍 自然观察者 - 知识值达到100
- 📚 小小博物学家 - 知识值达到300
- 🗺️ 地理大师 - 知识值达到500
- ⭐ 智慧之星 - 知识值达到800
- 💖 善良之心 - 道德值达到80
- 🦸‍♂️ 真正的勇者 - 达成完美结局

### 添加自定义成就

在场景的效果中添加：

```json
{
  "effects": {
    "add_achievement": "🏆 自定义成就"
  }
}
```

## 游戏调试

### 查看当前状态

```python
state = engine.state
print(f"生命值: {state.hp}")
print(f"道德值: {state.morality}")
print(f"知识值: {state.knowledge}")
print(f"物品: {state.inventory}")
print(f"成就: {state.achievements}")
```

### 跳转到指定场景

```python
engine.state.current_scene = "target_scene_id"
```

### 设置状态值

```python
engine.state.morality = 80
engine.state.knowledge = 500
engine.state.inventory.append("special_item")
```

## 扩展游戏

### 创建自定义故事

1. 复制 `game_script.json` 作为模板
2. 修改 `game_info` 中的标题和描述
3. 编辑或替换 `scenes` 数组中的场景
4. 更新 `endings` 数组中的结局

### 添加新功能

游戏引擎采用模块化设计，可以轻松扩展：

- 在 `GameEngine` 类中添加新方法
- 在 `GameState` 类中添加新属性
- 创建新的效果类型

## 最佳实践

### 游戏设计

1. **道德选择** - 提供有意义的选择，让玩家思考
2. **循序渐进** - 从简单开始，逐步增加复杂性
3. **反馈清晰** - 让玩家了解选择的后果
4. **多结局** - 根据玩家选择提供不同结局

### 剧情编写

1. **描述生动** - 使用感官语言描述场景
2. **选项明确** - 每个选项应该清晰表达后果
3. **逻辑一致** - 确保剧情逻辑连贯
4. **知识融入** - 在剧情中自然地融入知识

### 技术实现

1. **数据驱动** - 将故事数据与引擎代码分离
2. **可测试性** - 确保每个功能都可以独立测试
3. **错误处理** - 优雅处理加载失败等情况
4. **性能优化** - 避免重复加载资源