SplineToFieldGenerator — это скрипт для GIANTS Editor, который помогает создавать поля с помощью сплайнов, сохраняя минимально возможное количество точек полигона (polygonPoints). Скрипт экономит значительный объём работы, особенно при работе с очень большими полями или полями неправильной формы.

Возможности:
- Простое создание полей с помощью fieldBoundarySpline
- Создание «островков» на поле с помощью: fieldIslandSpline/fieldIslandSmallSpline
Островки на поле полностью необязательны.

Возможности интерфейса:
- Создание всех необходимых сплайнов и групп
- Генерация polygonPoints
- Показ и скрытие сплайнов
- Режим отладки (Render Debug) для наглядного отображения сгенерированных polygonPoints выбранного поля с учётом текущих настроек, включая обновление в реальном времени при их изменении
- Удаление всех сплайнов и групп как у выбранного поля, так и у всех полей сразу

Примечание: при первом удалении сплайнов и групп автоматически создаётся резервная TransformGroup по пути: SplineToFieldGenerator -> Backup. Удалённые сплайны и группы сохраняются там под именем fieldXXBackup. Эта система резервного копирования позволяет сохранить сплайны и группы поля на случай случайного удаления или необходимости внести изменения позже. Кроме того, скрипт выполняет множество автоматических проверок и выводит в консоль GE полезные сообщения, поясняющие, что происходит в данный момент или почему определённые функции не могут быть выполнены.

Пример структуры поля:
Прежде всего, вам нужно поле, созданное с помощью FieldToolkit в GIANTS Editor или другого скрипта, поддерживающего создание полей.

Простое поле:
fields
----└── fieldXX
--------├── polygonPoints (transformgroup)
--------├── nameIndicator (transformgroup) — стандартная структура GIANTS
--------├── teleportIndicator (transformgroup)
--------└── fieldBoundarySpline (Spline) — структура SplineToFieldGenerator

Поле с островками:
fields
----└── fieldXX
--------├── polygonPoints (transformgroup)
--------├── nameIndicator (transformgroup) — стандартная структура GIANTS
--------├── teleportIndicator (transformgroup)
--------├── fieldBoundarySpline (Spline) — структура SplineToFieldGenerator
--------└── fieldIsland (transformgroup)
------------└── fieldIslandSpline (Spline)

TransformGroup fieldIsland должна быть правильно выровнена по островкам на поле. Синие отладочные линии в режиме Render Debug помогают наглядно проверить, корректно ли области распознаются как островки при генерации.

Поле с труднодоступными островками:
fields
----└── fieldXX
--------├── polygonPoints (transformgroup)
--------├── nameIndicator (transformgroup) — стандартная структура GIANTS
--------├── teleportIndicator (transformgroup)
--------├── fieldBoundarySpline (Spline) — структура SplineToFieldGenerator
--------└── fieldIsland (transformgroup)
------------├── fieldIslandSpline (Spline)
------------├── fieldIslandSpline (Spline)
------------└── fieldIslandWaypoint (transformgroup)
----------------└── fieldIslandSpline (Spline)

fieldIslandWaypoint используется для предоставления одному или нескольким объектам fieldIslandSpline дополнительной TransformGroup, что позволяет точнее генерировать труднодоступные островки. Это особенно полезно для очень сложных или сильно изрезанных форм полей.

Важные примечания:
Иерархия не обязана в точности повторять порядок, показанный в примерах. Внутри скрипт обрабатывает данные в следующем порядке: fieldBoundarySpline -> fieldIsland (transformgroup). Неважно, где именно находится fieldBoundarySpline внутри группы fieldXX — скрипт сначала автоматически ищет её. Единственное важное требование: всё, в чьём имени содержится fieldIsland, должно находиться внутри TransformGroup fieldIsland. В противном случае возможны некорректные или неожиданные результаты генерации.

Также обратите внимание, что скрипт не всегда может генерировать идеально точные формы полей во всех ситуациях. Из-за технических ограничений сплайнов углы иногда могут получаться слегка скруглёнными или неровными, поскольку сплайны не могут создавать идеально точные углы в 90 градусов. Поэтому некоторые углы и переходы впоследствии могут потребовать небольшой ручной корректировки.

Установка:
1.) Запустите последнюю версию GIANTS Editor
2.) В верхнем меню перейдите к Window -> Script Editor и откройте редактор скриптов
3.) Щёлкните правой кнопкой мыши по папке, в которой хотите хранить скрипт (например, Shared Scripts), и выберите «Explore Folder»
4.) Скопируйте файл SplineToFieldGenerator.lua в выбранную папку скриптов и перезапустите GIANTS Editor
5.) После этого скрипт будет доступен в GIANTS Editor через верхнее меню в разделе Scripts

Список изменений:
1.0.0.1 — код скрипта обновлён для поддержки GIANTS Editor 10.0.12.
Важно! Это обновление требует GIANTS Editor 10.0.12 и Farming Simulator 25 версии 1.19.0.0 или новее.