跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

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

NeedUse
Create/resume a game folder, build targets, link ReShade/addons, configure DevKit pathsThis skill
Trace final output, resource formats, swapchain proxy, SwapChainPass, SDR/HDR output toggle, or HDR source proofswapchain-resource-analysis
Edit the proven game shader for RenoDRT/PsychoV/LUT bridge mathhandle-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}.addon64 or .addon32.
  • Use the devkit and mcp_bridge targets for local inspection; their debug outputs are renodx-devkit.addon64 and renodx-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. Treat ninja-* and vs-* 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 .cso files in src/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:

FactNotes
Work modecontinue if src/games/{game} exists or the user says resume; fresh otherwise.
Mod folder idLowercase folder name under src/games, usually no spaces.
Game titleHuman-readable metadata title.
Game binary folderThe 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/processgame_exe or process_name for metadata and runtime checks.
Graphics APIUsually d3d11, d3d12, or vulkan; affects loader DLL naming and shader targets.
ArchitectureUsually x64; use .addon32 only for 32-bit games.
Swapchain/output stateOptional early fact: known swapchain format/color space, especially RGBA8U/UNORM bottlenecks or existing HDR/scRGB/PQ paths.
Proxy/resource needOptional 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 idsSteam/GOG/Microsoft/Nexus ids if known.
Loader nameDefault is often dxgi.dll; honor deploy.reshade_preferred_name or game-specific requirements.
ReShade stateWhether 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:

  1. Setup facts - game folder, install/binary folder, API, arch, and mode.
  2. Existing state - mod folder files, metadata, registered shaders, current build artifacts, and relevant scratch/verification notes.
  3. Build plan - exact Clang debug CMake targets (devkit, mcp_bridge, {mod}) and any game-shutdown requirement.
  4. Game-folder link plan - ReShade bootstrap state, loader DLL, DevKit addon, and game addon symlink/copy targets; list conflicts instead of deleting unknown files.
  5. DevKit plan - MCP connection, tools path, live shader path, snapshot, draw/resource/shader inspection steps, and any handoff needed for swapchain/resource proof.
  6. Baseline plan - original capture, dump/decompile location, editable HLSL location, 1:1 live baseline validation.
  7. 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.

  1. Inspect the existing folder:
    • `m
阅读完整来源 ↗