XMenu for GTA III / Vice City / San Andreas

一个简单但功能比较全面的 GTA 三部曲 ASI 菜单。
By 鼠子(YuiNijika)

A simple yet feature-rich ASI menu for GTA III, GTA Vice City, and GTA San Andreas.

English | 简体中文

默认快捷键：M 呼出 / 关闭菜单

这是什么

XMenu 是一个面向 GTA III、GTA Vice City、GTA San Andreas 的 ASI 菜单，目标是安装简单、功能直观、三端共用同一套使用体验。

它不是大型整合包，也不会替换游戏主程序。把文件放到游戏目录后，通过 ASI Loader 加载即可使用，也可使用仓库附带的安装器一键部署。

当前版本见源码 XMENU_VERSION。游戏内与安装器均会检测新版本。

功能概览

模块	功能
玩家	血量、护甲、金钱、通缉等级、无敌、无限奔跑、自由飞行、状态开关
载具	生成载具、修复、车速、车门、损伤、霓虹、载具状态
武器	获取武器、弹药、安全模式、滚轮刷武器、自定义射速、线框与骨骼绘制、子弹追踪、子弹穿墙
世界	时间、天气、游戏速度、环境控制、自由相机、俯视相机、随机作弊
传送	城市 / 区域选点、快速地图 / 标记、向前传送、持续向前传送
行人	行人生成与数据列表、无火控制、刷新数量限制
场景	动画、粒子、过场
视觉	视觉 / 天气选项
界面	面板模式、列表模式、数值弹窗输入、全局主题色
快捷键	菜单快捷键、动作快捷键、Overlay、命令窗口
设置	中英日俄本地化、配置导入导出、Overlay、启动状态恢复
更新	双源检测：优先 GTAMODX，失败回退 GitHub Releases

武器辅助

绘制：行人 / 车辆包围盒、ColModel 碰撞线框、行人骨骼
子弹追踪：锁定范围与最大目标数可配，只改子弹落点，不会转动相机
子弹穿墙：本地玩家开火时忽略建筑等遮挡
自定义射速：与快速连射相互独立，可写入配置
安全模式：默认开启，拦截无效武器 ID
GTA III 暂为占位，完整追踪以 SA / VC 为准

界面模式

面板模式：传统窗口布局
列表模式：上下选择，支持键盘、滚轮与鼠标，数值可弹窗输入，长列表可折叠
两种模式共用主题色，设置页可切换

San Andreas

部分能力主要面向 SA，例如载具霓虹、自由相机、俯视相机、随机作弊、场景粒子与过场。III / VC 以各端实际可用功能为准。

三端能力差异

能力	SA	VC	III
玩家基础（血量 / 护甲 / 金钱 / 无敌 / 奔跑等）	✅	✅	✅
武器（获取 / 丢弃 / 射速 / 属性覆盖）	✅	✅	✅
世界（时间 / 天气 / 重力 / 游戏速度 / FPS / 冻结时间 / 快时钟 / 禁用回放与作弊）	✅	✅	✅
传送	✅	✅	✅
视觉（HUD / 雷达 / 天气滤镜）	✅	✅	✅
行人（生成 / 属性 / 大头）	✅	✅	✅
子弹追踪 / 穿墙	✅	✅	✖
行人 / 车辆碰撞线框与骨骼绘制	◐	◐	✖
世界拾取（生成拾取物）	◐	◐	◐
玩家运行时效果 / 载具基础与配色	✅	◐	◐
载具霓虹、自由 / 俯视相机、随机作弊、场景粒子与过场	✅	✖	✖

GTA III 的子弹追踪为占位；VC / III 中标记 ◐ 的能力页面可用但部分动作受限。

支持游戏

游戏	渲染链路	说明
GTA III	D3D8to9 + D3D9	需要 D3D8to9
GTA Vice City	D3D8to9 + D3D9	需要 D3D8to9
GTA San Andreas	D3D9	原生 D3D9

运行依赖

安装

方式 A：安装器

准备好游戏本体。
运行 XMenuInstaller.exe，按向导选择目录与组件。
可附带部署 ASI Loader、SilentPatch、D3D8to9，也可只装 XMenu。
安装器会先校验发布包中的 XBase\Mods\XMenu\package.json、engines.xbase、共享运行时、Panel 和 WebUI，符合当前 XBase 约束后才允许写入。
版本信息优先读 GTAMODX，安装包来自 GitHub Release。
启动游戏，按 M 打开菜单。

方式 B：手动复制

安装运行依赖。
将 XMenuSA.asi（按你的游戏选择 XMenuVC.asi / XMenuIII.asi）放入游戏的 plugins 文件夹（或游戏根目录）。
将 XBase 文件夹放入游戏根目录，内含 Library\（共享运行时与网页视图加载器）与 Mods\XMenu\（数据、ui.html 与 package.json）。
GTA III / Vice City 额外放入 d3d8.dll。
启动游戏，按 M 打开菜单。

推荐目录结构：

GameRoot/
├─ plugins/
│  ├─ XMenuSA.asi      (按你的游戏选择对应 asi)
│  ├─ XMenuVC.asi
│  └─ XMenuIII.asi
├─ XBase/
│  ├─ Library/
│  │  ├─ XBaseSA.dll / XBaseVC.dll / XBaseIII.dll
│  │  └─ WebView2Loader.dll
│  └─ Mods/
│     └─ XMenu/
│        ├─ package.json    模组清单，挂载前校验
│        ├─ ui.html         React 界面入口
│        └─ data/
│           ├─ sa/
│           ├─ vc/
│           ├─ iii/
│           └─ i18n/
└─ d3d8.dll

运行后会生成：

XBase/Mods/XMenu/config.json
XBase/Mods/XMenu/debug.log

config.json 保存菜单状态、快捷键、武器辅助与射速等。首次启动会分帧完成 i18n、配置、逻辑与 D3D Hook；资源 JSON 按需加载。

如何增加新语言

语言文件位于：

XBase/Mods/XMenu/data/i18n/<language>/

源码目录：

src/data/i18n/<language>/

新增语言示例：韩文 ko。

src/data/i18n/en/ -> src/data/i18n/ko/

修改 src/data/i18n/ko/index.json。

{
  "name": "한국어",
  "files": [
    "common.json",
    "player.json",
    "vehicle.json",
    "weapon.json",
    "world.json",
    "teleport.json",
    "ped.json",
    "scene.json",
    "visual.json",
    "actions.json",
    "settings.json",
    "update.json",
    "about.json",
    "scene_visual_data.json"
  ]
}

翻译 JSON 的值，不要改 key。

{
  "tab.player": "플레이어"
}

GameRoot/XBase/Mods/XMenu/data/i18n/ko/

启动游戏，在设置页切换语言。

缺失 key 会回退到备用语言或显示原 key。

构建

Visual Studio，MSVC C++，Win32
plugin-sdk，环境变量 PLUGIN_SDK_DIR 或上级目录自动探测
仓库内 tools/premake5.exe
XBase 的头与库由 XBase 的 Build.bat Release stage 进 include/XBase 与 lib，两者必须同源同配置
网页界面需要 Node.js，先在 react/ 下执行 pnpm install && pnpm run build，产物是 react/dist/ui.html

Build.bat Release --no-pause

可选：Debug / Release、--toolset v143|v145、--no-pause。
首次可先运行 Setup.bat。

批处理文件必须保持 CRLF 行尾，cmd 在 LF 行尾下会找不到 call :label 标签。仓库通过 .gitattributes 固定 *.bat 为 CRLF；若本地被改成 LF，重新检出或转换行尾后再构建。

react/dist 不存在时构建脚本只告警并跳过界面，asi 仍然产出，但网页界面打不开。

构建产物：

build/bin/XMenuSA.asi
build/bin/XMenuVC.asi
build/bin/XMenuIII.asi
build/bin/XMenuInstaller.exe
build/bin/XBase/Library/XBase{SA,VC,III}.dll
build/bin/XBase/Mods/XMenu/package.json
build/bin/XBase/Mods/XMenu/ui.html
build/bin/XBase/Mods/XMenu/data/**
build/bin/XBase/Mods/XMenu/data/i18n/**

路径	说明
`tools/build_i18n_split.py`	拆分 / 整理 i18n
`tools/check_ui_registry.py`	校验界面注册表 id 与桥接方法名，改完 `ui-schema.json` 必须跑
`tools/dataEditor/`	Python 数据编辑工具
`tools/build_plugin_sdk.bat`	构建 plugin-sdk
`tools/resolve_vc_toolset.ps1`	解析 MSVC 工具集

改完 src/data/ 后重新构建，或拷贝 data/ 到运行目录。

目录结构

XMenu/
├─ src/
│  ├─ app/            启动与生命周期编排
│  ├─ controllers/    界面注册、桥接、业务逻辑
│  ├─ ui/             ImGui 页面与分区
│  ├─ integration/    XBase 接入层
│  ├─ game/ universal/ utils/ resources/
│  ├─ data/           i18n、各版本资源、ui-schema.json、package.json
│  └─ main.cpp
├─ react/             React 网页界面源码
├─ installer/
├─ include/XBase/    XBase 公共头（由 XBase 构建 stage）
├─ lib/              XBase 与 plugin-sdk 的静态库
├─ tools/
├─ Build.bat / Setup.bat / premake5.lua
└─ images/

界面注册表 src/data/ui-schema.json 是 ImGui 与 React 两侧共用的唯一描述，改完必须跑 tools/check_ui_registry.py。

反馈与关注

GitHub：YuiNijika/XMenu
GTAMODX：XMenu 发布页
Bilibili：Tomoriゞ
QQ 群：GTAMODX QQ 群

XMenu 免费发布，禁止倒卖，禁止用于商业用途。 owed.

XMenu for GTA III / Vice City / San Andreas

一个简单但功能比较全面的 GTA 三部曲 ASI 菜单。
By 鼠子(YuiNijika)

A simple yet feature-rich ASI menu for GTA III, GTA Vice City, and GTA San Andreas.

English | 简体中文

默认快捷键：M 呼出 / 关闭菜单

这是什么

XMenu 是一个面向 GTA III、GTA Vice City、GTA San Andreas 的 ASI 菜单，目标是安装简单、功能直观、三端共用同一套使用体验。

它不是大型整合包，也不会替换游戏主程序。把文件放到游戏目录后，通过 ASI Loader 加载即可使用，也可使用仓库附带的安装器一键部署。

当前版本见源码 XMENU_VERSION。游戏内与安装器均会检测新版本。

功能概览

模块	功能
玩家	血量、护甲、金钱、通缉等级、无敌、无限奔跑、自由飞行、状态开关
载具	生成载具、修复、车速、车门、损伤、霓虹、载具状态
武器	获取武器、弹药、安全模式、滚轮刷武器、自定义射速、线框与骨骼绘制、子弹追踪、子弹穿墙
世界	时间、天气、游戏速度、环境控制、自由相机、俯视相机、随机作弊
传送	城市 / 区域选点、快速地图 / 标记、向前传送、持续向前传送
行人	行人生成与数据列表、无火控制、刷新数量限制
场景	动画、粒子、过场
视觉	视觉 / 天气选项
界面	面板模式、列表模式、数值弹窗输入、全局主题色
快捷键	菜单快捷键、动作快捷键、Overlay、命令窗口
设置	中英日俄本地化、配置导入导出、Overlay、启动状态恢复
更新	双源检测：优先 GTAMODX，失败回退 GitHub Releases

武器辅助

绘制：行人 / 车辆包围盒、ColModel 碰撞线框、行人骨骼
子弹追踪：锁定范围与最大目标数可配，只改子弹落点，不会转动相机
子弹穿墙：本地玩家开火时忽略建筑等遮挡
自定义射速：与快速连射相互独立，可写入配置
安全模式：默认开启，拦截无效武器 ID
GTA III 暂为占位，完整追踪以 SA / VC 为准

界面模式

面板模式：传统窗口布局
列表模式：上下选择，支持键盘、滚轮与鼠标，数值可弹窗输入，长列表可折叠
两种模式共用主题色，设置页可切换

San Andreas

部分能力主要面向 SA，例如载具霓虹、自由相机、俯视相机、随机作弊、场景粒子与过场。III / VC 以各端实际可用功能为准。

三端能力差异

能力	SA	VC	III
玩家基础（血量 / 护甲 / 金钱 / 无敌 / 奔跑等）	✅	✅	✅
武器（获取 / 丢弃 / 射速 / 属性覆盖）	✅	✅	✅
世界（时间 / 天气 / 重力 / 游戏速度 / FPS / 冻结时间 / 快时钟 / 禁用回放与作弊）	✅	✅	✅
传送	✅	✅	✅
视觉（HUD / 雷达 / 天气滤镜）	✅	✅	✅
行人（生成 / 属性 / 大头）	✅	✅	✅
子弹追踪 / 穿墙	✅	✅	✖
行人 / 车辆碰撞线框与骨骼绘制	◐	◐	✖
世界拾取（生成拾取物）	◐	◐	◐
玩家运行时效果 / 载具基础与配色	✅	◐	◐
载具霓虹、自由 / 俯视相机、随机作弊、场景粒子与过场	✅	✖	✖

GTA III 的子弹追踪为占位；VC / III 中标记 ◐ 的能力页面可用但部分动作受限。

支持游戏

游戏	渲染链路	说明
GTA III	D3D8to9 + D3D9	需要 D3D8to9
GTA Vice City	D3D8to9 + D3D9	需要 D3D8to9
GTA San Andreas	D3D9	原生 D3D9

运行依赖

安装

方式 A：安装器

准备好游戏本体。
运行 XMenuInstaller.exe，按向导选择目录与组件。
可附带部署 ASI Loader、SilentPatch、D3D8to9，也可只装 XMenu。
安装器会先校验发布包中的 XBase\Mods\XMenu\package.json、engines.xbase、共享运行时、Panel 和 WebUI，符合当前 XBase 约束后才允许写入。
版本信息优先读 GTAMODX，安装包来自 GitHub Release。
启动游戏，按 M 打开菜单。

方式 B：手动复制

安装运行依赖。
将 XMenuSA.asi（按你的游戏选择 XMenuVC.asi / XMenuIII.asi）放入游戏的 plugins 文件夹（或游戏根目录）。
将 XBase 文件夹放入游戏根目录，内含 Library\（共享运行时与网页视图加载器）与 Mods\XMenu\（数据、ui.html 与 package.json）。
GTA III / Vice City 额外放入 d3d8.dll。
启动游戏，按 M 打开菜单。

推荐目录结构：

GameRoot/
├─ plugins/
│  ├─ XMenuSA.asi      (按你的游戏选择对应 asi)
│  ├─ XMenuVC.asi
│  └─ XMenuIII.asi
├─ XBase/
│  ├─ Library/
│  │  ├─ XBaseSA.dll / XBaseVC.dll / XBaseIII.dll
│  │  └─ WebView2Loader.dll
│  └─ Mods/
│     └─ XMenu/
│        ├─ package.json    模组清单，挂载前校验
│        ├─ ui.html         React 界面入口
│        └─ data/
│           ├─ sa/
│           ├─ vc/
│           ├─ iii/
│           └─ i18n/
└─ d3d8.dll

运行后会生成：

XBase/Mods/XMenu/config.json
XBase/Mods/XMenu/debug.log

config.json 保存菜单状态、快捷键、武器辅助与射速等。首次启动会分帧完成 i18n、配置、逻辑与 D3D Hook；资源 JSON 按需加载。

如何增加新语言

语言文件位于：

XBase/Mods/XMenu/data/i18n/<language>/

源码目录：

src/data/i18n/<language>/

新增语言示例：韩文 ko。

src/data/i18n/en/ -> src/data/i18n/ko/

修改 src/data/i18n/ko/index.json。

{
  "name": "한국어",
  "files": [
    "common.json",
    "player.json",
    "vehicle.json",
    "weapon.json",
    "world.json",
    "teleport.json",
    "ped.json",
    "scene.json",
    "visual.json",
    "actions.json",
    "settings.json",
    "update.json",
    "about.json",
    "scene_visual_data.json"
  ]
}

翻译 JSON 的值，不要改 key。

{
  "tab.player": "플레이어"
}

GameRoot/XBase/Mods/XMenu/data/i18n/ko/

启动游戏，在设置页切换语言。

缺失 key 会回退到备用语言或显示原 key。

构建

Visual Studio，MSVC C++，Win32
plugin-sdk，环境变量 PLUGIN_SDK_DIR 或上级目录自动探测
仓库内 tools/premake5.exe
XBase 的头与库由 XBase 的 Build.bat Release stage 进 include/XBase 与 lib，两者必须同源同配置
网页界面需要 Node.js，先在 react/ 下执行 pnpm install && pnpm run build，产物是 react/dist/ui.html

Build.bat Release --no-pause

可选：Debug / Release、--toolset v143|v145、--no-pause。
首次可先运行 Setup.bat。

react/dist 不存在时构建脚本只告警并跳过界面，asi 仍然产出，但网页界面打不开。

构建产物：

build/bin/XMenuSA.asi
build/bin/XMenuVC.asi
build/bin/XMenuIII.asi
build/bin/XMenuInstaller.exe
build/bin/XBase/Library/XBase{SA,VC,III}.dll
build/bin/XBase/Mods/XMenu/package.json
build/bin/XBase/Mods/XMenu/ui.html
build/bin/XBase/Mods/XMenu/data/**
build/bin/XBase/Mods/XMenu/data/i18n/**

路径	说明
`tools/build_i18n_split.py`	拆分 / 整理 i18n
`tools/check_ui_registry.py`	校验界面注册表 id 与桥接方法名，改完 `ui-schema.json` 必须跑
`tools/dataEditor/`	Python 数据编辑工具
`tools/build_plugin_sdk.bat`	构建 plugin-sdk
`tools/resolve_vc_toolset.ps1`	解析 MSVC 工具集

改完 src/data/ 后重新构建，或拷贝 data/ 到运行目录。

目录结构

XMenu/
├─ src/
│  ├─ app/            启动与生命周期编排
│  ├─ controllers/    界面注册、桥接、业务逻辑
│  ├─ ui/             ImGui 页面与分区
│  ├─ integration/    XBase 接入层
│  ├─ game/ universal/ utils/ resources/
│  ├─ data/           i18n、各版本资源、ui-schema.json、package.json
│  └─ main.cpp
├─ react/             React 网页界面源码
├─ installer/
├─ include/XBase/    XBase 公共头（由 XBase 构建 stage）
├─ lib/              XBase 与 plugin-sdk 的静态库
├─ tools/
├─ Build.bat / Setup.bat / premake5.lua
└─ images/

界面注册表 src/data/ui-schema.json 是 ImGui 与 React 两侧共用的唯一描述，改完必须跑 tools/check_ui_registry.py。

反馈与关注

GitHub：YuiNijika/XMenu
GTAMODX：XMenu 发布页
Bilibili：Tomoriゞ
QQ 群：GTAMODX QQ 群

XMenu 免费发布，禁止倒卖，禁止用于商业用途。 owed.

XMenu: III.VC.SA 作弊菜单

创作团队

前置要求

d3d8to9 API转换

GTA修复补丁[SilentPatch]

Ultimate ASI Loader

XMenu for GTA III / Vice City / San Andreas

这是什么

功能概览

武器辅助

界面模式

San Andreas

三端能力差异

支持游戏

运行依赖

安装

方式 A：安装器

方式 B：手动复制

如何增加新语言

构建

目录结构

反馈与关注

XMenu-v0.1.0-rc.zip

创作团队

推荐项目

相关推荐

XMenu: III.VC.SA 作弊菜单

创作团队

前置要求

d3d8to9 API转换

GTA修复补丁[SilentPatch]

Ultimate ASI Loader

XMenu for GTA III / Vice City / San Andreas

这是什么

功能概览

武器辅助

界面模式

San Andreas

三端能力差异

支持游戏

运行依赖

安装

方式 A：安装器

方式 B：手动复制

如何增加新语言

构建

目录结构

反馈与关注

XMenu-v0.1.0-rc.zip

创作团队

推荐项目

相关推荐