XMenu: III.VC.SA 作弊菜單

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.

---

中文

默認快捷鍵：`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 菜單鏈路 |

運行依賴

• DirectX End-User Runtime
• Visual C++ Redistributable 2022 x86
• Ultimate ASI Loader
• SilentPatch（推薦；GTA III 可不裝）
• D3D8to9（僅 GTA III / Vice City 需要）

安裝

• 安裝上面的運行依賴。
• 將 `XMenu.asi` 放入遊戲根目錄。
• 將 `XMenu` 文件夾放入遊戲根目錄。
• GTA III / Vice City 額外放入 D3D8to9 的 `d3d8.dll`。
• 啓動遊戲，按 `M` 打開菜單。

推薦目錄結構：

```text

GameRoot/

├─ XMenu.asi

├─ XMenu/

│ ├─ XMenuSA.dll

│ ├─ XMenuVC.dll

│ ├─ XMenuIII.dll

│ ├─ data/

│ │ ├─ sa/

│ │ ├─ vc/

│ │ ├─ iii/

│ │ └─ i18n/

│ └─ i18n/ # 兼容舊路徑，可選

└─ d3d8.dll # 僅 GTA III / Vice City 需要

```

運行後會在遊戲目錄下生成：

```text

XMenu/config.json

XMenu/debug.log

```

如何增加新語言

XMenu 的當前語言文件位於：

```text

XMenu/data/i18n//

```

源碼內對應目錄爲：

```text

src/data/i18n//

```

新增語言示例：假設要增加韓文 `ko`。

• 複製一個已有語言目錄，例如：

```text

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

```

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

通常需要確認：

```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：

```json

{

"tab.player": "Player"

}

```

應該改成：

```json

{

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

}

```

不要改成：

```json

{

"탭.플레이어": "플레이어"

}

```

• 重新構建或把語言目錄放到運行目錄。

開發環境構建：

```bat

Build.bat Release --no-pause

```

玩家本地臨時添加語言：

```text

GameRoot/XMenu/data/i18n/ko/

```

• 啓動遊戲，在設置頁切換語言。

如果某個 key 沒翻譯，XMenu 會回退到備用語言或顯示原 key，方便定位缺失項。

構建

```bat

Build.bat Release --no-pause

```

構建產物：

```text

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/**

```

反饋與關注

• GitHub：YuiNijika/XMenu
• GTAMODX：XMenu 發佈頁
• Bilibili：Tomoriゞ
• QQ 羣：GTAMODX QQ 羣

XMenu 免費發佈，禁止倒賣，禁止用於商業用途。

---

English

Default hotkey: `M` to open / close the menu

About

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)**

Features

• Player: health, armor, money, wanted level, god mode, and state toggles
• Vehicle: spawning, repair, speed, doors, damage, and vehicle state controls
• Weapon: weapon grants, ammo, and common weapon actions
• World: time, weather, game speed, and environment controls
• Teleport: city / area based locations with per-game data
• Ped: ped-related tools and data lists
• Scene: animation, particle, and cutscene tools, mainly for San Andreas
• Visual: visual / weather options for III / VC / SA
• Hotkeys: menu hotkey, action hotkeys, overlay, and command window
• Settings: Chinese, English, Japanese, and Russian localization with instant switching

Supported games

| 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 f …