# 星墓坠落 AI 训练环境

这是一个 Gymnasium 风格的轻量训练环境，用来让强化学习或脚本 Agent 练习《星墓坠落》的核心循环：移动、近战、冲锋、自动射击、拾取资源和生存。

## 安装

```bash
cd ai-training
python -m pip install -e .
```

## 快速运行

```python
from tombfall_env import TombfallEnv

env = TombfallEnv()
obs, info = env.reset(seed=42)

for _ in range(1000):
    action = env.action_space.sample()
    obs, reward, terminated, truncated, info = env.step(action)
    if terminated or truncated:
        break

print(info)
```

## 动作空间

`MultiDiscrete([9, 3])`

- 第 1 维：移动方向
  - `0` 停留
  - `1` 上
  - `2` 下
  - `3` 左
  - `4` 右
  - `5` 左上
  - `6` 右上
  - `7` 左下
  - `8` 右下
- 第 2 维：技能
  - `0` 无
  - `1` 近战
  - `2` 冲锋

## 观察空间

`Box(-1, 1, shape=(32,))`

观察值包含：

- 时间、生命、护盾、等级、敌人数量、资源数量、玩家位置。
- 最近 4 个敌人的相对位置和生命。
- 最近 4 个资源的相对位置和价值。

## 示例

```bash
python examples/random_agent.py
```

网页 AI 试玩版见：

- https://tombfall-webgame.pages.dev/ai.html