# GodotCSharpSteamTracker

**Repository Path**: haomaker/godot-csharp-steam-tracker

## Basic Information

- **Project Name**: GodotCSharpSteamTracker
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-15
- **Last Updated**: 2025-12-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GodotCSharpSteamTracker

## 项目简介

GodotCSharpSteamTracker 是一个专为 C# 版本 Godot 引擎设计的 Steam 时长追踪启动器。它解决了 C# 版本 Godot 在打开项目时导致 Steam 无法持续追踪游戏时长的问题，确保您的游戏时长能够被 Steam 准确记录。

## 功能特点

- ✅ **Steam 时长准确追踪**：解决 Godot C# 版本打开项目时 Steam 无法追踪的问题
- ✅ **INI 配置文件支持**：灵活的配置选项，支持自定义 Godot 路径和控制台显示状态
- ✅ **控制台显示/隐藏控制**：可通过配置文件设置是否显示控制台窗口
- ✅ **全中文界面**：友好的中文提示，提供更好的用户体验
- ✅ **体积小巧**：使用 NativeAOT 编译，文件体积仅约 1.8MB
- ✅ **独立可执行文件**：无需安装 .NET 运行时，直接运行
- ✅ **智能进程监控**：自动监控所有 Godot 进程，当所有 Godot 窗口关闭时自动退出

## 工作原理

Steam 会追踪启动器进程，而启动器会：
1. 从配置文件读取 Godot 可执行文件路径
2. 启动 Godot 进程
3. 监控所有 Godot 进程
4. 当所有 Godot 进程退出时，启动器也随之退出

这样即使 Godot 因打开项目等原因导致 Steam 无法直接追踪，启动器进程也能持续被 Steam hook，从而确保游戏时长的准确计算。

## 使用方法

### 1. 首次运行

1. 下载并运行 `GodotCSharpSteamTracker.exe`
2. 程序会自动在同一目录创建 `GodotLaunch.ini` 配置文件
3. 程序会提示您编辑配置文件，按任意键退出

### 2. 编辑配置文件

使用文本编辑器打开 `GodotLaunch.ini` 文件，设置以下配置：

```ini
[GodotLaunch]
# 请设置正确的 Godot 可执行文件路径
GodotPath=C:\Program Files\Godot\Godot_v4.5.1-stable_mono_win64.exe

# 是否显示控制台窗口 (true/false)
ShowConsole=true
```

### 3. 运行启动器

再次运行 `GodotCSharpSteamTracker.exe`，启动器会：
1. 读取配置文件
2. 启动 Godot 进程
3. 根据配置决定是否隐藏控制台
4. 监控所有 Godot 进程
5. 当所有 Godot 进程退出时，启动器也随之退出

## 配置选项

| 配置项 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| GodotPath | string | 无 | Godot 可执行文件的完整路径 |
| ShowConsole | bool | true | 是否显示控制台窗口 |

## 构建说明

如果您需要自己构建项目：

1. 确保安装了 .NET 8.0 SDK 或更高版本
2. 克隆或下载项目源码
3. 打开命令行工具，进入项目目录
4. 运行以下命令构建发布版本：

```bash
dotnet publish -c Release -r win-x64
```

构建完成后，可执行文件将位于：
`bin\Release\net8.0-windows\win-x64\publish\GodotCSharpSteamTracker.exe`

## 常见问题

### Q: 为什么我的配置文件没有被创建？
A: 请检查程序是否有写入权限，或者尝试以管理员身份运行一次。

### Q: 为什么控制台显示乱码？
A: 程序已设置为 UTF-8 编码，如果仍有乱码，请确保您的控制台使用 UTF-8 编码。

### Q: 为什么启动器没有自动退出？
A: 启动器会等待所有 Godot 进程退出后才会退出，请确保您已关闭所有 Godot 窗口。

### Q: 如何隐藏控制台窗口？
A: 在配置文件中将 `ShowConsole` 设置为 `false`，启动器会在初始化后隐藏控制台。

## 许可证

本项目采用 MIT 许可证，您可以自由使用、修改和分发。

## 更新日志

### v1.0.0
- 初始版本
- 支持 Steam 时长追踪
- 支持 INI 配置文件
- 支持控制台显示/隐藏控制
- 全中文界面
- 体积小巧（约 1.8MB）

## 贡献

欢迎提交 Issue 和 Pull Request 来帮助改进这个项目！

## 联系方式

如果您有任何问题或建议，请在 GitHub 上提交 Issue。