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

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


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

Категории

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

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

Поставьте - проверьте) В любом случае, бэкапы старых версий имеются, в случае чего перекачаете 250 кб и всё. Но должно работать. В коде ничего от 122 нет.

Сегодня, 04:16

Объясните, пожалуйста!

В одной из моих семей, которой долго не играл, пока занимался другими, родился ребёнок, который в дереве отмечен как "тайный ребёнок". Долго читал объяснения по поводу модуля Paternity Testing, но так и не понял, каким образом выяснить, кто отец ребёнка. Эта возможность заявлена не только во время беременности, но и после рождения ребёнка, однако пункт меню "Тест на отцовство" не появляется ни у жены, ни у мужа.

Версия игры 122, версия RPO 2.986, EP21 установлен.

Сегодня, 04:07

Эхх, если бы автор сделал бы еще похожий мод на супружескую измену или между партнёрами... Было бы круто.

Сегодня, 01:48

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

GreyNaya, Khlas, Fruitydelicious, NEVELY42. Еще этих авторов добавить и тогда точно окупится.

Сегодня, 01:15

Стор был ещё со времён симс 2) Просто в России он был не доступен

Сегодня, 00:28

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

Есть сим, давно в игре, переимел почти всех соседок, женат, и с женой WW-секс регулярный во всех возможных вариантах. Но каждый раз после занятия сексом он получает мудлет потери девственности, и партнёр, соответственно, мудлет лишения другого сима девственности (в виде золотого кубка). Причём такой сим один единственный среди всех играемых симов. Видимо, на нём что-то застряло из скрытых черт, статистик, или как это ещё называется в игре, или наоборот — не прописывается. Куда копать?

Вчера, 23:35

Скачивайте последнюю версию мода, всё работает

Вчера, 23:18

Машина отличная, однако для броневика от зомбей совсем уж хлипкий. Одно дело когда колеса и фары могут отваливаться от столкновения с зомбями, другое дело, когда тоже самое делает корпус и двери. Зомби в какой-то момент могут просто разломать вам БРОНИРОВАННУЮ дверь. 

Вчера, 21:10

Все модули мода работают с базовой игрой. Но при наличии допа The Sims™ 4 Стрелы купидона МОЖНО к модулю M19 добавить опциональный файл " Lumpinou_RPO_Collection_M19_AdultLife_OptionalAddOn_CAS.package", где к нему требуется The Custom Preferences Mod от Zerbu.

Если нет Стрел купидона, просто не устанавливайте опциональный файл.

 

Так что немного не понимаю проблемы, сам мод прекрасно работает сам по себе

Вчера, 19:30

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

Вчера, 18:46

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

Вчера, 18:40

Здравствуйте! Сориентируйте по версии игры, пожалуйста. У меня 1.121.372.1020 (от 19 февраля патч) и пока боюсь обновляться на последнюю. На моей версии игры можно ли использовать последнюю версию мода или нужна другая?

Вчера, 18:34

Проблема решилась в момент уточняющих вопросов. )

Вчера, 17:07

Зависит от того, что вы готовы увидеть и готовы ли вы к этому. Или вам достаточно просто выбить пыль с кровати (базовое ву-ху) и использовать пиротехнику в момент кульминации.

Вчера, 16:04

они почти все уже устарели)) на свой страх и рискsmile1

Вчера, 16:02

Не в мой адрес, а в чей? Так и не поняла)

Вчера, 16:01

"Окупиться" в смысле того что стоит ли оно вообще того , и сильно ли они произведут впечатления mmmsexy

Вчера, 15:57

Подскажите тупому человеку , анимки для каждого раздела качать все , или методом рандома ? да и в принципе сильно ли они нужны ? 

и кто скачивал , лучше чем викед ? с какими модами может конфликтовать ? chill

Вчера, 15:53

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

imfine

Вчера, 15:50

Третье, Чудесное решение проблемы (это не в ваш адрес, а просто посчёт). Хорошей игры.

Вчера, 15:31

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

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

Третье кроме МССС поставьте BE (Better Exeptions) там будет более подробно описано что у вас вылетело и в чем проблемы.

Четвертое  если это автономия возникает с малышами то на EA Bugs Report была заметка о необходимости срабатывания автономии (встал на ноги) держать малышей либо в кроватках либо рядом с диванами креслами и тд.

Вчера, 15:30

 
All4You

 

Я прям фанат всего нового и игру всегда обновлял сходу как ЕА выпускали обновы. Но, для меня также очень важно чтоб детализация в игре была максимальной на сколько это возможно с учётом железа на котором я играю. Качественные СС - это главная часть того как выглядит игра. Без СС и модов, симс это безпонтовый симулятор с мультяшной графикой и с сюжетом для контенгента 12+

В этот раз ЕА в обновление впихнули виртуальный кошелёк и магазин по типу маркетплейса и как-то странно весь левый СС контент который не проходит через их этот маркетплейс, вдруг перестал работать в игре.
Мне не интересна игра без моих СС, поэтому я впервые откатил игру и буду сидеть на патче 1.121.. до победного, или начну играть в ГТА на который есть также куча модов и дополнений.

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

 

Вчера, 15:30

Вот этот комментарий: Всем здраствуйте. Помогите пожалуйста, я не знаю что уже делать. У меня лецензия, последняя версия. Вчера я решила отключить три длс в магазине, в своих коллекциях, (теперь это делается там) и перезапустила игру. Комплекты отключились, но вместе с ними почему то еще и три дополнения которые мне очень нужны!! Я перепробывала все, активировать обратно комплекты которые я деактивировала, они возвращались а три других все еще нет. Показывает так, будто они не преобретены. Я заново их скачаивала из интернета и заменяла их в корневой папке игры. Переустонавливала анлокер, удаляла его остатки из системы два раза, все без толку... Лучше бы я не трогала эти Путешествия на Батуу и комплекты Спанч Боба, я видимо все нахрен сломала, но должен же быть способ все вернуть?? Помогите пожалуйста кто нибудь, кто с стакливался с таким и знает что можно сделать 😭😭😭



и вот комментарий, который я написала только что: А все, у меня наконец-то, спустя три дня получилось аткивировать комплекты! Я воспользовалась програмами dlc-toggler.exe и dlc.ini в пиратке от Anadius, и длс снова заработали!!! Магазин их к осжалению до сих пор не видит, но к счастью на игровой процесс это не влияет. Так что предупреждаю других, не отключайте длс никаким образом, может случится что то, чего вы не ожидали..

Вчера, 15:08

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

Вчера, 14:12

У меня ваш коммент от 21-го. И он ничего не проясняет по текущему вопросу. Судя по сегодняшнему вопросу, вы переустановили игру "скачав пиратку". Логично предположу что Анлокер мимо (если уже снова не напортачили), тк пиратки это скорее Апдейтер...

 

 Теперь вернемся к вопросам: Через что и как запускаете игру? И какая версия игры?

Что уже успели накатить поверх скачанной пиратки? Нужны просто факты.

Вчера, 14:06

Здраствуйте что-то не получается скачать резко падает скорость хотя другие скачивается help

Вчера, 14:04

да , если есть шкаф книгу кладет в него, а если нет шкафа начинается затык, не может никуда положить книгу (на новой версии 1.22 еще не пробовал, но на 1.21 так)

Вчера, 13:53

мой комментарий прочитайте чуть ниже пожалуйста, он написан 20 марта



А все, у меня наконец-то, спустя три дня получилось аткивировать комплекты! Я воспользовалась програмами dlc-toggler.exe и dlc.ini в пиратке от Anadius, и длс снова заработали!!! Магазин их к осжалению до сих пор не видит, но к счастью на игровой процесс это не влияет. Так что предупреждаю других, не отключайте длс никаким образом, может случится что то, чего вы не ожидали..

Вчера, 14:00

Через что и как запускаете игру? И какая версия игры?

Вчера, 13:27

Мод ну такое себе... хотела применить его для своей вампирской династии, чтобы, так сказать, смочь заправлять остальными. Владислауса получилось убить с 6-го раза (все 6 раз он проигрывал моему симу). После чего у моего сима появился мудлет, о том что он убил вампира И! о том, что кто-то убил его любимого. втф!? у них с ним были прокачены исключительно дружеские отношения, видимо мод посчитал, что они парамуры. Гораздо больший минус в том, что симы сами начинают такие поединки, и вся игра превращается в неконтролируемую кашу. И это нельзя выключить. Кому вообще такое понравится? зарубиться на часик, пока все не передохнут, а дальше?

Вчера, 13:16

Всем здраствуйте, я даже скачала пиратку, но игра так и не видит мои дополнения, считает что они не преоброетены. Может быть проблема в учетной записи ЕA, с которой я зашла в пиратку? Или анлокер оставил свои корни в документах? Я уже не знаю что делать, как играть то? Помогите пожалуйста

Вчера, 13:13
Жду обновы с отцом/дочерью как нового года и дня рождения вместе взятых❤️ Золото, а не мод!
Вчера, 13:03

PRO от Lumpinou стоит?

Вчера, 12:53

Не то чтоб не доверяю, но сколько уже было сообщений о том, что после обновления игры - всё норм, а время спустя эти же игроки писали про откат версии игры и всячески прославляли руки разрабов EA и желали им достатка и много здоровья?

Вчера, 12:29

Не считая новичков, разве мы уже не привыкли к тому, что перед обновлением игры всегда делаем бекап сохры + "сохранить как" в старой версии игры перед накатом обновления?

 Вроде уже ЕА нас этому научило, кредит доверия давно исчерпан.

Вчера, 12:26

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

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


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

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

Переводчик