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

Скрипт для роботи з paths.ipl (і не тільки)! }! Можливості:
- Імпорт шляхів GTA VC, GTA3, GTA SA числі підтримка шляхів формату Fastman92, тільки FLA4 формат)
SA у форматі Vice City/3 (див.нижче); Можливість призначати тип шляху (педи, тачки, човни) кожної лінії. .Докладніше дивіться в "Створення перехресть.docx" або .avi файли
у кожної лінії/точки. Для зміни параметрів достатньо вибрати лінію
експорту .dat файлів шляхів із папки data/paths;

- можливість конвертації VC Paths.ipl у формат шляхів GTA 3;
- відображення номерів вертексів редагованої лінії у в'юпорті;
- відображення прапорів колії, числа смуг, координат та ширини колії у в'юпорті;
- функція зміни напрямку руху шляху;
- функція призначення напрямку руху шляху (односторонній/двосторонній);
- функція розбивки ліній з числом точок, більше 12 (для вибраних ліній);
- функція скидання параметрів ліній (для вибраних ліній);
- Функція увімкнення/вимкнення автомобільного трафіку.
- Функція автоматичного налаштування перехресть на основі ліній, що примикають до них (функція ще не дописана належним чином).
- Функція видалення "неправильних" ліній із числом точок менше 2.

Зміни у версії 2.7e (оновлення 19.11.2024)
- Світлофори колій GTASA тепер імпортуються коректно.
- Додано завантаження параметрів шляхів у форматі Vice City при завантаженні шляхів San Andreas (поки що бета-версія). Автор не гарантує повну працездатність шляхів!

Тип ліній Splines - Line, що підтримується. Initial Type - Corner. Drag Type - Bezier.
Не використовуйте модифікатори до ліній! Це може призвести до неможливості нормально експортувати шляхи та створювати перехрестя.
Для зручнішого прописування шляхів використовуйте прив'язки в 3dsMax (див. докладніше .docx файли).

Приклад створення шляхів для GTAVC описаний у paths_tutorial[RU].pdf

Скрипт підтримує імпорт GTA VC. Якщо щось некоректно імпортувалося (наприклад, перехрестя), рекомендую виправити це вручну.
Не рекомендується використовувати цей скрипт для редагування стандартної карти шляхів, тому що при імпорті стандартної карти шляхів створюється більше ліній порівняно з оригінальним paths.ipl; після експорту файл шляхів важить більше, ніж оригінальний, і це призводить до того, що в деяких районах відсутні трафік або пішоходи.
Бажано використати скрипт для створення нових шляхів.


Скрипт підтримує можливість конверту 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.


Скрипт підтримує імпорт шляхів GTA SA, зокрема імпорт шляхів формату Fastman92.
Для імпорту треба натиснути кнопку Import GTASA Paths та вказати папку, де лежать 64 файли шляхів NodesXX.dat.
Процес імпорту шляхів може тривати від кількох десятків секунд до десяти хвилин.
Шляхи імпортуються у вигляді сплайнів, які можна відредагувати або налаштувати за допомогою SA Path Tool by Deniska.
Автор не гарантує 100% працездатність шляхів GTASA після їх імпорту/експорту.
Настійно рекомендується перевіряти налаштування всіх ліній, у тому числі правильність налаштувань світлофорів!
Є можливість завантажити шляхи у форматі GTAVC. Після імпортування настійно рекомендується перевірити та виправити налаштування шляхів, а також створені сплайни шляхів та перехрестя! Автор не дає гарантій, що імпортовані шляхи у форматі Vice City будуть цілком працездатними! У разі виявлення некоректних сплайнів колій та перехресть рекомендується перебудувати неправильний шлях (шляхи) вручну!

Ці функції можна вимкнути в графі 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 для відображення параметрів ліній у в'юпорті. Для відображення доступні номери точок, число смуг, прапори, ширина шляху, координати точок.


У випадку помилки "Підписи не підтримують splines з числом пунктів більшого 12 і меншого 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 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 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.


Для експорту необхідно вибрати ОДНУ лінію колії та натиснути експорт. Скрипт запропонує вибрати файл для збереження.

Подяки: Shagg_E; Starenat – за підтримку при написанні скрипту.

Окреме спасибі: Ilufir – за допомогу зі структурою шляхів GTASA, ZZPuma – за інформацію про світлофори шляхів GTASA.

Використовується код скрипта SA Path Tool авторства Deniska.