SA2VC Car Converter 1.1 beta [MAXScript]

A script that simplifies the conversion of cars from GTA SA to GTA VC.
Use at your own risk.
There may be some further changes.
Attention! The script does not work with standard materials!
Before using the script, make sure that all car materials use GTA_Material!

Version 1.1 (10/25/2024):
- Fixed a bug due to which the script would crash when generating a damaged element.
- Added a function for mass merging of selected objects.
- When converting, SA specular is now deactivated for all materials.
- Added a button to deactivate the specular for selected objects.
- Added a list of car component names. To rename: select a name from the list, select an object and click the Set Name button.
- Added the ability to configure the maximum and minimum vertex offsets for generating damaged elements.
- Added function for rebuilding the car hierarchy.

- Added a hierarchy display button.

Possibilities:
- Initial setup of a car for Vice with one click of the Convert button (car components are renamed, wheels are scaled to the correct size,
the wheel size and car size are displayed (for default.ide and handling.cfg, respectively)), the color is reset vehiclelights128);
- Ability to remove GTA SA license plates (option make transparent to carplate and carpback);
- Generation of damaged elements both during the conversion process and in manual mode;
- Ability to add a broken glass texture (use it carefully!); register texture With extension!;
- Ability to specify the texture of the car optics if a texture with a non-standard name is used; register the texture WITHOUT extension!;
- Ability to remove unnecessary dummy (option Delete SA Dummy);
- Ability to assign chrome to prim or sec material. To do this, you need to enter the name of the texture With extension and the intensity of chrome and check the boxes.

- Convert Handling.cfg to VC format. The converted handling will be in the MaxScript Listener window (press F11 to call it).
There are also several buttons for convenience:
- Set VehLights Color 255 255 255 — resets the vehiclelights128 color of the selected objects;
- Disable Reflection Map - disable chrome on selected objects (for example, wheels or the interior);
- Calculate Car Size — calculates the size of the car (for handling.cfg);
- Add _hi for selected - adds _hi to the selected objects. This button is needed for interior objects of the car, as well as for glass. Otherwise, interior elements will not be visible through the glass.
- Scale wheel to 1.0 — with this button you can selectively scale the wheels (if the car initially has wheels in addition to wheel_rf)
- Generate _dam element - with this button you can manually create damage to the selected elements! Attention! There may be errors when using this function! If an error occurs, restart the script and try again!
- Set Ambient - assigning an ambient tone for ALL materials for SELECTED objects.
- Set Diffuse - assigning diffuseness to ALL materials for SELECTED objects.

- Disable SA SpecMap - remove San Andres specular from materials.
- Mass Attach - combine selected objects into one object.
- Hide _ok elements — hide intact elements.
- Hide _dam elements — hide damaged elements.
- Unhide _ok elements — display undamaged elements.
- Unhide _dam elements — display damaged elements.
- Display hierarchy — open the hierarchy editing window.

How to use? Import .dff into max, run the script, click the Convert button, wait a little while the script rustles through all the components of the cars. This is about 10-20 seconds.
After the initial setup, you need to add _hi to the name of the interior elements or glass. To do this, you need to select these elements and click the add _hi for selected button.
After this, we make sure that the hierarchy is configured correctly and you can safely export .dff.

The script does not guarantee 100% performance of the car! After conversion, it is advisable to make sure that the hierarchy is configured correctly and that all components are present.
The rest of all kinds of problems with geometry and normals (and not only) must be corrected manually!

The script was written in 3ds max 2010 x64.

The script was written by aleks926820.
Script testing, error detection: AiExcel, Bryxanov1337.

e-mail: a-kostenko@bk.ru
Discord aleks926367#2994

The script is allowed to be posted on other resources, indicating the author’s email (a-kostenko@bk.ru) and the author’s website libertycity.ru.
It is prohibited to violate the integrity of the archive!