Linesight

Linesight 是一个强化学习项目，旨在将 AI 在 Trackmania 中的应用推向极限。

Trackmania

Trackmania 是一款赛车游戏，它牺牲了一些模拟赛车的写实性，转而提供种类繁多的赛道类型，并包含各种技巧，如贴墙行驶、特技跳跃和“穿墙”等。此外，Trackmania 在设计上注重输入设备的公平性，这意味着使用键盘也能流畅游玩，从而使得 DQN 等离散输入算法得以应用。换句话说，Trackmania 是一款深度极高的游戏，可以作为测试和优化各类强化学习算法的理想基准。

Trackmania 界面

我们的工作，结合 donadigo 和 Kim 所属的 Trackmania Interface 团队 的努力，实现了与 Trackmania Nations Forever 的对接。通过这一接口，用户可以以编程方式发送输入、获取车辆状态、截取屏幕截图等。这部分代码库对其他强化学习项目也可能具有参考价值。

成果

据我们所知，Linesight 是目前 Trackmania 领域中最先进的 AI。它于 2023 年 5 月首次展现出人类级别的驾驶水平，并在同年 6 月与职业选手 Wirtual 进行了对战（观看视频）。到了 2024 年 5 月，Linesight 又率先展示了在官方战役赛道上打破世界纪录的能力（观看视频）。

如今，该项目已开源，您能否帮助我们进一步提升它的实力呢？

Linesight 快速上手指南

Linesight 是一个针对赛车游戏《Trackmania》的强化学习项目，旨在探索 AI 在该游戏中的极限表现。它支持离散输入算法（如 DQN），能够模拟人类甚至超越世界纪录的驾驶水平。

环境准备

在开始之前，请确保满足以下系统要求和前置依赖：

• 操作系统: 推荐 Windows 10/11 或 Linux（需兼容 Wine/Proton 运行游戏）。
• 游戏版本: 必须安装 Trackmania Nations Forever (TMNF)。
  • 注意：Linesight 目前主要基于 TMNF 版本开发，而非最新的 Trackmania (2020)。
• Python 环境: Python 3.8 或更高版本。
• 硬件要求: 推荐使用 NVIDIA GPU 以加速训练过程（需安装对应的 CUDA 驱动）。
• 前置依赖:
  • Git
  • pip (Python 包管理工具)
  • Trackmania Interface (通常由项目自动处理或需单独配置 DLL)

提示：国内开发者建议使用国内镜像源加速 Python 包下载，例如清华源或阿里源。

安装步骤

1. 克隆仓库 将 Linesight 源代码克隆到本地：

   git clone https://github.com/linesight-rl/linesight.git
   cd linesight
   

2. 创建虚拟环境 建议创建一个独立的 Python 虚拟环境以避免依赖冲突：

   python -m venv venv
   # Windows
   venv\Scripts\activate
   # Linux/macOS
   source venv/bin/activate
   

3. 安装依赖 使用 pip 安装项目所需依赖。推荐使用国内镜像源加速：

   pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
   

4. 配置游戏接口 确保 Trackmania Nations Forever 已安装，并且项目能够正确调用 TMInterface。如果是首次运行，可能需要在游戏目录下确认相关 DLL 文件或按照项目文档进行额外的接口配置。

基本使用

安装完成后，你可以尝试运行一个简单的测试或启动训练流程。以下是最基础的使用示例：

• 运行测试脚本 验证环境是否配置成功，并观察 AI 与游戏的交互：

  python scripts/test_connection.py
  

• 启动训练 使用默认配置开始训练模型（请确保游戏处于可运行状态）：

  python train.py --config configs/default_config.yaml
  

• 加载预训练模型进行演示 如果你已下载预训练权重，可以运行推理查看 AI 驾驶表现：

  python infer.py --model_path models/pretrained_model.pt --track maps/campaign/A01_race.Stadium.Gbx
  

注意：具体命令参数可能随版本更新有所变化，详细的高级配置和自定义赛道设置请参考官方文档：Linesight Documentation。