一个简单但功能比较全面的 GTA 三部曲 ASI 菜单。
By 鼠子(YuiNijika)
A simple yet feature-rich ASI menu for GTA III, GTA Vice City, and GTA San Andreas.
默认快捷键：
M呼出 / 关闭菜单
XMenu 是一个面向 GTA III、GTA Vice City、GTA San Andreas 的 ASI 菜单，目标是安装简单、功能直观、三端共用同一套使用体验。
它不是大型整合包，也不会替换游戏主程序。把文件放到游戏目录后，通过 ASI Loader 加载即可使用。
| 模块 | 功能 |
|---|---|
| 玩家 | 血量、护甲、金钱、通缉等级、无敌、无限奔跑、状态开关 |
| 载具 | 生成载具、修复载具、车速控制、车门、损伤、载具状态 |
| 武器 | 获取武器、弹药、常用武器操作 |
| 世界 | 时间、天气、游戏速度、环境控制 |
| 传送 | 按城市 / 区域选择地点，支持三端独立数据 |
| 行人 | 行人相关功能与数据列表 |
| 场景 | 动画、粒子、过场相关功能；当前主要面向 San Andreas |
| 视觉 | 视觉 / 天气相关选项，支持 III / VC / SA |
| 快捷键 | 菜单快捷键、动作快捷键、Overlay、命令窗口 |
| 设置 | 中文、英文、日文、俄文，本地化切换立即生效 |
| 游戏 | 渲染链路 | 说明 |
|---|---|---|
| GTA III | D3D8to9 + D3D9 | 原生 D3D8，需要 D3D8to9 承接菜单渲染 |
| GTA Vice City | D3D8to9 + D3D9 | 原生 D3D8，需要 D3D8to9 承接菜单渲染 |
| GTA San Andreas | D3D9 | 原生可使用当前 D3D9 菜单链路 |
![GTA修复补丁[SilentPatch]](https://123.gtamodx.com/yk6baz03t0l000ddxhh8voxmuwbm7uu8DIYvBIUyDwJ1DGxPAIJ0.webp)
XMenu.asi 放入游戏根目录。XMenu 文件夹放入游戏根目录。d3d8.dll。M 打开菜单。推荐目录结构：
GameRoot/
├─ XMenu.asi
├─ XMenu/
│ ├─ XMenuSA.dll
│ ├─ XMenuVC.dll
│ ├─ XMenuIII.dll
│ ├─ data/
│ │ ├─ sa/
│ │ ├─ vc/
│ │ ├─ iii/
│ │ └─ i18n/
│ └─ i18n/ # 兼容旧路径，可选
└─ d3d8.dll # 仅 GTA III / Vice City 需要
运行后会在游戏目录下生成：
XMenu/config.json
XMenu/debug.log
XMenu 的当前语言文件位于：
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"
]
}
ko 目录下的各个 JSON 文件。只改右侧文本，不改左侧 key：
{
"tab.player": "Player"
}
应该改成：
{
"tab.player": "플레이어"
}
不要改成：
{
"탭.플레이어": "플레이어"
}
开发环境构建：
Build.bat Release --no-pause
玩家本地临时添加语言：
GameRoot/XMenu/data/i18n/ko/
如果某个 key 没翻译，XMenu 会回退到备用语言或显示原 key，方便定位缺失项。
Build.bat Release --no-pause
构建产物：
build/bin/XMenu.asi
build/bin/XMenu/XMenuSA.dll
build/bin/XMenu/XMenuVC.dll
build/bin/XMenu/XMenuIII.dll
build/bin/XMenu/data/**
build/bin/XMenu/data/i18n/**
build/bin/XMenu/i18n/**
XMenu 免费发布，禁止倒卖，禁止用于商业用途。
Default hotkey:
Mto open / close the menu
XMenu is a simple yet feature-rich ASI menu for GTA III, GTA Vice City, and GTA San Andreas.
It is designed to be easy to install, easy to use, and consistent across all three games.
Author: 鼠子(YuiNijika)
| Game | Rendering path | Notes |
|---|---|---|
| GTA III | D3D8to9 + D3D9 | Native D3D8 game; D3D8to9 is required for the D3D9 menu renderer |
| GTA Vice City | D3D8to9 + D3D9 | Native D3D8 game; D3D8to9 is required for the D3D9 menu renderer |
| GTA San Andreas | D3D9 | Works with the current D3D9 menu renderer directly |
XMenu.asi into the game root directory.XMenu folder into the game root directory.d3d8.dll into the game root directory.M in-game.Language files are stored in:
XMenu/data/i18n/<language>/
Source files are stored in:
src/data/i18n/<language>/
To add a new language, copy an existing language folder, rename it, update its index.json, and translate the JSON values. Keep all JSON keys unchanged.
Example:
{
"tab.player": "Player"
}
Only translate the value:
{
"tab.player": "플레이어"
}
Then rebuild:
Build.bat Release --no-pause
Build.bat Release --no-pause
Output layout:
build/bin/XMenu.asi
build/bin/XMenu/XMenuSA.dll
build/bin/XMenu/XMenuVC.dll
build/bin/XMenu/XMenuIII.dll
build/bin/XMenu/data/**
build/bin/XMenu/data/i18n/**
build/bin/XMenu/i18n/**
XMenu is free. Reselling or commercial redistribution is not allowed.
鼠子
![[安装器]XMenuInstaller](https://123.gtamodx.com/ymjew503t0n000ddxlcm7wkr5aa4img1DIYvBIUyDwJ1DGxPAIJ0.webp)
![TXD 编辑器[TXD Edit]](https://123.gtamodx.com/yk6baz03t0l000ddx0s2jtryam2yysw4DIYvBIUyDwJ1DGxPAIJ0.webp)
