BurstsOfRain

Порывы дождя

Bursts of Rain - это легкий сборочный погрузчик, который используется для загрузки собранных единичных сборок Burst, что позволяет использовать Burst-Compiled Jobs в модах для Risk of Rain 2.

Чтобы обеспечить полное использование систем Data Oriented Technology Stack (DOTS), этот пакет Thunderstore перераспределяет следующие сборки единства, которые не встречаются в базовой игре:

Сборка — Unity Package Version

Система. Время выполнения — не применимо

Единство. Бёрст — 1,8,18

Единство. Коллекции — 1.5.1

Единство. Математика — 1.2.6

Эти собрания не должны вызывать проблем в существующих профилях.

Для разработчиков

Bursts of Rain используется в основном в качестве интерфейса и простоты загрузки для сборок Bust, использующих BurstRuntime. Дополнительный груз Метод библиотеки, BurstsOfRainMain содержит метод, который может быть использован для упрощения этого процесса, давая ему свой PluginInfo, который служит местом запуска, и строку, которая должна быть названием разорванной сборки.

// Пример публичного класса MyModWithBurstedAssemblies: BaseUnityPlugin { private void Awake() { //Загрузите сборку под названием «MyMod Burst.dll» на Burst Runtime BurstsOfRainMain. AddBurstAssembly (Info, "MyMod Burst.dll"); } }

Ниже приведены основные записи для каждого из пакетов единства, которые этот пакет перераспределяет, а также краткое описание:

Пакет - Описание

Бёрст - Burst - это компилятор, который переводит байт-код IL/.NET в высоко оптимизированный нативный код с использованием LLVM. (Burst)

Коллекции — библиотека коллекций C#, предоставляющая структуры данных, которые могут использоваться в рабочих местах и оптимизироваться компилятором Burst. (Collections)

Математика — математическая библиотека Unity C# SIMD, предоставляющая векторные типы и математические функции с шейдером, таким как синтаксис. Методы внутри безопасны для работы (Mathematics)

Несмотря на то, что мод не перераспределяется со времени его части модуля Core, также требуется понимание системы рабочих мест. (Jobs System)

Разработка модов с использованием Burst

Разработка модов, использующих взрыв, следует очень похожим процедурам, как и обычное развитие работы, ориентированное на Burst, использование ориентированного на данные программирования рекомендуется по сравнению с объектно-ориентированным программированием, чтобы обеспечить полное использование системы Jobs and Burst, пример того, как «Burstify» сложное поведение можно найти в этом хранилище Github, любезно предоставленном Nebby. (Github Repository)

Рекомендуется использовать ThunderKit в качестве основной среды разработки модов, так как там вы можете использовать прямые пакеты Burst, Collections и Mathematics. (ThunderKit)

Уничтожение Ассамблеи

Взрыв существующей сборки осуществляется с использованием файла 'BCL.exe, найденного в пакете Burst, в частности в Burst/. Для получения дополнительной информации о том, как использовать файл BCL.exe напрямую, смотрите ниже в разделе «Non ThunderKit».

ThunderKit:

Для разрыва сборки с использованием среды разработки ThunderKit рекомендуется использовать пакет RoR2ThunderBurster, который содержит следующие утилиты для развертывания лопнувших сборок

• Расширение импорта: для обеспечения установки Burst, коллекций и математики.
• «BurstAssemblyDefinitionsDatum: Подкласс манифестного datum от ThunderKit’s AssemblyDefinitions», который используется для обозначения того, что определения Ассамблеи должны быть переданы через компилятор Burst, если это возможно.
• «BurstStagedAssemblies: пользовательский PipelineJob, который требует BurstAssemblyDefinitionsDatum», он использует отражение для очереди и компиляции выбранных сборок с помощью BCL, имитируя как можно ближе фактическую компиляцию Bursted Assemblies при создании игрока.

Замена вашего «Manifest’s AssemblyDefinitions datum» на BurstAssemblyDefinitionsDatum и выполнение работы BurstStagedAssemblies после StageAssemblies — это достаточно, чтобы разорвать сборку.

Non ThunderKit:

Чтобы разорвать сборку без ThunderKit, вам нужно будет получить доступ к внутреннему компилятору Burst (BCL.exe), загрузку пакета можно найти на этом веб-сайте: https://download.packages.unity.com/com.unity.burst/. В качестве альтернативы, если вы доверяете ссылкам в этом readme, нажмите здесь, чтобы загрузить версию Burst 1.8.18 (here)

Ниже приведено небольшое руководство по использованию компилятора, эта часть может быть перемещена в R2Wiki позже.

• Откройте файл Tarball (tgz) и откройте файл с помощью 7zip или аналогичного файла, который содержит пакет.

• Откройте папку «Упаковка» и найдите папку .Runtime, эта папка .Runtime содержит BCL.exe, который содержит компилятор.

• Извлеките содержимое «.Runtime» в желаемую папку.

Вы можете написать файл .txt, который содержит необходимые аргументы для компиляции сборки Burst, ниже приведен пример одного из них.

--key-folder=D:/ProgramFiles/UnityInstallations/2021.3.33f1/Editor/Data/PlaybackEngines/WindowsStandaloneSupport --decode-folder=D:\RoR2Related\Projects\Starstorm2\SS2-Project\Library\Burst --platform=Windows