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

Скрипт для роботи з paths.ipl (і не лише).
Для роботи потрібно: 3dsMax 2008 та вище.
Можливості:
- Імпорт шляхів GTA VC, GTA3, GTA SA (у тому числі підтримка шляхів формату Fastman92, тільки формат FLA4)
- експорт шляхів GTA VC (експорт всіх типів ліній, що підтримуються грою (від 3-х до 12 точок включно));
- Можливість призначати тип колії (педи, тачки, човни) кожної лінії. Якщо не призначено тип шляху, скрипт автоматично призначить тип, виходячи зі значення Default Path Type;
- Можливість створювати та експортувати перехрестя (Т-подібні та хрестоподібні). Докладніше дивіться в "Створення перехресть.docx" або .avi файли;
- Можливість змінювати параметри кожної лінії/точки. Для зміни параметрів достатньо вибрати лінію. Усі зміни будуть автоматично збережені;
Не потрібно самому все вбивати – якщо налаштування лінії не призначено, скрипт автоматично їх згенерує;
- Можливість імпорту/експорту .dat файлів шляхів із папки data/paths;

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

Зміни у версії 2.7d (оновлення 02.11.2024)
- При імпорті шляхів GTASA тепер зварювання точок сплайнів відбувається автоматично – більше не потрібно натискати OK для продовження процесу імпорту.
- Додана допоміжна кнопка Reverse Knot Order.
- Прибрано підтримку версій 3dsMax нижче 2008 (через відсутність у молодших версіях 3dsmax функції зварювання вертексів сплайну weldspline).
- Виправлено код імпорту SA шляхів - тепер на стику регіонів не будуть присутні однакові сегменти шляхів.
- Виправлено код відображення параметрів шляхів у в'юпорті - у разі відсутності значення параметра тепер не відображатиметься undefined.
- Невеликі виправлення за кодом.

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

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

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

Скрипт підтримує імпорт шляхів 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.
Процес імпорту стандартних шляхів може тривати від кількох десятків секунд до десяти хвилин.
Шляхи імпортуються у вигляді сплайнів, які можна відредагувати або налаштувати за допомогою SA Path Tool by Deniska.
Автор не гарантує 100% працездатність шляхів GTASA після їх імпорту/експорту.
Настійно рекомендується перевіряти налаштування всіх ліній, у тому числі правильність налаштувань світлофорів!
Є можливість завантажити шляхи у форматі GTAVC.
Скрипт за замовчуванням обробляє шляхи GTASA у процесі імпортування, а саме видаляє однакові сегменти та зварює крапки з метою подальшої можливості редагування ліній шляхів під GTASA або під GTAVC/GTA3.
Ці функції можна вимкнути в графі GTASA Import Settings, але в цьому випадку лінії шляхів абсолютно непридатні для редагування під GTASA або під GTAVC/GTA3. Це може бути корисним, якщо необхідно візуально ознайомитися з картою шляхів (імпорт стандартної карти шляхів без обробки займає приблизно 3-4 хвилини).
Докладно написано у "Імпорт шляхів GTA SA.docx".

При створенні нової лінії колії скрипт автоматично призначає їй налаштування, виходячи з параметрів у блоці Default Parameters!
Зверніть увагу, що параметри Lanes для внутрішніх точок завжди дорівнюють 1 1! Для призначення напрямку руху та кількості смуг достатньо редагувати лише кінцеві (зовнішні) точки.

Використовуйте вкладку Display helper для відображення параметрів ліній у в'юпорті. Для відображення доступні номери точок, число смуг, прапори, ширина шляху, координати точок.

Використовуйте функцію Reset User Properties для скидання параметрів за замовчуванням у виділених лініях.
У випадку помилки "Підписи не підтримують 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 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 – змінити напрямок руху.
Не працює у разі перехресть, що примикають один до одного!
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.

Використовується код скрипта sa path tool авторства Deniska.

aleks926820. 23:41 02.11.2024