Моддинг

## Вступление

**Моды поддерживаются для Mac и ПК!**

Моды состоят из файлов с расширением .assets или файлов с расширением .dll.

Вы можете скачать моды с официального сервера WorldBox в Discord. ( *ссылка* )

## **Установка мода Assembly-CSharp**

#### **Windows**

*Примечание. Убедитесь, что скрытые файлы отображаются. Вы можете узнать в Google, как это сделать, если они не отображаются.*

1. Найдите папку для установки, по умолчанию это :( *C: \ Program Files (x86) \ WorldBox \ WorldBox\_Data* )

2. Обязательно скопируйте все файлы, которые вы заменяете, чтобы вы могли вернуться в обычную игру, если хотите.

3. Для файлов .assets: если вы заменяете файл с расширением .assets, замените все файлы в папке, перечисленные выше, на те, которые вы загрузили.

4. Для файла Assembly-CSharp.dll: перейдите в папку ( *C: \ Program Files (x86) \ WorldBox \ WorldBox\_Data \ Managed)* и замените файл Assembly-CSharp.dll тем, который вы скачали.

Готово!

#### **Mac**

1. Удерживая Ctrl / щелкните правой кнопкой мыши на панели запуска worldbox

2. Щелкните по Показать содержимое пакета

3. Щелкните по contents->Resources->Data->Managed

4. Замените Assembly-CSharp.dll / files, заканчивающиеся на .assets, на модифицированный

Готово!

#### **Общие исправления**

***Текст подсказки Текст подсказки ... и другие проблемы с загрузкой:***

- Используйте версию игры, для которой был создан мод - Переименуйте модифицированный файл на исходное имя файла ( *Пример: Assembly-CSharp (2) .dll ---> Assembly-CSharp .dll* )

***Мод не отображается:***

- Убедитесь, что исходный файл перезаписан - Проверьте, не удалён ли модифицированный файл антивирусным программным обеспечением.

***Прочие проблемы:***

- Обратитесь за помощью на сервер Discord.

## **BepInEx Установка модов**

**РУКОВОДСТВО ПО WINDOWS (для linux / mac: здесь)**

### **Windows**

Вы можете следить за одним из видеороликов, использовать письменные инструкции или использовать WBMI.

### **WBMI**

Установщик мода worldbox bepinex, созданный для очень простой установки.

Дополнительная информация / руководство здесь: WBMI

### **Видео:**

Вам нужно только посмотреть видео, которое научит вас полной установке.

https://www.youtube.com/watch?v=LeY-s6JOaTU (видео содержит немного юмора, не обращайте на него внимания)

### **Письменные инструкции**

1. Установите BepInEx отсюда

2. Откройте zip-архив BepInEx, полученный при загрузке.

3. Скопируйте и вставьте содержимое этого zip-архива в **C: \ Program Files (x86) \ WorldBox** *(или, если он у вас установлен в другом месте, поместите их рядом с exe)*

4. Дважды проверьте и убедитесь, что папка ***BepInEx*** , а также файлы ***winhttp.dll*** и ***doorstop\_config.ini*** находятся в **C: \ Program Files (x86) \ WorldBox** *(папка с Worldbox.exe)*

5. Возьмите любой мод BepInEx, **заканчивающийся на .dll** , и поместите его в ***BepInEx-> plugins*** *(создайте эту папку или запустите игру, и она создаст эту папку)*

*Ура, вы закончили!*

Примечание. Если игра не запускается, попробуйте запустить игру от имени администратора, щелкнув правой кнопкой мыши по exe и выбрав этот параметр в списке параметров.

## Создание модов

Моддинг WorldBox будет состоять либо из изменений кода, либо из изменений текстуры. Эти изменения влияют на внешний вид и работу игры.

Для кодирования вам потребуются базовые знания C # и выбранный декомпилятор.

Для текстурирования требуется инструмент, который может извлекать и импортировать текстуры. Вы можете найти учебные пособия для обоих типов редактирования, в этом руководстве предполагается, что у вас есть некоторый предыдущий опыт.

### **Моддинг: Кодирование**

Изменения кода в этой игре производятся с помощью файла Assembly-CSharp.dll. **После открытия** этого файла декомпилятором, таким как **DnSpy** или **DotPeek,** будет показан список всех классов и кода. Существуют известные классы библиотек, такие как ActorStatsLibrary, ActorTraitLibrary и PowerLibrary, которые позволяют с легкостью редактировать статистику, черты и способности. Хотя эти библиотеки не содержат всего кода для своих действий. Используя DnSpy, ваш анализатор может найти ссылки на ваш код повсюду, чтобы найти нужный вам код. Как правило, вы найдете то, что вам нужно, выполнив поиск по названию в строке поиска. Другими более крупными примечательными классами являются Actor, ActorBase и Mapbox, содержащие всевозможную случайную информацию и, возможно, лучшее место для поиска, если вы не можете найти то, что вам нужно.

Проверьте эту страницу для примеров кода.

### **Моддинг: текстуры**

Редактирование текстур возможно посредством редактирования множества файлов с расширением ".assets". Вы будете использовать такие инструменты, как UTinyRipper , Asset Studio и Unity Asset Bundle Extractor для извлечения изображений и аудио. Чтобы импортировать / изменить эти изображения для изменения текстуры, вы будете использовать Unity Asset Bundle Extractor.Также известен как (UABE). Используя UABE, вы можете редактировать изображения, добавлять ресурсы (аудио, изображения, спрайты и т. Д.) И редактировать аудио. Игра использует листы спрайтов и будет состоять из всех увеличенных спрайтов под «sactx-1024x1024-Uncompressed-WorldAtlas-5e0836b1». Пользовательский интерфейс находится в аналогичном файле с SpriteAtlas вместо WorldAtlas. Эти два атласа содержат большое количество спрайтов, и любые изменения, которые вы хотите внести в спрайты, содержащиеся в них, можно сделать только через них. Любые значки или другие изображения можно найти и отредактировать индивидуально.

#### ***Примечание:***

Изменение текстуры с помощью таких процессов, как UABE, утомительно и будет устаревать при каждом обновлении. Лучше использовать эти процессы только для извлечения текстуры и создать сборку или мод bepinex для фактического импорта спрайтов или изображений.

### **Моддинг: BepInEx**

Пока что напишу несколько полезных ссылок:

BepInEx docs

Harmony docs

BepInEx How To Mod Steam Guide