Cassiopeia Papyrus Extender / Кассиопея - Расширитель Папируса для Starfield

Cassiopeia Papyrus Extender - это плагин расширяющий возможности Papyrus, языка скриптов движка игры Creation Engine. Сам по себе данный плагин ничего не добавляет в игру, НО требуется для работы многих модов. Cassiopeia Papyrus Extender регистрирует новые нативные функции, вызываемые из любого мода и скрипта. Другими словами, Cassiopeia — это инструмент для моддеров, позволяющий разрабатывать скриптовые моды способами, которые ранее были недоступны в Starfield, и писать скрипты стало удобнее.

Для моддеров:
Полный список функций можно посмотреть здесь https://drive.google.com/file/d/1pS0oYmXHe0EV4GeGbB0TYhuqmHxEtyRt/view (документ в Google Диске).
Список событий и регистрация событий находятся здесь https://drive.google.com/file/d/1DEg6mjH_InQYpldpTV3B2KNrwarsLs-P/view
В настоящее время реализовано около 430 новых нативных функций и около 60 нативных событий.

Примечание для авторов модов:
Всегда проверяйте свой скриптовый мод с помощью New Game + (SetStage 24EF9C 2000) при редактировании базовых форм в Cassiopeia, поскольку код менеджера сброса исходного состояния игры довольно требователен.

Требования:
Starfield версии 1.15.222 - 1.16.244
SFSE

Установка:
Установить через менеджеры модов, активация не требуется. Игру запускать всегда через SFSE.


Обновление:12.2
* Новые функции: RemoveAllNativeEventFilters, GetCurrentWorldSpaceLongitude, GetCurrentWorldSpaceLatitude, GetClosestWorkshop, GetDistanceGalacticMegaMeter, GetDistanceGalacticParsec, GetDistanceAstronomicalUnits, ReleasePapyrusObjectsArray, ReadHexFormIDsFromFile, GetDialogueLineData, IsTalking, SetQuestAliases.
* Реализован новый обработчик событий, который должен исключить ненужную нагрузку на движок, способную повлиять на определенные порядки загрузки.
* Оптимизация кода.

Обновление:12.0
* Исправлена ошибка в TESObjectLoadedEvent, из-за которой akReference мог принимать значение None.
* Исправлена ошибка в RegisterForNativeEvent, из-за которой функция могла возвращать True при попытке регистрации на событие, требующее указания akFormFilter, даже если массив фильтров форм содержал только элементы None.
* Новые функции: GetAllRefsLinkedToMeEx, GetAllLinkedRefsEx, AttachRefLight, RemoveRefLight, UpdateRefLight, IsVehicleInAir, IsPlayerOwnedShip, GetDroppedItemRef, GetGalaxyCell, ExportFormsToFile, ExportAllFormsToFile, ReadFormsFromFile, HasHeadPart, GetHeadPart, AddHeadPart, RemoveHeadPart, GetCraftingMenuRecipe, GetCustomMarkerPosition, IsParticleEmitter, IsOptional, SetOptional, ExecuteCommands, DoesFolderExist, IsSpaceshipPart, GetActorsOnHUD, GetCameraPosition, GetPlayerDigipickCount, PlayDefaultObjectWwiseEventForm, GetThreatRatio, FindUnusedFurnitureMarker, GetRefAliases, GetRefColls, GetLocAliases, SplitStrKC, ReplaceStrKC.
* Новые события: GlobalVariableChangedEvent, TESObjectLoadedEventStr.

Обновление:10.0
* Исправлена ошибка в `GetFormTypeAsString`, из-за которой функция могла возвращать числовой номер типа формы вместо его названия.
* Новые функции: `OpenContainerMenu`, `GetReticleTarget`, `SetReticleTarget`, `GetCruiseModeAutopilotTarget`, `SetCruiseModeAutopilotTarget`, `GetPropertySheet`, `SetPropertySheet`, `GetCellReferenceCount`, `GetFormByHexFormID`, `GetStarfieldGPUMemoryUsagePercent`, `GetTotalGPUMemoryUsagePercent`, `GetTotalGPUMemory`.
* Новые события (Events): `OnCruiseInterdiction`, `OnCruiseDeparture`, `OnCruiseLockCourse`, `OnCruiseUnlockCourse`, `Reticle_OnLongAnimFinished`, `TESFormDeleteEventStr`.
* Оптимизация кода.

Обновление:9.9
*Новые функции: IsResourceItem, IsNthItemFavorite, IsNthItemFeaturedItem, IsBA2ArchivePresent, GetItemComponents, SetItemComponents, GetSpaceshipBlueprints, GetFormLinks, SetFormLinks, GetActorValues, GetNthItemDamageOutputs, GetNthItemDamageResistances, GetActiveEffects, GetPackInCell, GetSpaceshipLinkedInteriors, GetSpaceshipLinkedExteriors, GetFavoriteItemIndexes, GetFeaturedItemIndexes, CanBeModifiedInScripts.
* Добавлен пример функции для поиска и логирования всех модулей космического корабля. См. новый раздел «Spaceship Reference».
* Небольшие улучшения для примера функции TransferAllLegenaryItems, добавленной в v9.8.
* Оптимизация кода.

Обновление:9.8
*Новые функции: `IsLegendaryMod`, `IsNthItemLegendary`, `GetObjectModsOfItem`, `GetNthItemBaseObject`, `DoesConsoleCommandExist`, `GetActiveEffectCount`, `IsPlayable`, `SetPlayable`, `IsNthWeaponCantDrop`, `IsNthItemPlayable`, `GetNthWeaponAmmo`, `SetNthWeaponAmmo`, `GetNthWeaponProjectile`, `SetNthWeaponProjectile`, `GetNthWeaponAmmoCapacity`, `SetNthWeaponAmmoCapacity`, `GetEquippedItemIndexes`.
* Добавлен пример функции инвентаря для авторов модов, позволяющий перемещать все легендарные и пригодные для использования (Playable) предметы из одного контейнера или инвентаря в другой.
* Улучшения для функции `PrintInventoryToFile`: если параметры `asFilePath` и `asFileName` оставлены пустыми, Cassiopeia автоматически добавит расширение файла (`.txt`) и время экспорта в имя файла.
* Функция `PrintInventoryToFile` теперь также экспортирует модификаторы предметов (Object Mods), прикрепленные к каждому предмету.

Обновление:9.7
* Исправлена ошибка, которая могла приводить к вылету игры при вызове функции `GetAllRefsLinkedToMe`.
* Новые нативные функции: `HasBaseFormComponent`, `GetCurrentPackageTargetRef`, `GetAITargetRef`, `GetAIFollowTargetRef`.
* Новые события с передачей данных (event data): `Workshop_ItemReleasedEvent`, `Workshop_BuildModeEnterEvent`, `Workshop_BuildModeExitEvent`, `Workshop_ItemHighlightEnterEvent`, `Workshop_ItemHighlightChangeEvent`, `Workshop_ItemHighlightExitEvent`.
* Добавлены данные событий (event data) для `Workshop_ItemGrabbedEvent` и `Workshop_PlacementStatusEvent`.
* Полный список всех жестко запрограммированных (hardcoded) значений статуса размещения (Placement Status), например *"Overlapping with player."*, приведен в файле `CassiopeiaPapyrusEvents.txt`.

Обновление:9.6
* Исправлена ошибка в событии `ActorCellChangeEvent`, из-за которой оно могло не отправляться после некоторых переходов.
* Исправлена ошибка в событии `ActorCellChangeEvent`, которая могла приводить к некорректному порядку параметров события.
* Событие `ActorCellChangeEvent` теперь передает `akPreviousCell` и `akCurrentCell` в рамках одного события вместо двух.
*(В одном из обновлений игры Bethesda, судя по всему, изменила логику кода, из-за чего оригинальный скрипт отправлял два отдельных события: одно с `akPreviousCell`, а другое с `akCurrentCell`. Теперь событие `ActorCellChangeEvent` объединяет их в одно и отправляет в Papyrus единственный вызов с заполненными обоими параметрами — для удобства и снижения лишней нагрузки на скрипты).

Обновление:9.5
* Исправлена ошибка, которая могла приводить к вылету игры при вызове функций GetWornItemsDamageOutput, если у некоторых предметов в инвентаре персонажа отсутствовали доступные данные экземпляра.

Обновление:9.4
* GetWornItemsWeight: Исправлена ошибка в функции `GetWornItemsWeight`, из-за которой расчет мог производиться на основе базового веса объекта вместо веса конкретного экземпляра, который учитывает модификаторы веса.
* GetDistanceGalacticLightYears: Исправлена ошибка, которая могла приводить к вылету (крашу) при вызове функции `GetDistanceGalacticLightYears`. Это происходило из-за незамеченного изменения ванильного кода в обновлении «Свободные пути» (Free Lanes).
* OnPlayerPlotRoute: Исправлена ошибка, из-за которой функция `OnPlayerPlotRoute` могла передавать некорректное значение `afShipGravJumpRange`. Причиной также стало незамеченное изменение ванильного кода в обновлении «Свободные пути» (Free Lanes).

Обновление:9.2
* Новые функции: `GetBodyWeight`, `SetBodyWeight`, `SetBodyWeightFromArray`, `GetWornItemsWeight`, `GetHairColor`, `GetFacialHairColor`, `GetEyebrowColor`, `GetTeethColor`, `GetJewelryColor`, `GetEyeColor`, `SetHairColor`, `SetFacialHairColor`, `SetEyebrowColor`, `SetTeethColor`, `SetJewelryColor`, `SetEyeColor`, `UpdateSkinTone`, `GetAIUpdateTimer`, `PauseAnimations`, `ResumeAnimations`, `AreAnimationsPaused`.
* В скрипт `CassiopeiaPapyrusExtender.psc` добавлен раздел CharGen (создание персонажа), который был объединен с разделом FaceGen (генерация лица). Для обоих разделов добавлены описания и примеры.
* Функции `GetSkinTone`, `UpdateAppearance`, `UpdateChargenAppearance`, `RestoreAppearance` и `SetSkinTone` перенесены из раздела Actor (актер) в новый раздел CharGen.

Обновление:9.0
* Добавлена ​​поддержка версии игры 1.16.244.

Обновление:8.2
* Новые функции: RemoveOutpost, CompletesQuest, FailsQuest, IsRunOnStartStage, IsRunOnStopStage, GetQuestStageItemCount, GetPerkRank.
* Новое событие с данными события: RemoveOutpostEvent.

Обновление:8.1
* Исправляет ошибку в обработчике событий, из-за которой при попытке отменить регистрацию только одного скрипта для события могло неожиданно отмениться несколько скриптов.
* Исправляет ошибку, из-за которой функции Alias, ReferenceAlias и RefCollectionAlias могли стать недоступными для вызова из-за незамеченного изменения ванильной структуры данных в обновлении "Free Lanes".
* Новые функции:
* GetWornItemsDamageOutputPhysical
* GetWornItemsDamageOutputEnergy
* GetWornItemsDamageOutputElectromagnetic
* GetWornItemsDamageResistancePhysical
* GetWornItemsDamageResistanceEnergy
* GetWornItemsDamageResistanceElectromagnetic
* GetNthItemDamageOutputPhysical
* GetNthItemDamageOutputEnergy
* GetNthItemDamageOutputElectromagnetic
* GetNthItemDamageResistancePhysical
* GetNthItemDamageResistanceEnergy
* GetNthItemDamageResistanceElectromagnetic
* GetItemIndexAndStackByBase
* GetItemIndexAndStackByName
* GetItemIndexAndStackByKeyword
* GetKeywordLinkageName
* GetTypedKeywordArray

Обновление:8.0
* Добавлена ​​поддержка версии игры 1.16.242.
* Новое событие с данными события: TESHarvestEvent

Обновление:7.3
* Новые функции: GetHeightMin, GetHeightMax, SetHeightMin, SetHeightMax, GetReferenceHandleCount, GetPackInCellReferenceCount, IsFleeing, TakePhoto.
* Новое событие: PhotoMode_TakeSnapshot.

Обновление:7.2
* Добавлены новые функции: IsFavorite, GetFavoriteSlot, GetFavoriteInSlot, GetFavorites.

Обновление:7.1
* Исправлена ​​ошибка, которая могла привести к зависанию из-за незаметного изменения структуры игровых данных в обновлении Free Lanes при вызове определенных нативных функций.

Обновление:7.0
* Обновлено для версии игры v1.16.236

Обновление:6.6
* Добавлены новые функции: OpenSurfaceMap, IsMenuOpenAny, IsMenuOpenAll, HasFurnitureUser, GetFurnitureUsers, GetFurnitureMarkerUser, HasFurnitureReserver, GetFurnitureReservers, GetFurnitureMarkerReserver, GetFurnitureMarkerCount, GetFurnitureMarkerKeyword, SetFurnitureMarkerKeyword, PlayIdleNoConditions, RestoreAppearance, GetHandscannerTargetRef, IsDying, GetReferenceCameraHeadingAngle, SortReferencesByReferenceArray, IsTurning, RotateActor.

Обновление:6.5
* Добавлены новые функции: GetHeadParts, GetExtraHeadParts, GetCallingThreadName, GetCallingThreadID, GetActorCollisionShapePosition, SetCameraState, DoesContainSameForms, AreVehiclesUnlocked, GetPlayerLandVehicle, DisablePlayerLandVehiclePlacement, IsPlayerLandVehiclePlacementDisabled, IsQuestFailed, SetQuestFailed.
* Несколько оптимизаций кода.
* Скомпилировано только с использованием AVX (Advanced Vector Extensions) и без использования AVX2 в одном файле, для обеспечения большей совместимости с оборудованием. (Заметной потери производительности нет).

Обновление:6.4
* Добавлено: IsHoldingAnimObject.
* Добавлена отдельная версия мод без AVX2 для процессоров, не поддерживающих AVX2. (Примечание: процессоры Intel, выпущенные после 2013 года, и процессоры AMD, выпущенные после 2015 года, поддерживают AVX2).

Обновление:6.3
* Новые функции: GetContainerMenuTarget, GetContainerMenuMode, GetContainerMenuSelectedItem, Get3DPosition, PlaySpellEquipSound, EnableAll, DisableAll, SetLoadedAmmoCount, GetVehicleKeyword, RenameOutpost.
* Функции в каждом типе/категории формы в CassiopeiaPapyrusExtender.psc отсортированы по алфавиту.