# TrainerForge

**Repository Path**: kill-life/trainer-forge

## Basic Information

- **Project Name**: TrainerForge
- **Description**: TrainerForge 让你在 Linux 上为 Wine/Proton 游戏一键启动风灵月影（FLiNG）等 Windows 修改器。右键托盘图标，选择游戏，完成。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://gitee.com/kill-life/trainer-forge
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-19
- **Last Updated**: 2026-05-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ⚒ TrainerForge

<p align="center">
  <img src="trainerforge/resources/icon.svg" width="128" alt="TrainerForge Icon">
</p>

<p align="center">
  <strong>跨平台 Linux 游戏修改器启动器 — 支持 Wine/Proton</strong>
</p>

<p align="center">
  <a href="#-功能特性">功能</a> ·
  <a href="#-快速开始">快速开始</a> ·
  <a href="#-安装">安装</a> ·
  <a href="#-使用方法">使用方法</a> ·
  <a href="docs/zh/">文档</a> ·
  <a href="README_EN.md">English</a>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/platform-linux-blue?style=flat-square" alt="Platform">
  <img src="https://img.shields.io/badge/python-3.8+-green?style=flat-square" alt="Python">
  <img src="https://img.shields.io/badge/license-MIT-orange?style=flat-square" alt="License">
  <img src="https://img.shields.io/badge/packaging-deb%20%7C%20rpm%20%7C%20appimage-red?style=flat-square" alt="Packaging">
</p>

---

TrainerForge 让你在 Linux 上为 Wine/Proton 游戏**一键启动**风灵月影（FLiNG）等 Windows 修改器。右键托盘图标，选择游戏，完成。

- **🖱 一键启动** — 托盘图标 → 选择游戏 → 修改器自动在正确的 Proton prefix 中启动
- **🔍 自动检测** — Steam（原生/Flatpak/Snap）、Proton、Wine、UMU、compatdata 全自动发现
- **🎨 三款主题** — 暗色 / 亮色 / Mac 紫，实时切换
- **🌐 中英文切换** — 即时生效，无需重启
- **📦 自包含设计** — 所有配置和数据存于安装目录；卸载零残留
- **🛡 单实例锁** — 重复启动自动聚焦已有窗口
- **🌍 跨发行版** — .deb / .rpm / AppImage 三种包格式

## 📸 截图

| 主窗口 (中文) | 设置页 (中文) | 主窗口 (英文) |
|:---:|:---:|:---:|
| ![main_cn](img/main_page_cn.png) | ![settings_cn](img/setting_page_cn.png) | ![main_en](img/main_page_en.png) |

## 🚀 快速开始

### 前置条件

1. 系统已安装 **Steam**（[官网下载](https://store.steampowered.com/about/) 或 `sudo apt install steam`）
2. Steam → 设置 → 兼容性 → 启用 **"为所有产品启用 Steam Play"** → 选择 **Proton Experimental**

![Steam 设置](img/steam_setting.png)

### 安装

```bash
# 安装 .deb 包
sudo dpkg -i trainerforge_*.deb
trainerforge

# 或从源码运行
git clone https://github.com/KingYueKong/TrainerForge
cd TrainerForge
python3 -m trainerforge
```

## 📦 安装

| 格式 | 命令 | 适用发行版 |
|--------|---------|--------|
| **.deb** | `sudo dpkg -i trainerforge_*.deb` | Ubuntu、Debian、Mint、Pop!_OS |
| **.rpm** | `sudo rpm -i trainerforge-*.rpm` | Fedora、RHEL、OpenSUSE |
| **AppImage** | `chmod +x TrainerForge-*.AppImage && ./TrainerForge-*.AppImage` | 任意 Linux |
| **源码** | `python3 -m trainerforge` | 任意 Linux |

唯一硬依赖 `python3-pyqt5`，主流发行版均预装：

```bash
# Ubuntu/Debian
sudo apt install python3-pyqt5

# Fedora
sudo dnf install python3-qt5

# Arch
sudo pacman -S python-pyqt5
```

## 🎮 使用方法

### 1. 添加游戏

- 打开 TrainerForge（系统托盘图标）
- 点击 **＋ 添加**
- 填写：
  - **游戏进程名** — Windows .exe 文件名（如 `AI-LIMIT.exe`）
  - **修改器路径** — 修改器 .exe 完整路径
  - **Proton Prefix** — 点击自动检测，或从列表选择
  - **Proton Wine** — 点击自动查找

### 2. 启动修改器

- **先在 Steam/Lutris 中启动游戏**
- 右键 TrainerForge 托盘图标
- 选择 `▶ 启动修改器 — 游戏名`
- 修改器在同一 Proton prefix 中启动

### 3. 快速启动

如果游戏已在运行，右键托盘 → **⚡ 快速启动** 自动为其启动修改器。

## 🔧 配置

所有配置存储在 `<安装目录>/config/config.json`（自包含）。示例：

```json
{
  "entries": [
    {
      "game_exe": "AI-LIMIT.exe",
      "trainer_path": "/games/AI Limit/AI Limit Trainer.exe",
      "prefix": "/home/user/.local/share/Steam/steamapps/compatdata/2637722757/pfx/",
      "proton_wine": "/home/user/.local/share/Steam/steamapps/common/Proton - Experimental/files/bin/wine",
      "delay": 5,
      "use_delay": true
    }
  ],
  "settings": {
    "theme": "dark",
    "language": "zh",
    "auto_start": false
  }
}
```

## 🧹 卸载

```bash
# 完全清除 — 不留任何痕迹
bash /opt/trainerforge/uninstall.sh

# 或通过包管理器
sudo dpkg -r trainerforge   # .deb
sudo rpm -e trainerforge    # .rpm
```

## 📄 协议

MIT — 详见 [LICENSE](LICENSE) 文件。

---

<p align="center">
  Made for Linux gamers who want their trainers without the hassle.
</p>