mcpField
G
game-recon

game-recon

github.com/rehan-remade开发9.2k1.6k 次安装1 天前更新
代码仓库

关于 game-recon

game-recon 是一项快速识别游戏引擎、版本、安装信息、反作弊、加载器和存档，并选择模组路线的技能。它结合 um scan 扫描结果与社区最新信息，为后续工作记录计划。

主要功能

  1. 01扫描安装并识别游戏信息
  2. 02检查引擎、加载器、存档和反作弊
  3. 03调查当前社区模组路线
  4. 04评估兼容性与模组安全性
  5. 05编写模组计划

适用场景

  1. 01识别已安装游戏的模组环境
  2. 02修改游戏文件前选择方案
  3. 03检查游戏能否在当前主机运行
  4. 04记录加载器版本和安装步骤

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rehan-remade/universal-modder --skill game-recon

安装后在 Claude Code 中输入/game-recon确认已加载。

附带文件references/compatibility.md

详细介绍

游戏初步调查

目标：大约用五分钟了解要处理的情况，并确定采取哪条路线。把答案记录下来， 以便后续每一步都能据此推进。

0. 之前有其他 Agent 调查过吗？

运行 um kb search "<game>"（以及引擎名称）。共享知识库中的实地笔记可能会在你动手前，告诉你可用的版本、路线和注意事项。请参阅 share-field-notes 技能。

1. 找到游戏并识别其特征

um scan --list                 # Steam, Epic and Xbox installs (Windows, WSL, Linux, macOS)
um scan "<name or folder>"     # host, engine, version, exes (.NET?), anti-cheat, loaders,
                               # mod folders, saves, routes
um scan "<game>" --json        # the same, machine-readable

um 位于 universal-modder 仓库的 bin/um 中（插件和克隆仓库会将其加入 PATH）。其他情况下： 运行 uv tool install git+https://github.com/rehan-remade/universal-modder。

um scan 只读取文件。它会对安装内容建立索引（有范围限制），检测 PE 标头、Unity/Godot/GameMaker 标头和 Unreal 版本字符串，将已知游戏映射到其社区加载器，并指出需要阅读的操作指南：skills/mod-any-game/references/engines/<engine>.md。

扫描无法发现所有信息，因此请手动检查以下情况：

  • 游戏不在商店库中（GOG、itch、独立文件夹）：传入文件夹路径。
  • 出现多个引擎的信号： 启动器和网页辅助程序很常见。得分最高的引擎会胜出，但也要阅读“also”一行。
  • 反作弊安装在其他位置： 内核驱动程序（Vanguard 的 vgk.sys）和启动器级别的防护程序不会放在游戏文件夹中。搜索“ anti-cheat”。
  • 仅限在线或持续运营的游戏： 即使未检测到任何信息，也应将其视为受保护游戏。

1b. 这台机器能运行它吗？

如果游戏原生支持当前主机，则跳过此步骤：Windows 上运行的 Windows 游戏，或从 WSL 运行的 Windows 游戏；在 macOS 或 Linux 对应系统上运行的 macOS 或 Linux 版本（um scan 会打印 host: 和每个 exe 的 CPU 信息，并在 Windows 版本遇到其他操作系统时发出警告）。其他情况（macOS 或 Linux 上运行仅支持 Windows 的游戏、在 ARM CPU 上运行 x64 游戏），或者本应能运行但无法启动的游戏，请先按具体情况和确切错误文本搜索笔记 （um kb search "windows game on mac"、um kb search "proton"、um kb search "<error text>"），然后遵循 references/compatibility.md：主机检查、各游戏报告、兼容层、反作弊和探测。

2. 调查活跃的社区（始终要做；版本会变化）

按以下顺序搜索：

  1. “ modding” / “ mod loader” / “ modding wiki”。游戏 Wiki 通常有模组页面。
  2. Nexus Mods（热门模组会显示其依赖的框架）、Thunderstore（Unity 游戏的 BepInEx 套件）、mod.io、Steam 创意工坊（游戏是否有创意工坊？um scan 会显示已安装的创意工坊内容）。
  3. GitHub：“ mod”、“ modding api”、“ decompile”、“ sdk”、“ mod loader”。
  4. 查看近期帖子（X/Reddit/Discord 公告），了解新框架。加载器可能问世才几天。

记录：加载器名称、仓库、当前版本和安装步骤、支持的游戏版本、“hello world”示例模组，以及日志的保存位置。

3. 做出决定

  • 能否安全地制作模组？ 查看反作弊、仅限在线的部分、EULA 或模组政策，以及加载器所依赖的所有权检查（参见 skills/mod-any-game/references/safety.md）。如果不行：明确说明，并提供可行方案（官方工具、离线模式、玩法创意相同的其他游戏）。
  • 路线： 加载器 API > 数据/资源模组 > 托管代码补丁 > 原生钩子 > 重新实现/混搭。选择最先能实现用户想法的路线。

4. 编写 MODDING_PLAN.md

# <Game> modding plan
- Install: <path> (<store> <appid>), version <x>
- Engine: <engine + version>, code: managed .NET / IL2CPP / native, 64-bit
- Anti-cheat / online: <none | what + verdict>
- Host / compat (if not native): <host OS, CPU, GPU> vs <game CPU + graphics API>; layer: <name + version>;
  verified by: <probe, log or screenshot>
- Saves: <path>   Config: <path>   Logs: <path>
- Community route: <loader vX.Y (repo)>, install: <steps>, example mod: <link>
- Chosen route for "<idea>": <route> because <reason>
- Lab plan: backup <folders> (um backup), lab profile <how>, windowed <how>
- Unknowns to resolve first: <list>

然后继续执行 mod-any-game 循环（实验环境搭建 → 信息来源 → 垂直切片）。

评论

支持 Markdown