GTA5_脚本_更新器

GTA5_脚本_更新器

GTA5 脚本更新器是一款 PySide6 桌面应用程序，旨在清点 GTA V 脚本和插件、管理其本地状态并自动检查更新……

GTA5_脚本_更新器预览查看大图

preview

-Features

  • 全面扫描脚本（.asi、.NET、RPH 等）
  • 直接访问配置 .ini 文件
  • 快速启用/禁用脚本
  • 检测并显示激活按键
  • 更新检查（GTA5-Mods、Nexus、LSPDFR、GitHub）
  • 手动编辑信息（版本、链接、热键、INI）
  • 配置文件系统（保存/加载配置）
  • 配置文件导出（current_profile.txt），用于分享或调试
  • 脚本日志标签页，提供错误分析和颜色标记
  • 多语言支持（法语 / 英语）
  • 深色和浅色主题

-Instalation

建议使用 Python 3.11 或更高版本。从项目文件夹中执行：

py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -r requirements.txt
python main.py

-Usage and details

#- 应用程序提供法语和英语版本（此选项可在偏好设置中找到）。如果有足够的需求，可能会添加对其他语言的支持。

#- 请优先手动输入！（你可以运行“更新”扫描，但仅限首次设置时。）这对 [URLs] 尤为重要；它可以防止应用程序不得不自动搜索它们，因为自动搜索会消耗大量请求。（这样做可能会导致你因每分钟请求限制而被网站封禁。）此外，应用程序可能并不总能找到正确的 URL（甚至可能选错，尤其是当多个脚本同名时）。强烈建议为每个条目提供完整信息，以获得最佳性能和易用性。手动修改条目的更多详情

#- 应用程序通过以下渠道搜索：

#- 别忘了输入你的 LCPDFR 和 Nexus Mods API 密钥（可通过你的个人账户申请获取；参见偏好设置菜单）。没有这些密钥，扫描将受到限制，可能无法检测到脚本的更新。

#- 应用程序永远不会替你下载脚本！你可以通过点击“page”（访问网站页面）来手动下载。本软件并非为了取代 gta5-mods.com、Nexus 或 LSPDFR 等官方网站。

它只是让你快速检查你的脚本是否有可用更新。考虑到我们大多数人至少有 50 个脚本，逐个检查会变得繁琐且耗时。（这假设你已经保存了 URL；否则会更慢，而且你可能会打开错误的页面，因为有时会有多个同名脚本……）

#- GTA5-mods API 密钥是一项实验性功能（目前无法获取）。加入此功能是为了以防 GTA5-mods 将来决定启用公开或私有 API。目前，请将此字段留空。

#- “分享配置文件”功能将在你的 GTA5 根目录中创建一个文本文件（current_profile.txt）。行格式：[原始脚本文件名] [显示名称] [本地版本] [脚本 URL]

#- 我建议将更新缓存设置为 72 小时或更长（因为脚本不会每天都更改版本）。

  • 设置保存在 %LOCALAPPDATA%\GTA5ScriptUpdater\settings.json。
  • 缓存位于 %LOCALAPPDATA%\GTA5ScriptUpdater\update_cache.json，
  • 日志可在 %LOCALAPPDATA%\GTA5ScriptUpdater\logs\updater.log 中找到

（在其他平台上，备用位置为用户目录）。

-Important technical notes

  • 更新检查期间可能会轻微卡顿。
  • 规范化匹配（移除扩展名、版本和通用后缀），已知模组使用手动别名；评分低于 75% 的会显示为“可能匹配”，而非确认更新。
  • 更新检查中未找到的脚本，通常是由于文件名与实际模组名称不同或格式不良所致。
  • 缺少 INI 文件是由于名称与脚本不同所致。

Github 上的更多信息