蜘蛛侠 PC 脚本钩子

《漫威蜘蛛侠 重制版》PC 脚本钩子 MOD 使用指南
【核心介绍】
为《漫威蜘蛛侠 重制版》PC 版提供稳定、功能完整的脚本注入支持，允许安装和运行各类脚本模组，实现游戏功能扩展、内容修改与开发者调试。
【安装指南】
1. 安装前置依赖：
– 下载并安装 DirectX SDK（[官方链接]( 网址链接
– 下载并安装 Visual Studio C++ Redistributable X64（`vc_redist.x64.exe`，[官方链接]( 网址链接
→ 缺一不可，否则脚本钩子无法启动。
2. 确认游戏版本：
– 本 MOD 仅兼容 Steam 版 v1.817.1.0（2022年8月18日更新） 的可执行文件；
– 若版本不符，请通过 Steam 控制台降级（不支持破解版、其他发行平台或非指定版本）。
3. 部署文件：
– 将以下文件全部复制到游戏根目录（即 `Spider-Man Remastered/` 文件夹下）：
– 「SMPCScriptHookLauncher.exe」
– 「ScriptHookSMPC.dll」
– 「ScriptHookSMPC.ini」
– 「ScriptHookSMPC.log」
– 「ScriptHookSMPC.ttf」（v1.0.2 起新增）
– 同时在游戏根目录手动创建「scripts」文件夹，用于存放你下载或编写的脚本模组。
【功能详情】
✅ 已优化：
– 提供完整脚本 API，支持调用游戏函数（如 `HERO::GetPlayerHeroHandlePointer`、`ENTITY::GetEntityFromHandlePointer`）、实体操作（生成/激活/删除角色）、资源加载（`ASSET::LoadAssetByHash`）、变换控制（缩放/朝向/向量获取）、同步管理、本地化文本替换等；
– 内置 D3D12 ImGui 钩子，支持 UI 调试与消息显示（`HUD::AddMessage`），修复线程等待逻辑；
– 新增字体支持（`ScriptHookSMPC.ttf`），提升脚本 UI 显示兼容性。
❌ 未修改：
– 游戏本体逻辑、模型、贴图、音效、剧情流程等原始内容；
– 不提供任何游戏内功能模组（如无限蛛丝、飞行等），仅为脚本运行环境。
✨ 额外调整：
– 提供开发者 SDK 与完整文档支持（含函数说明、示例）；
– 支持热重载：按 INSERT 键 可即时卸载/重新加载当前脚本，无需重启游戏。
【使用要求】
– 必备：Steam 客户端 + 游戏本体（《漫威蜘蛛侠 重制版》）；
– 必备：操作系统为 Windows 10 或 Windows 11（64位）；
– 必备：已正确安装 DirectX SDK 与 vc_redist.x64.exe；
– 必备：游戏可执行文件版本严格为 v1.817.1.0（2022年8月18日更新）。
【兼容性说明】
– 兼容范围：所有基于本脚本钩子开发的第三方脚本模组（需使用 v1.0.2+ API）；
– 不兼容模组：
– 修改同一内存地址或底层渲染管线的其他钩子类模组（如自定义 D3D12 注入器）；
– 替换核心引擎 DLL 或劫持相同启动入口的模组；
– 兼容补丁：暂未推出与其他主流钩子（如 ASI Loader 类）的共存补丁。
【注意事项】
– INSERT 键仅在游戏内有效，主菜单中可能无响应；
– 若启动失败，请检查 `ScriptHookSMPC.log` 日志文件，确认 DirectX/C++ 运行库是否安装完整；
– 所有脚本必须放入「scripts」文件夹，子文件夹结构将被自动识别；
– v1.0.2 起新增字体文件（`ScriptHookSMPC.ttf`），缺失将导致部分脚本 UI 文字显示异常；
– 不支持 macOS / Linux；不支持云游戏平台（如 GeForce Now、Xbox Cloud Gaming）。
【更新日志】
– 2022年8月29日 v1.0.0：初次发布；
– 2022年8月29日 v1.0.1：修复属性错误（感谢 Rin）；
– 2022年11月18日 v1.0.2：
– 新增 20+ 核心函数（含实体管理、资产加载、变换控制、同步对象、本地化文本替换等）；
– 修复 `HUD::AddMessage` 等函数的线程调用时机问题；
– 优化 D3D12 ImGui 钩子稳定性（在玩家存在时触发）；
– 新增内置字体「ScriptHookSMPC.ttf」。