setup-game-mod-dev
RenoDX workflow for setting up or resuming game mod development with Clang debug builds, DevKit, MCP bridge, ReShade game-folder links, live shader paths, per-game addon scaffolds, metadata, shader dump/decompile baselines, and verification. Use when starting a new src/games/{game} mod, continuing game-specific addon work, configuring DevKit for a game, or turning DevKit findings into a real mod.
clshortfuse · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add clshortfuse/renodx --skill setup-game-mod-dev技能说明
name: setup-game-mod-dev description: "RenoDX workflow for setting up or resuming game mod development with Clang debug builds, DevKit, MCP bridge, ReShade game-folder links, live shader paths, per-game addon scaffolds, metadata, shader dump/decompile baselines, and verification. Use when starting a new src/games/{game} mod, continuing game-specific addon work, configuring DevKit for a game, or turning DevKit findings into a real mod." argument-hint: "game title/folder, install path, graphics API, and fresh vs continuing"
Setup Game Mod Development
Set up RenoDX mod development for a specific game. Cover the local toolchain, DevKit/MCP inspection, game-folder ReShade/addon links, and the initial or continued src/games/{game} workflow.
Focus on the development environment and mod scaffold. For swapchain/resource tracing, HDR source proof, resource upgrades, or rejecting final-SDR inverse-tonemap approaches, use swapchain-resource-analysis. For shader-side tonemap/LUT math after the target pass is known, use handle-sdr-tonemap-lut.
Related skills and scope
| Need | Use |
|---|---|
| Create/resume a game folder, build targets, link ReShade/addons, configure DevKit paths | This skill |
Trace final output, resource formats, swapchain proxy, SwapChainPass, SDR/HDR output toggle, or HDR source proof | swapchain-resource-analysis |
| Edit the proven game shader for RenoDRT/PsychoV/LUT bridge math | handle-sdr-tonemap-lut |
Keep this skill focused on getting the mod development environment and baseline workflow ready. Record enough facts for handoff, but do not duplicate the specialized swapchain/resource or shader-math workflows.
Boundaries
- Keep changes local to one
src/games/{game}folder unless cross-mod work is explicitly requested. - Do not change global CMake presets, CI workflows, vendored dependencies, or external submodules.
- New mods start from
src/games/generic. - Use the CMake target named after the mod folder; the output artifact is
renodx-{mod}.addon64or.addon32. - Use the
devkitandmcp_bridgetargets for local inspection; their debug outputs arerenodx-devkit.addon64andrenodx-mcp-bridge.exe. - Prefer Clang CMake presets for real development builds. Use VS Code CMake build integration when available, but select the
clang-*configure/build presets. Treatninja-*andvs-*presets as workflow testing paths only, not normal mod development paths. - Do not build a game addon while that game is running with the addon loaded; the DLL can be locked.
- Do not put dumped
.csofiles insrc/games/{game}. They can shadow editable HLSL during live shader loading.
Required setup facts
Collect or infer these before editing files or changing a game folder:
| Fact | Notes |
|---|---|
| Work mode | continue if src/games/{game} exists or the user says resume; fresh otherwise. |
| Mod folder id | Lowercase folder name under src/games, usually no spaces. |
| Game title | Human-readable metadata title. |
| Game binary folder | The folder where ReShade and .addon64/.addon32 files must load from. Infer from metadata when possible, but verify because it may be a subfolder such as ...\Binaries\Win64. |
| Executable/process | game_exe or process_name for metadata and runtime checks. |
| Graphics API | Usually d3d11, d3d12, or vulkan; affects loader DLL naming and shader targets. |
| Architecture | Usually x64; use .addon32 only for 32-bit games. |
| Swapchain/output state | Optional early fact: known swapchain format/color space, especially RGBA8U/UNORM bottlenecks or existing HDR/scRGB/PQ paths. |
| Proxy/resource need | Optional early fact: whether evidence suggests a RGBA16F proxy, resource upgrade, SwapChainPass output shader, or output preset cbuffer is needed before shader-side tonemap work. |
| Store ids | Steam/GOG/Microsoft/Nexus ids if known. |
| Loader name | Default is often dxgi.dll; honor deploy.reshade_preferred_name or game-specific requirements. |
| ReShade state | Whether the game folder already has a ReShade loader DLL, ReShade.ini, and ReShade.log. |
Before asking for missing facts, read src/games/{mod}/metadata.json when it exists. Use deploy.steam_appid, deploy.game_exe, deploy.process_name, deploy.api, deploy.architecture, deploy.reshade_preferred_name, and deploy.detection.default_install_paths to reduce guessing. If steam_appid is present, resolve the local Steam install by reading Steam libraryfolders.vdf and appmanifest_{appid}.acf, then use game_exe/process_name to locate the binary folder. Steam metadata alone usually resolves only the install root; still ask when executable metadata is missing, the game is not locally installed, or multiple executable matches make the injection folder ambiguous.
Expected agent output
When invoked, produce or maintain these sections in the response or working notes:
- Setup facts - game folder, install/binary folder, API, arch, and mode.
- Existing state - mod folder files, metadata, registered shaders, current build artifacts, and relevant scratch/verification notes.
- Build plan - exact Clang debug CMake targets (
devkit,mcp_bridge,{mod}) and any game-shutdown requirement. - Game-folder link plan - ReShade bootstrap state, loader DLL, DevKit addon, and game addon symlink/copy targets; list conflicts instead of deleting unknown files.
- DevKit plan - MCP connection, tools path, live shader path, snapshot, draw/resource/shader inspection steps, and any handoff needed for swapchain/resource proof.
- Baseline plan - original capture, dump/decompile location, editable HLSL location, 1:1 live baseline validation.
- Verification checklist - target built, files generated, addon loaded, shader replacement active, runtime output validated.
Continue an existing mod
Use this path when src/games/{mod} already exists.
- Inspect the existing folder:
- `m