Каталог статей, Гайды и статьи, Atom RPG

Вводный курс по использованию ModKit (ATOM RPG)


Автор:
  Дата публикации: 22.03.2019, 07:45 · 18 071 · 0

  1. Описание

Предисловие

Данная инструкция написана мной (phobos2077) на основе того как я сам понял использование инструментария. Т.к. я не разработчик, мог чего-то не понять или понять неверно, имейте ввиду.

ModKit для ATOM RPG реализован в виде Unity-проекта (Unity - движок, на котором работает игра). Это значит что инструментарий работает только внутри запущенного редактора Unity. Поэтому первым делом нужно установить нужную версию редактора.
ModKit поставляется (на момент написания) в комплекте с файлами ресурсов игры, которые можно извлечь для редактирования. Пока там не все ресурсы, нет статики (текстур, моделей и т.п.). Т.е. вы работаете с копией ресурсов, которая не связана с установленной игрой ATOM RPG.

Моды созданные в ModKit представляют собой AssetBundle (по сути архив с дополнительными игровыми ресурсами в определенном формате, понятном Unity) + файл DLL (код мода).
Игра версии 1.08+ (либо бета-бранч) автоматически загружает моды, установленные в следующей папке:
c:\Users\<USERNAME>\AppData\LocalLow\AtomTeam\Atom\Mods\

Установка Unity

https://unity3d.com/ru/get-unity/download?ref=personal​​​​​​​



Вариант 1 (рекомендуемый, но требует установки еще одной проги)
- "Загрузить Unity Hub"
- Скачиваем, устанавливаем, запускаем
- Нажимаем Installs -> Official Releases -> Download (Напротив версии 2018.3*)



- В следующем окне ничего отмечать не нужно, жмем "Done"



- Дожидаемся скачивания и установки Unity
(этот вариант позволит в будущем легко устанавливать новые версии Unity, а также держать 2 и более версий на компе)

Вариант 2
- "Загрузить установщик"
- Скачиваем, следуем инструкциям установщика

После первого запуска потребуется авторизация. Необходимо будет создать учетную запись Unity

 

Коротко об использовании Unity Editor



Стандартный оконный интерфейс. Вверху главное меню редактора, под ним тулбар с полезными инструментами для разработки игр. Большую часть всего этого знать не обязательно, если вы планируете делать простые моды (правку предметов, диалогов и т.п.). 

Для разработки полноценных новых локаций потребуются базовые навыки разработки сцен в Unity (в интернете миллион туториалов на эту тему).

Основная часть окна поделена на несколько областей, каждая из которых может иметь несколько вкладок. Каждая вкладка это "окно" внутри редактора Unity, их можно перетаскивать как угодно (в другую область, в отдельное от основного редактора окно и т.п.). Размеры областей также можно менять. На скриншоте представлена стандартная раскладка, которая идет после установки. 

Рассмотрим основные окна.
1. Hierarchy/Иерархия - тут все объекты в открытой сцене. По умолчанию открыта пустая сцена Untitled. 
2. Scene/Сцена - 3D-представление сцены.
3. Project/Проект - дерево папок вашего проекта, с правой части показаны (4) ассеты (файлы игры) в выбранной папке.
5. Inspector/Инспектор - показывает свойства объекта, выбранного либо в сцене, либо в проекте. Самое важное для нас окно.

Готовим проект к разработке модов

https://github.com/atomrpg/modkit

- Нажимаем "Clone or download" -> "Download ZIP"



- Извлекаем папку "modkit-master" из архива
- Запускаем Unity
- (авторизуемся, если потребует)
- Жмем "Open"



- Выбираем нужный каталог



- После загрузки, главное окно редактора будет выглядеть примерно так:



- В меню выбираем Game -> Asset Viewer



- Увидим такое окно:



- Для удобства можем перетащить вкладку AssetViewer из этого окна в главное окно (рядом с Game, Scene, и тд)

В проекте modkit сразу идут ресурсы "примерного" мода. На первый раз рекомендуется ознакомиться с этими ресурсами, попробовать собрать мод и проверить его в игре. Но для дальнейшей разработки вашего мода нужно будет удалить всё лишнее, чтобы в готовом моде были только нужные ассеты.
Для очистки всего лишнего удаляем ТОЛЬКО следующие каталоги:
- Все подпапки в папке Resources/
- Все ассеты в папке Scenes/

Проект почищен, но мод работать не будет если не настроить должным образом скрипт мода.
- В проекте выбираем каталог Scripts/
- Щелкаем по MyMod и в инспекторе меняем поле Name на имя фашего мода (латиницей, без пробелов и лишних символов).



- Щелкаем в любое другое окно, появится сообщение "Unapplied import settings", выбираем "Apply".
- Ждем пока редактор пересобирёт скрипты.
- Щелкаем по ModEntryPoint правой кнопкой - "Show in Explorer". 
- В проводнике открываем файл ModEntryPoint.cs текстовым редактором:



- В данном скрипте разработчики добавили код необходимый для запуска того самого "примерного" мода с новой локацией. Нам же большая часть этого кода не нужна. Для новичков рекомендую заменить всё содержимое скрипта на мой вариант:
https://pastebin.com/VbBZ6U8w

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

Использование Asset Viewer



В окне AssetViewer в верхней части есть следующие элементы:
- Кнопка Reload - перезагружает ассеты из ресурсов (идут в комплекте с modkit)
- Поле поиска (2) - для фильтрации ассетов по имени
- Поле выбора категории (1) - для фильтрации по категориям ассетов

Для правки ассета сначала нужно его скачать в проект, для этого нажимаем правой кнопкой мыши -> Download. Выбранный ассет и все его зависимости (иконки, звуки и т.п.) подтянутся в проект:



Также AssetViewer можно использовать для просмотра ассетов (если не требуется их править), для этого просто щелкаем левой кнопкой мыши по ассету и смотрим его свойства в окне Инспектора.

Правка предметов при помощи ModKit

- По инструкции "Готовим проект.." настриваем проект мода и используем предложенный ModEntryPoint.cs
- По инструкции из раздела "Использование AssetViewer" скачиваем нужный предмет, в данном примере это будет АКМС.
- В проекте выбираем Resources/entities/weapon/ - ассет "akms" (тот что с логотипом Unity - это и есть описание предмета)
- Правим нужные характеристики, например урон (Damage Min/Max)



- Всё, правка готова, осталось лишь собрать мод

Сборка и тестирование мода

- В главном Unity меню выбираем "Game" -> "Build Mod"
- Вводим имя мода (ВАЖНО! должно совпадать с тем что мы указали в Scripts/MyMod в поле "Name", иначе работать не будет!)
- Нажимаем BUILD
- После успешной сборки откроется папка Mods с созданным модом. Убедитесь что имя DLL и созданной папки совпадают между собой и с тем что вы вводили:



​​​​​​​- Запускаем игру, изменения мода должны вступить в силу
- Если что-то не сработало, открываем логи игры:
C:\Users\Killian\AppData\LocalLow\AtomTeam\Atom\output_log.txt
- Ищем строку "Mod Init: SuperAK" либо просто имя вашего мода. Если найдено, значит мод собран и загружен успешно.
Информация
Посетители, находящиеся в группе Гости, не могут оставлять комментарии к данной публикации.

Категории

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

Лента комментариев

Проблема с загрузкой решилась!

Виноват оказался вот этот мод. У автора в пакет входит файл Xmlinjector_ED.package, хотя это и не скрипт, но после удаления этого мода сохранение стало загружаться без ошибок с PEP версии 4.0.0.

Сегодня, 19:40

Я одна с такой ошибкой? Оно с нового года не исправляется, версия новая, и дело не в аккаунте, я пробовала заходить с нового, VPN не помогает

Сегодня, 19:15

возможно, тут больше геймплея, чем в самом допеchill

Сегодня, 19:13

с новым допом хорошо играется ?smile1

Сегодня, 19:04

Мод обновился 14 февраля 

 

Сегодня, 17:42

Исключительная особенность модов этого автора - помимо самого мода всегда надо скачивать какой то мусор отдельно без которого он не сможет работать. 

Сегодня, 17:03

Не знаю как насчет допов, но у меня мод не хочет работать. Пишет нужно что-то еще установить. Иконки эмоций персонажа не кликабельны. А потом и вовсе перестал выбирать перса. 

Сегодня, 14:59

Что не поменялось? Это же анимации. Ваш кэп.

Сегодня, 12:48

переобновилсяsurrender

Сегодня, 11:53

Я обновила, но у меня даже не прогрузилась играемая семья. BE сразу выкатил ошибку. 

Сегодня, 11:42

скачала файлы, разархивировала, поместила в папку mods, поставила галочку на пользовательском контенте и моды, и на сценариях, но ничего не поменялсь((

Сегодня, 11:36

3.11 Вышла, булки vsenorm

Сегодня, 11:06

Тут уже на ваше усмотрение. Я лично не скачивал оттуда папки Clothing, Tray.

Сегодня, 09:28

Правильно понимаю, нужно скачать всё, что в дропбоксе?

Сегодня, 09:25

Может отключать аддоны или уже отключены?

Сегодня, 09:22

На DropBox есть все обновлённые файлы и предметы.

Сегодня, 09:08

Спасибо, проверю!

Сегодня, 08:50

То есть мне нужно скачать весь пак(первая ссылка), моды со второй и третьей строки(вторая и третья ссылки, соответственно) и последнее обновление DreamsOfSurrender?

Сегодня, 08:50

Вот в ветке чуть пониже, говорят, что есть обновление на Патреоне автора... Кто б туда слазил и перенес сюда)))

Сегодня, 08:47

Мод очень любопытный. Одно только не понимаю — как всё же укусить персонажа? Я выбираю действие для обращения сима в вампира, но вампир наклоняет персонажа и действие сбрасывается, отношения ухудшаются, укуса нет. Может, что-то не так делаю? Или у кого-то тоже есть такая проблема?crycat2

Сегодня, 08:38

Пробовал запускать вообще без инжектора, не помогает.

Из этого мода использую главным образом только пользовательский алкоголь с его эффектами, и версия 3.3.0 прекрасно работает. Надо бы выяснить, что изменилось в моде после этой версии, кто-нибудь в коде ковырялся?

Сегодня, 08:27

Я не про сам инжектор. А про моды которые глючат при работе вместе с PEP, они используют инжектор? Что-то должно быть общее, отсюда и был вопрос.

 В качестве эксперимента, измените название подпапки (если он в ней) XmlInjector, скажем на !_XmlInjector. Или наоборот, если он вверху списка, то отправьте его вниз. Цель - изменить порядок загрузки.

 

PS есть еще вариант, вытащить инжектор и проверить. Откиснут все моды которым он нужен, в том числе PEP, но игра/сохра должна подняться если дело в этом. Ессно запускать новую или тестовую сохру. Если это ничего не даст, а мод нужен, останется только вариант 50/50.

Сегодня, 07:46

Инжектор, в смысле XmlInjector? Куча модов на него завязаны, только на этом сайте выдаёт 105 результатов, куда же без него.

Ошибки сыпятся на этапе загрузки участка, что по кнопке "продолжить" с главного меню, что с карты города. На новой игре после создания персонажа при попытке поселить его на участок (на этапе загрузки участка).

Сегодня, 07:33

Вопрос - требования Спектр настроений и Путешествия в Симинацию никто не обновлял - мод будет работать, если их не устанавливать?

Сегодня, 07:14

Мод был отключен, накатил 4.0.0.

На своей сохре. Семья прогрузилась. Опции на месте.

 

ошибки BE и MCCC, причём в MCCC куча записей об ошибках скриптов, никак не относящихся к этому моду.

 

А эти моды не используют инжектор? На каком этапе сыпятся ошибки?

Сегодня, 06:50

Ссылки на Допы это околотемное, тк они есть в инструкции к Апдейтеру.

И в той же инструкции написано в Faq, отсылку про ошибки активации Анлокером:

 

3. You use DLC Unlocker and didn't read what to do when we get a new DLC.

 

Что уже отправляет в соседнюю тему.

 

 

Сегодня, 06:32
разделить темы и оставить тут только апдейтер

Однако почему-то ссылки на отдельные DLC здесь, а не в теме анлокера, где им вобще-то положено быть.

Сегодня, 05:36

Тринадцатая попытка обновить этот мод, безуспешная.

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

Сегодня, 04:50

это не Турбо не понравилось, это на Patreon ввели цензуру и Турбо пришлось даже для подростков отдельный анлокер делать и отказываться от части контента, чтобы остаться на Patreon

Сегодня, 03:03
тут скорее всего имелось ввиду, зачем держать такой контент на сайте, если он вызывает столько проблем у обычного юзера

 

Как и любой другой контент на сайте, который не могут скачать из-за блокировок РКН.

 

Если же брать темы Апдейтер vs Анлокер, я изначально писал (после того как ушел Анадиус), разделить темы и оставить тут только апдейтер. Сейчас "хренпоймичто" творится в теме, включая то, что секта свидетелей анлокера пытаются писать здесь о бесполезности. Хотя совсем недавно у них тоже были проблемы и бегали по "бразильцам".

 

Я не против отсылок к торренту, тк этот способ тоже полезен при проблемах со скачиванием,  когда есть проблемы со способами от Аарос. Но на этапе перевода активации на Анлокер тоже могут допустить ошибки.

Сегодня, 02:24

тут скорее всего имелось ввиду, зачем держать такой контент на сайте, если он вызывает столько проблем у обычного юзера

Сегодня, 01:28
Удаляю все старые файлы(абсолютно все), и скачиваю не пак, а новую версию 1.29, но вес файла около 100-200 мб, когда в паке было 2гб+. В чём между ними разница, и как скачать весь контент, который здесь предлагают?

 

Сам мод + СС контент необходимый для мода (тут надо быть внимательным и оставлять только новые файлы, тк у автора несколько замороченное обозначение и пропустить дубли файлов очень легко).

 Сам мод обновляется относительно регулярно, доп контент по остаточному/накопительному признаку и при обнаружении критических и не очень багов.

 

Сегодня, 00:08

Вероятно, это что-то из дебаг. В этом случае вам поможет: Tmex - Better Build Buy Он для режима стройки, справа внизу можно включить отображение дебаг контента. Да и в целом незаменимый мод для стройки.

Вчера, 23:59

Вы не учитываете фактор самого скачивания в современных реалиях в которые нас упорно вгоняют. При "ручном" скачивании игроку приходится использовать обход в браузере (который нужно подобрать, тк лохотронов сейчас много) + ссылки + капчи + зеркало откуда это быстро можно забрать, а не 128-256 кб. И только потом это всё раскидывать руками.

 

 Апдейтер же изначально делался для упрощения всего этого процесса, парой кликов устанавливалось всё недостающее. Большинство пираток на торрентах, куда мы отправляем игроков с проблемами скачивания, используют этот метод (только не нужно писать про то, что раздающие руками девственниц в полнолуние собирают весь контент). Единственный минус в настоящее время нужен всё тот же обход, но уже не браузерный. Метод рабочий.

 

 Говоря о том, что нужен или не нужен тот или иной инструмент Анадиуса, это неуважение к автору. Он(и) предоставляет выбор игроку и нужно быть благодарными как минимум за экономию денежных средств.

 

Вчера, 23:19

вот именно)

Вчера, 22:26

Популярное за неделю

Команда сайта


Администратор

Редактор, переводчик

Переводчик