Vice City Paths IO Script v. 2.7e [MAXScript]

Скрипт для работы с paths.ipl (и не только).
Для работы требуется: 3dsMax 2008 и выше.
Возможности:
- Импорт путей GTA VC, GTA3, GTA SA (в том числе поддержка путей формата Fastman92, только FLA4 формат);
- Экспорт путей GTA VC (экспорт всех типов линий, поддерживаемых игрой (от 3-х до 12 точек включительно));
- Импортирование путей GTA SA в формате Vice City/3 (см.ниже);
- Возможность назначать тип пути (педы, тачки, лодки) каждой линии. Если не назначен тип пути, скрипт автоматически назначит тип, исходя из значения Default Path Type;
- Возможность создавать и экспортировать перекрестки (Т-образные и крестообразные). Подробнее смотрите в "Создание перекрестков.docx" или .avi файлы;
- Возможность менять параметры у каждой линии/точки. Для изменения параметров достаточно выбрать линию. Все изменения будут автоматически сохранены;
Не нужно самому всё вбивать — если настройки линии не назначены, скрипт автоматически их сгенерирует;
- Возможность импорта/экспорта .dat файлов путей из папки data/paths;
- Кнопки выбора путей по их типу (выбор всех путей трафика/педов/лодок);
- Возможность конвертации VC Paths.ipl в формат путей GTA 3;
- Отображение номеров вертексов редактируемой линии во вьюпорте;
- Отображение флагов пути, числа полос, координат и ширины пути во вьюпорте;
- Функция смены направления движения пути;
- Функция назначения направления движения пути (одностороннее/двустороннее);
- Функция разбивки линий с числом точек, больше 12 (для выбранных линий);
- Функция сброса параметров линий (для выбранных линий);
- Функция включения/отключения автомобильного трафика.
- Функция автоматической настройки перекрестков на основе примыкающих к ним линий (функция еще не дописана должным образом).
- Функция удаления "неправильных" линий с числом точек меньше 2.

Изменения в версии 2.7e (обновление 19.11.2024)
- Светофоры путей GTASA теперь импортируются корректно.
- Добавлена загрузка параметров путей в формате Vice City при загрузке путей San Andreas (пока что бета версия). После импортирования путей в формате Vice City настоятельно рекомендуется проверять параметры путей а также созданные сплайны путей и перекрестки! Автор не гарантирует полную работоспособность путей!

Поддерживаемый тип линий Splines — Line. Initial Type — Corner. Drag Type — Bezier.
Не применяйте модификаторы к линиям! Это может привести к невозможности нормально экспортировать пути и создавать перекрестки.
Для более удобного прописывания путей используйте привязки в 3dsMax (см. подробнее .docx файлы).

Пример создания путей для GTAVC описан в paths_tutorial[RU].pdf

Скрипт поддерживает импорт путей GTA VC. Если что-то некорректно импортировалось (например, перекрестки) рекомендую исправить это вручную.
Не рекомендуется использовать данный скрипт для редактирования стандартной карты путей, ввиду того, что при импорте стандартной карты путей создается больше линий по сравнению с оригинальным paths.ipl; после экспорта файл путей весит больше, чем оригинальный и это приводит к тому, что в некоторых районах отсутствует трафик или пешеходы.
Желательно использовать скрипт для создания новых путей.

Скрипт поддерживает импорт путей GTA3 — только импорт, для экспорта необходимо экспортировать пути в формат Vice City, и далее отконвертировать в формат GTA3.
Скрипт поддерживает возможность конверта paths.ipl в формат путей GTA 3.
Для этого необходимо указать стартовый ID пути, префикс для моделей путей, имя для IPL IDE COL, множитель координат путей, с которым экспортировался paths.ipl (для стандартного .exe равен 16)
После чего выбрать директорию, куда будут экспортироваться файлы путей GTA 3 и последним шагом выбирается paths.ipl.
Скрипт уведомит о завершении процесса конвертации. Файлы IPL IDE COL полностью готовы для добавления в игру.
Не рекомендуется использовать эту функцию для редактирования стандартных путей!
Желательно использовать функцию для создания путей новой карты или добавления новых путей к оригинальным путям.

Обратите внимание, что при добавлении путей в GTA 3 при наличии оригинальных необходимо повышать лимит аджастером Dynamic Limits: Buildings, PtrNodes, EntryInfoNodes, Treadables; [Pool Limits]: Objects Models; лимит по DFF файлам [ID LIMITS].
Для этого используйте Limit Adjuster by Vitlgt. Также стоит установить параметр "Enable path limits patch=1" и повысить максимальный ID в блоке PATH LIMITS.
Для повышения лимита путей в Vice City необходимо использовать Maxorator's Path hack.

Скрипт поддерживает импорт путей GTA SA, в том числе импорт путей формата Fastman92.
Для импорта надо нажать кнопку Import GTASA Paths и указать папку, где лежат 64 файла путей NodesXX.dat.
Процесс импорта путей может занимать от нескольких десятков секунд до 10 минут.
Пути импортируются в виде сплайнов, которые можно отредактировать или настроить с помощью SA Path Tool by Deniska.
Автор не гарантирует 100% работосопособность путей GTASA после их импорта/экспорта.
Настоятельно рекомендуется проверять настройки всех линий, в том числе и правильность настроек светофоров!
Есть возможность загрузить пути в формате GTAVC. После импортирования настоятельно рекомендуется проверить и исправить настройки путей а также созданные сплайны путей и перекрестки! Автор не дает гарантий, что импортированные пути в формате Vice City будут полностью работоспособны! В случае обнаружения некорректных сплайнов путей и перекрестков рекомендуется перестроить неправильный путь (пути) вручную!
Скрипт по умолчанию обрабатывает пути GTASA в процессе импортирования, а именно удаляет одинаковые сегменты и сваривает точки в целях дальнейшей возможности редактирования линий путей под GTASA или под GTAVC/GTA3.
Можно отключить эти функции в графе GTASA Import Settings, но в этом случае линии путей абсолютно непригодны для редактирования под GTASA или под GTAVC/GTA3. Это может быть полезно, если необходимо визуально ознакомиться с картой путей (импорт стандартной карты путей без обработки занимает примерно 2 минуты).
Подробно написано в "Импорт путей GTA SA.docx".

При создании новой линии пути скрипт автоматически назначает ей настройки, исходя из параметров в блоке Default Parameters!
Обратите внимание, что параметры Lanes для внутренних точек всегда равны 1 1! Для назначения направления движения и количества полос достаточно редактировать только конечные (внешние) точки.
Или используйте кнопки set one-way/set two-way traffic для назначения одностороннего или двустороннего движения и используйте кнопку Change the direction of traffic для смены направления движения.
Для отображения параметров линий во вьюпорте используйте вкладку Display helper. Для отображения доступны — номера точек, число полос, флаги, ширина пути, координаты точек.

Для сброса параметров по умолчанию у выделенных линий используйте функцию Reset User Properties.
В случае ошибки "The script does not support splines with a number of points greater than 12 and less than 3!Please edit the spline" примените функцию Split Lines to VC Format.
Эта функция разделяет линию на n-ное количество линий, если число ее точек строго больше 12 или разбивает линию до трёх точек, если у искомой линии их две (Vice City не поддерживает линии с двумя точками).
Для экспорта трафика достаточно выбрать линии и нажать кнопку Export Paths. Готовые строки для Paths.ipl будут выведены в окне MAXScript Listener (в левом нижнем углу 3Ds max или нажмите F11 для вызова MAXScript Listener).

Скрипт имеет возможность создавать перекрестки двумя способами:
1) — У каждой линии ОТДЕЛЬНО выбрать по одной точке в режиме редактирования вершин
— Выделить линии и нажать кнопку Create Crossroad
2) — Нажать кнопку Create Dummys at line end
— Выделить дамми и нажать кнопку Create Crossroad

Краткое описание кнопок:

Set Ped — назначить линии трафик пешеходов.
Select all Ped Paths — выбрать все пути пешеходов.
Set Car — назначить линии трафик авто.
Select all Car Paths — выбрать все пути авто.
Set Boat- назначить линии трафик лодок.
Select all BoatPaths — выбрать все пути лодок.
Select All Paths — выбрать все пути.
Import GTAVC Paths — импортировать пути GTAVC.
Import GTA3 Paths — импортировать пути GTA3.
Import GTASA Paths — импортировать пути GTASA.
Import GTASA Paths (Fastman92 FLA4 format only!) — импортировать пути GTASA формата Fastman92.
Delete Double Segments — удалять одинаковые сегменты при импорте путей GTASA. Для возможности редактирования путей эта галочка должна стоять!
ViceCity/III format (beta) — преобразовывать пути GTASA в формат GTAVC/GTAIII. Необходимо ставить эту галочку, если в дальнейшем пути будут настраиваться только под GTAVC/GTAIII!
Weld paths knots and split paths — сваривать точки путей и разделять линии при импорте путей GTASA. Для возможности редактирования путей эта галочка должна стоять!
Create CrossRoad — создать перекресток (на основе вспомогательных дамми или на основе выделенных точек сплайнов)
Set CrossroadPath name — Обозначить путь как перекресток. При неправильной настройке перекрестка скрипт проигнорирует эту линию.
Create dummy at line ends — создать дамми на концах линий. Полезно для создания перекрестков.
Delete all dummy — удалить все вспомогательные дамми.
Display vertex number — отображать во вьюпорте номера точек путей (при условии что число точек в линии лежит в интервале от 2 до 12 включительно).
Display Lanes — отображать во вьюпорте число полос линии.
Display width — отображать во вьюпорте ширину пути.
Display flags — отображать во вьюпорте флаги путей.
Display XYZ coordinate — отображать во вьюпорте координаты точек.
Import .dat — импортировать .dat файл путей flightX.dat/tracksX.dat/spathX.dat.
Export .dat — экспортировать .dat файл путей.
Split lines — преобразовать выбранные линии в формат путей GTAVC/III.
Reset user properties — сбросить все настройки у выбранной линии.
Enable Traffic — включить трафик (выставляет флаг 0)
Disable Traffic — выключить трафик (выставляет флаг 1)
Delete zero shapes — удаляет неправильные линии с числом точек меньше 2.
Reverse knot order — изменяет приоритет точек.
set one way traffic — сделать одностороннее движение.
set two way traffic — сделать двухстороннее движение.
Change direction traffic — изменить направление движения.
Assign Line Parameter for Crossroad by lines — настроить число полос у перекрестков на основе примыкающих к ним линий. Не работает в случае примыкающих друг к другу перекрестков!
Select Directory — выбрать директорию для экспорта файлов путей GTA3.
Select ViceCity paths.ipl — выбрать Vice City paths.ipl для его преобразования в формат путей GTAIII.

Скрипт поддерживает импорт и экспорт .dat файлов путей GTA 3 или GTA Vice City из папки data/paths, а именно flightX.dat, tracksX.dat, spathX.dat, где X — номер файла.
Для экспорта необходимо выбрать ОДНУ линию пути и нажать экспорт. Скрипт предложит выбрать файл для сохранения.

Благодарности: Shagg_E; Starenat — за поддержку при написании скрипта.

Отдельное спасибо: Ilufir — за помощь со структурой путей GTASA, ZZPuma — за информацию о светофорах путей GTASA.

Используется код скрипта SA Path Tool авторства Deniska.