FOnline Engine
Current 2026.1.4-dev GitHub
Документация Docs/ru/reference/changelog.md

История изменений движка

Здесь ведутся значимые для разработчиков изменения FOnline и заметки о миграции на русском и английском. Текущую версию разработки задаёт VERSION. Правила версий и выпусков определяют CalVer, даты выпусков, неизменяемые теги и границы совместимости.

Unreleased

2026.1.4-dev - 2026-10-04

Исправлено

  • Установка POSIX-обработчиков сбоев и повторное возбуждение сигнала с действием по умолчанию компилируются, когда операции над наборами сигналов в Darwin SDK заданы функциональными макросами. Пять вызовов сохраняют маски, флаги и значения сигналов; прежнее поведение функций в Linux сохранено.

Миграция

  • После обновления ревизии движка пересоберите затронутые нативные цели macOS. API проекта, настройки, сохранённые данные, ABI, протокол и формат ресурсов не меняются, поэтому миграция вызывающего кода и данных не требуется.

2026.1.3-dev - 2026-10-04

Исправлено

  • Тест документации конфигурации и инструментов учитывает все 194 обязательных актуальных перевода, включая страницы правил версий и истории изменений. Требования точного списка, отсутствия пропущенных переводов и полной локализации сохранены.
  • Оба руководства по переводу документации показывают тот же актуальный список страниц, что и сгенерированная модель локализации.

Миграция

  • Миграция проекта и преобразование данных не требуются: изменяются только документация и ожидания её теста. API игры, настройки, сохранённые свойства, нативный ABI, совместимость сети и форматы ресурсов сохраняют действующие контракты.

2026.1.2-dev - 2026-10-04

Исправлено

  • Хранилище сохранённого нативного контекста трассировки стека в macOS теперь вмещает контекст libunwind из SDK. Выравнивание на шестнадцать байт сохранено; остальные поддерживаемые платформы сохраняют прежний размер хранилища.
  • Форматирование нативных и управляемых исходников и поясняющие комментарии приведены к действующим проверкам стиля. Английское и русское руководства по отладке описывают границу платформенного контекста.
  • Проверки полноты документации учитывают новые страницы правил версий и истории изменений и их нормативные примеры, сохраняя точный список документов и контроль полноты.

Миграция

  • API игры, настройки, сохранённые свойства, протокол, ABI и формат ресурсов не заменяются. Существующие допустимые входные данные и маркеры совместимости выполнения сохраняют смысл, поэтому миграция данных проекта не требуется.
  • После обновления ревизии движка повторно сконфигурируйте и соберите нативные цели. Компиляция macOS должна использовать её SDK для проверки утверждения о размере сохранённого контекста; тесты Linux не подтверждают эту ветку macOS. Версия проекта и хеши сборок пакетов/обновления клиента остаются под управлением проекта.

2026.1.1-dev - 2026-10-04

Добавлено

  • CalVer движка из VERSION проверяется при конфигурации CMake, встраивается в FO_ENGINE_VERSION и выводится в логах запуска нативных приложений. FO_ENGINE_REVISION содержит SHA Engine и отметку -dirty при изменении отслеживаемых файлов отдельно от хеша сборки игрового проекта.
  • Ссылка версии в документации открывает эту историю изменений на выбранном языке. Данные навигации и маршрутов, а также данные для ИИ получают версию движка из того же исходного файла.
  • Двуязычные заметки и проверки выпуска задают владельца значимых для разработчиков изменений и обязательных инструкций миграции.

Изменено

  • Поддержка только актуального API Engine сохраняет первоначальный смысл существующих значений. Замены удаляют старый API и обеспечивают явные ошибки компиляции/перепекания/валидации и исчерпывающие двуязычные миграции; существующее преобразование сохранённых свойств через MigrationRule остаётся узким исключением.
  • Каждый опубликованный шаг master увеличивает minor и фиксирует год/дату UTC; релизные линии сохраняют год/major/minor среза и увеличивают patch, используя -rc при стабилизации. Правки только документации, CI, тесты и зависимости тоже учитываются.

  • Историческая заглушка 2022.1.0.wip в VERSION заменена идентификатором разработки в формате CalVer. Существующие исторические аннотации API Since сохраняют прежние значения.

Миграция

  • Ограничение полного контекста увеличено с 2 162 688 до 2 195 456 байт, чтобы включить полные обязательные правила обновления/миграции. Потребители данных документации учитывают объявленный full_context.max_bytes, а не фиксированный прежний буфер; включение документов целиком и проверка превышения лимита сохранены.

  • Прежняя черновая нотация YYYY.M.PATCH заменена. Используйте YEAR.MAJOR.MINOR-dev в master и YEAR.MAJOR.MINOR.PATCH[-rc] в release/YEAR.MAJOR; major — номер линии, месяц записан в дате заметки. Первое принятие политики задаёт 2026.1.1-dev. Потребители прежнего синтаксиса версии должны принимать эти точные формы и отвергать прежние суффиксы/окончательные трёхпольные версии; общий парсер — BuildTools/engine_version.py. Перед обновлением выполните полный список обновления, последовательность среза релиза и запись миграции.

  • Политика версий в манифесте документации теперь использует схему версии 3 и объявляет engine: {scheme: calver, source: VERSION, master_format: YEAR.MAJOR.MINOR-dev, release_format: YEAR.MAJOR.MINOR.PATCH[-rc]}. Собственные потребители, перегенерирующие эти артефакты, должны включить эту политику и предоставить файл VERSION движка. Обновляемая документация по-прежнему соответствует master.
  • Повторно сконфигурируйте и соберите нативные бинарники, чтобы получить идентификаторы движка. Версия игры, хеши сборок пакетов и обновления клиента, хеш совместимости выполнения, версии ABI и схем ресурсов сохраняют свои контракты; это изменение не требует миграции данных или повышения версии схемы ресурсов.

Предыдущая история

Поддерживаемый журнал начинается с подключения версии движка. Предыдущая работа доступна в истории репозитория и реестре изменений контрактов конкретных ревизий. Это свидетельства аудита, а не восстановленная последовательность опубликованных выпусков Engine.

Введите запрос.