LC FiveM Tools is a Visual Studio Code extension for working with GTA V assets used by FiveM: textures, models, maps, MLOs and vehicles.
Features
Vehicle Studio (.yft)
- Open a vehicle and see it in 3D with its textures, paint, glass, lights and wheels.
- Editor layout: toolbar (move, rotate, mirror, duplicate, delete, day/night, sirens, save), an outliner of the vehicle, its props and lights, the 3D view, an inspector for whatever is selected, and an asset browser below.
- Assets: 121 props (at most 8 per category): light bars, beacons, grille and interior lights, spotlights, push bars, computers, radios, radar and laser speed meters, plate scanners, weapon racks, antennas, cargo and more, plus your own. Drag one onto the vehicle where it goes, or double-click. Search, categories and favourites.
- Props: click one in 3D or in the outliner; move and rotate with the arrows or type exact values; mirror to the other side; make it standard or an extra (1-12) that can be switched on and off in game. Keys: W move, E rotate, M mirror, D duplicate, Del delete, Ctrl+S save.
- Lights: every lens on a prop is a light. Pick colours and a flash pattern, then fine-tune each light (colour, 32-step flash pattern, rotation, speed). Day and night preview.
- Basics: display name, vehicle class and role (emergency vehicle, law enforcement).
- Livery: save a PNG template of the body's UV layout, paint a livery on it, then add it back: it becomes a
<model>_sign_N texture and a livery you can pick in game (vehicles without liveries get a livery slot).
- Save: one save writes
vehicles.meta, the siren setting and builds the props into the .yft files. The original models are kept, so you can change the build as often as you like. The vehicle keeps the engine sound of the car it came from; a small client script (vehicle_setup.lua) gives it a siren sound, with nothing to choose, and switches on the extras the props sit on when the vehicle spawns.
- Prop Editor: turn a model from LCPDFR, Sketchfab, Blender or another vehicle (
.z3d from ZModeler 3, .obj, .ydr, .yft) into a prop: pick its parts and materials, click its lights on and point them, save it to your props folder.
- Paint: all 160 GTA colours plus the vehicle's colour variations.
- Liveries: every
*_sign_N livery in the vehicle's texture dictionary, drawn over the paint the way the game does.
- Mod kits: pick spoilers, bumpers, roofs and other
visibleMods from carcols.meta.
- Parts: toggle extras and open doors, bonnet and boot.
- Edits change only the values involved; the rest of each meta file is kept byte for byte.
YTD viewer
- Gallery of every texture, five per row, with fast mip-level thumbnails and search.
- Preview DXT1, DXT3, DXT5, ATI1, ATI2 and uncompressed (A8R8G8B8, A8B8G8R8, L8, A8) textures.
- Export to PNG. Import a PNG/JPG into DXT1 or DXT5 textures; the original format is kept and every mip level is regenerated.
YMAP viewer
- Entities in 3D with their models, resolved through binary and XML
.ytyp files in the resource.
- Click an entity to see its archetype, position, flags and model status.
YDR viewer
- Drawable geometry in 3D, including skinned props.
Vehicle Library: new vehicles from the game's own
Rockstar's vehicles cannot be shipped with the extension, so you export them once from your own game (see docs/vanilla-vehicles-export.md): a folder with base\ (the .yft/.ytd files) and meta\ (vehicles.meta, handling.meta, carcols, carvariations). DLC vehicles go in dlc\models\ and dlc\meta\, exported with OpenIV's search.
- Command palette (Ctrl+Shift+P): LC FiveM Tools: Open Vehicle Library. The first time, pick the export folder.
- Search for a vehicle and pick it.
- Pick an action:
- Create add-on vehicle: a copy under its own spawn name, with its own metas and handling. Vehicle Studio opens in the builder, where you equip it.
- View in Vehicle Studio: read only; the library itself is never changed.
- Enter the spawn name (the prefix comes from the setting
lcFivemTools.vehicleNamePrefix, default lc_) and pick the folder to create the resource in.
- Copy the new resource folder to your server's
resources and run refresh and ensure <spawn name> in the server console.
Every vehicle you make is an add-on with its own spawn name; the game's own vehicles are never changed.
Props
The props are 3D models made in Blender (source in props-src/props.blend) in the extension's props folder, each with a preview picture; see props/README.md. Props can also be written by hand as simple shapes. Add your own in any folder and point the setting lcFivemTools.propsFolder at it.
Requirements
- Visual Studio Code 1.125.0 or newer.
- GTA V / FiveM resources in RSC7 format. Escrow-protected files cannot be opened.
Known limitations
- Textures from GTA's shared dictionaries (such as
vehshare.ytd, used by vehicle_generic_* textures) are not part of a resource, so those surfaces use plain material colours.
- Texture import does not resize images or change a texture's format.
- Props use the vehicle's own materials (no textures of their own yet);
.ydr models as props are not supported yet.
- Frameworks with their own vehicle list (for example ox_core's
vehicles.json) must be told about new spawn names.
- YBN collision files are not supported yet.
Back up your files. The YTD importer and the Vehicle Studio write directly to the files in your resource. Vehicle Studio always asks before creating or changing several files at once.
License
See the repository for licensing information.
| |