GTA Stuff

Ariane

Map Editor for GTA III, Vice City & San Andreas

GTA III Vice City San Andreas
Download from Discord

Essentials

C Navigate

W A S D Move camera (hold keys)
LMB drag Look around (FPS)
Alt + MMB Orbit around target
MMB Pan camera

P Place & Select

B Object Browser (pick & place)
LMB Select / place object
Shift + LMB Add to selection
Esc Exit place mode

M Transform

W Translate mode (move objects)
Q Rotate mode
G Snap selection to ground
Shift + G Align to ground normal + keep facing
Snap (Object Info panel) Snap translation to grid or rotation to angle presets

E Edit & Save

Ctrl + S Save all modified IPLs
Del / Backspace Delete selected + LODs
Ctrl + Z / Y Undo / Redo
Ctrl + C / V Copy / Paste (auto LOD linking)
Ctrl + R Hot Reload into running game
Ctrl + G Test in Game (Windows)

More Controls

Camera

C Toggle viewer camera (extends far clip distance)
Ctrl + Alt + MMB Zoom into target
Ctrl + Alt + LMB Alternative mode — W/S for forward/backward

Placement

RMB Cancel and exit place mode
Snap to clicked object Place on the collision surface of the object you click
Snap to ground below Place on the ground directly below the click point

Selection

Alt + LMB Remove object from selection
Ctrl + LMB Toggle selection (select/deselect)
RMB on selection Deselect
RMB on deleted instance Undelete it
Double-click in Editor list Jump camera to that instance
i

The Object Browser (B) has four tabs: Categories, IDE (filter by source file), Search (full-text), and Favourites. Right-click any object to add/remove it from favourites.

i

In the Object Info window (I), enable Ground Follow While Dragging to keep objects on the terrain as you move them. The sub-option Align To Surface also rotates them to match the slope.

i

The Editor window (E) has camera presets — save, load, and manage named positions for quick navigation.

!

Deleted instances are commented out with # in the IPL files when saved — not permanently removed. Right-click a deleted instance to undelete it before saving.

Hot Reload & Test in Game

Ctrl + R Hot Reload — push all changes to GTA SA while it's running (move, add, delete)
Ctrl + G Test in Game — save IPLs and launch the game with your changes (Windows only)
i

Hot Reload (Ctrl+R) patches streaming IPLs directly inside the IMG archive and sends entity commands (add, move, delete) to the running game via the Ariane plugin. No need to restart GTA — changes appear in real time. Currently supported for San Andreas.

i

Test in Game (Ctrl+G) requires the ariane.asi plugin installed in your game directory. It saves all modified IPLs, launches GTA, and teleports you directly to your current Ariane camera position — so you instantly spawn right where you were editing.

All Features— windows, view options, gamepad, quick reference

Windows & Panels

Toggle editor panels with a single key.

B Object Browser — 3D preview, categories, IDE, search, favourites, placement
E Editor — camera presets, CD images, selection list, instance browser
I Object Info — gizmo controls, instance properties & flags
T Time & Weather — hour, weather, extracolour, wet roads
V View — collision, zones, paths, water, draw distance, LOD mode
R Rendering — post effects, building pipes, fog, backface cull

Object Browser (B)

B

3D preview of selected object. Four tabs: Categories, IDE (filter by source file), Search (full-text), and Favourites. Mark objects as favourites. Click "Place" to enter placement mode.

Editor (E)

E

Camera position/target, FOV slider, camera presets (save/load/delete). CD image browser. Full instance list with model name filter. Selection list with double-click-to-jump.

Object Info (I)

I

Gizmo mode toggle (translate/rotate). Snap to grid (translation) or angle presets (rotation). Ground-follow & align-to-surface options. Selected instance properties, object flags, effects, and path info.

Time & Weather (T)

T

Hour/minute controls, total-minute slider. Weather A/B selectors with interpolation. Extracolour (VC/SA), day/night balance (SA), wet road effect, Neo light map.

View (V)

V

Toggle collisions, zones (map/navig/cull/info/attrib), 2dfx, car & ped paths, water. Draw distance multiplier. Render mode: Normal / HD only / LOD only. Timed objects & area toggles.

Rendering (R)

R

PostFX toggle with game-specific colour filters (PS2/PC/Xbox/Mobile). Building pipe mode selector. Backface culling, PS2 alpha test, background, fog, TimeCycle boxes.

View & Rendering

Debug overlays, render modes and visual settings available from the View and Rendering panels.

Debug Overlays (View panel)

Draw CollisionsVisualize collision meshes
Draw ZonesMap, navigation, cull, info, and attribute zones
Draw 2dfx2D effects (GTA III & VC)
Draw Car / Ped PathsVehicle and pedestrian path nodes
Draw WaterWater plane visualization
Draw TimeCycle boxesTimeCycle regions (SA)
Play AnimationsToggle NPC animation playback (SA)

Render Modes

NormalDefault rendering — HD + LOD as the game does
HD onlyShow only high-detail models
LOD onlyShow only low-detail models

Draw Distance

Multiplier slider0.5x – 3.0x draw distance
Render all Timed ObjectsShow all time-dependent objects regardless of hour
Render all AreasShow objects from all interior areas simultaneously

Gamepad Controls

Full controller support for camera navigation.

Left StickOrbit camera around target
Right StickTurn / look around (first-person)
D-Pad UpDolly camera forward
D-Pad DownDolly camera backward
SquareZoom in
CrossZoom out
L2 heldHalf speed (0.5x sensitivity)
R2 heldDouble speed (2x sensitivity)
L2 + R2 heldQuad speed (4x sensitivity)
Start + Select (hold)Quit application
About Ariane Map Editor

What is Ariane?

Ariane is a free, standalone map editor for the classic GTA trilogy: GTA III, GTA Vice City, and GTA San Andreas. Built as a native C++ application on top of the librw RenderWare engine reimplementation, Ariane lets modders place, move, rotate, and delete any map object in a fully rendered 3D environment. All changes save directly back to IPL files and IMG archives — no manual file editing required.

Key Features

Ariane includes a powerful Object Browser with 3D preview, full-text search, category filtering, and a favourites system for quick access to frequently used objects. The editor supports translate and rotate gizmos with configurable snap settings, snap to ground with automatic surface normal alignment, and copy/paste with automatic LOD linking. A full undo/redo history ensures you never lose work.

For San Andreas, Ariane supports hot reload (Ctrl+R) — push your changes to a running game instance in real time via the Ariane ASI plugin. You can also use Test in Game (Ctrl+G) to save, launch GTA, and teleport directly to your current editor camera position.

Visualization tools include collision meshes, car and pedestrian paths, map/navigation/cull/info/attribute zones, water planes, TimeCycle boxes, and 2dfx effects. The time of day and weather can be adjusted in real time with full interpolation between weather states.

Supported Platforms

Ariane runs natively on Windows (Direct3D 9), macOS (OpenGL 3, ARM64 and Intel), and Linux (OpenGL 3). It auto-detects the game version when launched from a GTA game directory.

How to Get Ariane

Ariane is available as a free download from the GTA Stuff Discord server. Extract the archive into your GTA game folder and run the executable. The editor includes a built-in auto-updater that checks for new releases automatically.

Replaces the GTA Stuff Web Map Editor

Ariane replaces the browser-based GTA Stuff Map Viewer & Editor, which is now deprecated and will no longer receive updates. As a native desktop application, Ariane offers significantly better performance, more features, and direct file I/O that a browser environment cannot provide.

Credits

Ariane is forked from euryopa by aap, which provides the RenderWare rendering foundation. All map editing features — object placement, gizmo manipulation, undo/redo, IPL/IMG saving, hot reload, and the object browser — were built on top of this base.