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 | 简体中文

---

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.

You can install manually or use the bundled installer.
Version string is XMENU_VERSION in source. In-game and installer update checks are available.

Author: 鼠子(YuiNijika)

Features

• Player: health, armor, money, wanted level, god mode, free fly, state toggles
• Vehicle: spawn, repair, speed, doors, damage, neon, vehicle state
• Weapon: grants, ammo, safe mode, scroll-wheel cycling, custom fire rate, wireframe and skeleton ESP, bullet tracking, wallhack
• World: time, weather, game speed, environment, freecam, top-down cam, random cheats
• Teleport: city / area locations, quick map / marker, forward teleport, continuous forward teleport
• Ped: spawn tools, data lists, no-fire control, spawn population limits
• Scene: animation, particle, cutscene tools
• Visual: visual / weather options
• UI: panel mode, list mode, popup numeric entry, shared themes
• Hotkeys: menu hotkey, action hotkeys, overlay, command window
• Settings: zh / en / jp / ru, config import/export, overlay, startup restore
• Updates: prefer GTAMODX, fall back to GitHub Releases

Weapon assist

• Drawing: ped / vehicle bounds, ColModel wireframes, ped skeleton
• Bullet tracking: configurable lock range and max targets; redirects bullet destination only, does not rotate the camera
• Wallhack: ignores buildings on the local player fire path
• Custom fire rate: independent from rapid-fire; can be saved to config
• Safe mode: blocks invalid weapon IDs by default
• GTA III is a stub for now; full tracking is for SA / VC

UI modes

• Panel mode: classic window layout
• List mode: list navigation with keyboard, wheel, and mouse; popup numeric entry; collapsible groups
• Shared theme palette in settings

San Andreas

Neon, freecam, top-down camera, random cheats, and many scene tools are SA-oriented. III / VC expose what each build implements.

Per-game capability differences

Capability	SA	VC	III
Player basics (health / armor / money / god mode / sprint, etc.)	✅	✅	✅
Weapon (grant / drop / fire rate / stat overrides)	✅	✅	✅
World (time / weather / gravity / game speed / FPS / freeze time / faster clock / disable replay & cheats)	✅	✅	✅
Teleport	✅	✅	✅
Visual (HUD / radar / weather filter)	✅	✅	✅
Ped (spawn / attributes / big head)	✅	✅	✅
Bullet tracking / wallhack	✅	✅	✖
Ped / vehicle collision wireframe & skeleton drawing	◐	◐	✖
World pickups (spawn pickup)	◐	◐	◐
Player runtime effects / vehicle basics & colors	✅	◐	◐
Vehicle neon, freecam / top-down camera, random cheats, scene particles & cutscenes	✅	✖	✖

GTA III bullet tracking is a stub; on VC / III, ◐ means the page is available but some actions are limited.

Supported games

Game	Rendering path	Notes
GTA III	D3D8to9 + D3D9	D3D8to9 required
GTA Vice City	D3D8to9 + D3D9	D3D8to9 required
GTA San Andreas	D3D9	Native D3D9

Requirements

• DirectX End-User Runtime
• Visual C++ Redistributable 2022 x86
• Ultimate ASI Loader
• SilentPatch recommended
• D3D8to9 GTA III / Vice City only

Installation

Option A: Installer

1. Prepare the game install.
2. Run XMenuInstaller.exe and follow the wizard.
3. Optional components: ASI Loader, SilentPatch, D3D8to9, or XMenu only.
4. Version info prefers GTAMODX; packages come from GitHub Releases.
5. Start the game and press M.

Option B: Manual copy

1. Install requirements.
2. Copy XMenuSA.asi (matching your game: XMenuVC.asi / XMenuIII.asi) into the game's plugins folder (or game root).
3. Copy the XBase folder (contains Mods\XMenu with data and ui.html) into the game root.
4. For GTA III / Vice City, also copy d3d8.dll.
5. Start the game and press M.

Recommended layout:

GameRoot/
├─ plugins/
│  ├─ XMenuSA.asi      (use the asi matching your game)
│  ├─ XMenuVC.asi
│  └─ XMenuIII.asi
├─ XBase/
│  ├─ Library/
│  │  ├─ XBaseSA.dll / XBaseVC.dll / XBaseIII.dll
│  │  └─ WebView2Loader.dll
│  └─ Mods/
│     └─ XMenu/
│        ├─ data/
│        │  ├─ sa/
│        │  ├─ vc/
│        │  ├─ iii/
│        │  └─ i18n/
│        └─ ui.html
└─ d3d8.dll

Runtime files:

XMenu/config.json
XMenu/debug.log

config.json stores menu state, hotkeys, weapon assist, fire rate, and more.
Startup is staged across frames; resource JSON loads on demand.

Add a new language

Language files:

XMenu/data/i18n/<language>/

Source:

src/data/i18n/<language>/

Copy an existing language folder, update index.json, and translate JSON values only. Keep keys unchanged. Then rebuild or copy into the game folder.

Build

Visual Studio, MSVC, Win32; plugin-sdk via PLUGIN_SDK_DIR; tools/premake5.exe.

Build.bat Release --no-pause

Optional: Debug / Release, --toolset v143|v145, --no-pause.
Setup.bat helps with first-time setup.

Output:

build/bin/XMenuSA.asi
build/bin/XMenuVC.asi
build/bin/XMenuIII.asi
build/bin/XMenuInstaller.exe
build/bin/XBase/Mods/XMenu/data/**
build/bin/XBase/Mods/XMenu/data/i18n/**
build/bin/XBase/Mods/XMenu/ui.html

Path	Purpose
tools/build_i18n_split.py	Maintain i18n data
tools/dataEditor/	Python data editor
tools/build_plugin_sdk.bat	Build plugin-sdk
tools/resolve_vc_toolset.ps1	Resolve MSVC toolset

Source layout

XMenu/
├─ src/
│  ├─ controllers/
│  ├─ data/i18n|sa|vc|iii/
│  └─ main.cpp
├─ installer/
├─ include/
├─ tools/
├─ Build.bat / Setup.bat / premake5.lua
└─ images/

Links

• GitHub: YuiNijika/XMenu
• GTAMODX: XMenu page
• Bilibili: Tomoriゞ
• QQ Group: GTAMODX QQ Group

XMenu is free. Reselling or commercial redistribution is not allowed.