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

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


Автор:
  Дата публикации: 22.03.2019, 07:45 · 17 985 · 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" либо просто имя вашего мода. Если найдено, значит мод собран и загружен успешно.
Информация
Посетители, находящиеся в группе Гости, не могут оставлять комментарии к данной публикации.

Категории

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

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

слава богам, а то меня Нэнси на дуэлях достала ужеvsenorm

Вчера, 22:44

Обновился под 1.121.361

Вчера, 22:42
Но всё же, разве VPN не должен решить проблему?

 

Решает, но, ессно, не браузерный. Браузерным можно отдельно скачивать нужные файлы.

Вчера, 21:02

Посмотрел допы у Аарос, у него все в наличии. Но файлы патча от Patch 1.120.117.1030 from 1.119.109.1020 3.patch. 73 и 74, емнип, 118-я. Думаю, есть связь.

 

При подобной ошибке, я б смотрел на то, на что ругается и поискал/скачал это отдельно или накатил всю игру торрентом как минимум 119-ю версию.

 

На предмет "битости" вы можете скачать их (73/74) отдельно с "источника" и проверить, если это важно. Но, повторюсь, у Аароса набор файлов от 119, с момента когда Анадиус ушел. Всё что было ранее, на данный момент, у него отсутствует в полном объёме.

 

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

 

 По опыту общения знаю, что гадать про то, что на компе у других - гиблое дело, особенно если пишут "я всё сделал(а) правильно". Всё индивидуально. При "цикличных" ошибках - переустановка клиента игры в чистую, как правило, займет меньше времени чтоб исключить ошибку.

 

 И я не сторонник "бразильского" обновления, которое многие использовали патчем-двумя назад, велика вероятность ошибок при ручном копировании.

 

 Если мои ответы несколько сумбурны, извините. Голова немного другим забита.

 

Вчера, 20:53

Я скачал и закинул в игру, работает. Но тогда программе не нравится что то в языках, самое интересное он докачивает файлы которые ему не нравятся. Но как сдесь говорили программа делает ошибку во время извлечения. И у людей которые только начали качать с самого начала будет вылетать эта ошибка. И дальше он не будет давать скачать новые dlc пока старые не исправит, а там опять по кругу в ошибку упрётся. Возможно из за блока серваков он скачивает нужние ему файлы криво от сюда и ошибка 

 

Вчера, 20:52

Про данный способ я понимаю и сказал то же самое, еще вариант зеркала в придачу дал :)
Но всё же, разве VPN не должен решить проблему?
И опять же, если смотреть на путь, то скачать-то он скачивает, хоть и весит потом архив 0, но ошибки начинаются на моменте «Extracting», а не «Download».

Вчера, 20:36

Возможно это единичный случай, но при переходе сима в волшебный мир, ВE выдал ошибку на скрипт данного мода, а игра просто вылетела. P.S мод без отложенных приглашений. 

Вчера, 20:35

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

Вчера, 20:30

У меня на ep17 делает такую ошибку что ты только не делай, ep16 норм перекачивает и распаковывает и как только до ep17 доходит всё сразу ошибку 

Вчера, 20:17

тоже люблю!

Вчера, 20:08

Второй товарищ Fruitydelicious

Вчера, 19:57

Ну то есть получается, эта проблема на его стороне или определенные файлы не обновлены до свежей версии игры, и из-за этого проблема... Или я немного не так понял?
«120, 121» — я уточню, речь именно про каталоги и т. п., а не про саму версию игры, версия обновлена до последней.
(Если я вас правильно опять же понял)

Вы не пробовали провернуть данный момент, сделать резерв и пробежать Updater’ом, просто интересно, будет ли у вас так же или нет.
Просто всё сходит к тому, что люди, которые будут качать в данный момент, все будут упираться в данную ошибку, а те, кто лишь обновляет свои файлы на новые, у них не будет, ибо, повторюсь, с новыми DLC (папками) такой проблемы нету, Updater работает исправно и быстро, даже без трёх букв.

Вчера, 19:35

IMHO, этих файлов нет у Аарос. Апдейтер находит причину, от файлов игры он знает что они должны быть, но их неоткуда взять. Отсюда окна об ошибке. Чтоб накатить 121, нужна рабочая версия 120.

Вчера, 19:08

к большому...

Вчера, 18:56

К сожалению, даже на сливах всё пусто. 

Вчера, 18:55

так и запишем Mike24, а второй кто?smile1

Вчера, 18:55

Заметил один интересный момент, и то мне подсказали, решил проверить, если удалить папку EP01 или, например, SP73/74, Updater после загрузки запускает «Extracting» и вылазит очень много окон с ошибкой.
А вот, например, удалить последние папки с DLC и снова запустить загрузку Updater’ом, он их спокойно скачивает и распаковывает, проблем вообще нет.

Сразу отвечу: «Зачем удалять?», у человека появилась ошибка при загрузке SP73/74, я решил методом тыка её выявить, вот и получилось.
Удалял полностью всё, что связано с Updater’ом, менял ему путь, антивирус даже отключал, хотя толку от этого.
Моё предположение, что файлы, которые он пытается скачать, возможно, биты, ибо последние скачивает вообще без проблем.
Три буквы толку не дают, как я понимаю, проблема именно в распаковки.
 Скриншот под спойлером.

Вчера, 18:47

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

Вчера, 18:24

У Mike24 уйма новых анимаций на патреоне, один из двух лучших аниматоров, а здесь давно не обновляли hmm и самому не приобрести

Вчера, 18:17

В 120 сохранил все семьи в библиотеку которые числились как "активные". Именно эти семьи проверял в 121 в тестовой сохре. У меня не прокатило востановить семейные связи между отдельными семьями.

 Даже с прямыми потомками симки (дочь, сын, дочь) в одной семье, пришлось "колдовать". Не хотели становиться детьми. Хотя это обычная традиционная семья, она их родила без вмешательств с моей стороны.

Вчера, 17:45

Не ответили про соединение. Это важно.

При работе утилиты в заголовке версия игры последняя?

 

Выше, в этой теме, есть отдельное моё сообщение со скрином содержимого папки. Эти файлы обновления игры + фикс у вас ранее были скачаны? Если да, то разместите эти файлы в созданную папку не распаковывая. Но сначала удалите то, что апдейтер создал (кеш, темп и прочие файлы).

 

Надеюсь что в самой игровой папке у вас нет проблем и игра работоспособна.

Вчера, 17:36

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

Вчера, 17:28

 У меня такаяже фигня с этим дополнением, оно тоже у меня отображается как "не куплено". Но прикол еще состоит в том что если полазить через клавишу Shift в настройках персонажа, то там у меня появились пунктики в меню связаные с этим дополнением.
Как решить эту проблемку я еще не придумал, но я её решу однозначно. Симс это не игра, это долбаный КВЕСТ симулятор. 😂 Если скучно стало жить скачай The Sims 4

Вчера, 17:25

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

Вчера, 17:24

Обновляет для своих подписчиков, там это важно.

Вчера, 17:18
Но честно говоря я уже подумываю запустить новую игру и перекинуть через галерею все участки (дома) которые я построиль на старых сохрах. Строить заново все то.. это уйма времени потрачено. Персонажей в новой игре заново буду в КАСе тюнить.

 

Чем я и занимаюсь. Готовлю переезд на новую сохру. Уже за вчерашний вечер (пока меня развлекал один казусный игрок), несколько городов застроил. Сейчас продолжаю. Но проблему с сохраненными симами и их родственными связями пока не решил, чтоб их нормально перенести и востановить древо.

Вчера, 17:15

А машина клонирования (Get to Work) + апгрейд + карьера учёного?

Вчера, 17:11

нееее, не получится. ведьма может заклонить только себя. уже испытал. придется пробовать делать это КАСом. или создавать болванчиков и делать перенос всего и вся с помощю МС. старый, но очень эффективный метод.

Вчера, 17:08

Я пробую сейчас отвязывать все родственные связи кроме связей детей брачных и вне брачных. Потом попробую снова поженить симов. Если не получится то тогда через галерею попробую. Но честно говоря я уже подумываю запустить новую игру и перекинуть через галерею все участки (дома) которые я построил на старых сохрах. Строить заново все то.. это уйма времени потрачено. Персонажей в новой игре заново буду в КАСе тюнить.

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

Игра имеет свойства засоряться по мере роста семей, по мере роста бездомных, брошенных детей, рост питомцев, плюс чем дольше живет сохранение тем больше оно засрано всяким хламом в багажах персов. В процессе появляются глючные симы и семьи в целом. Это всё сопроваждается кривыми модами, предметами, и СС, что в свою очередь приводит к тормозам интерфейса, к задержкам времени, симы начинают бездействовать и тупо стоят и качают головами по 3-5 минут пока игра не раздублится. Порой это так выбешивает что я ухожу на неделю в игру "Call of Duty", чтоб забыть на время об этих The Sims.
Из личног опыта знаю то что запуск новой игры устраняет все те проблемы в игре о которых мы знали и даже не знали. Игра снова начинает летать)).

Вчера, 17:07

Целых пять новых анимаций lol

Вчера, 16:47

Апдейтер подключается и скачивает без проблем?

 

Давайте сделаем следующее и пока не заработает, не возвращайте "как было".

Прям на рабочем столе (а лучше в корне диска С или D), создайте папку, скажем, Sims 4 Updater  Скопируйте в эту папку только один файл  sims-4-updater-v2.4.12.exe

 

Запустите его с правами админа и укажите ему где стоит ваша игра (все стандартно). Потом нажмите обновление. Если у вас есть соединение и Апдейтер может скачивать файлы, то дождитесь окончание всех проверок и скачиваний. Обратите внимание на шапку окна, там должны быть цифры последней версии игры.

Вчера, 16:46

вот как выглядит содержимое папки, она просто закинута на рабочий стол. до ЕР21 всегда исправно работало. 

Вчера, 16:37

Была мысль про внутриигровых клонов, не КАС, но пока не добрался. )

Спасибо за наводку.

Вчера, 16:15

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

Вчера, 16:09

Покажите скрином всю папку (содержимое) с апдейтером.

Вчера, 15:52

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

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


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

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

Переводчик