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

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


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

Категории

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

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

а может кто-нибудь кинуть руссификатор не ссылкой в вк а файлом? например на том же modsfire.com
ну так, для тех у кого блокнут вк)

Сегодня, 17:54

он и так сс, если удалить - исчезнет, это же не анлокер

Сегодня, 16:42

Я правильно понимаю, что если убрать мод, то и контент исчезнет? Этот мод не разблокировывает контент, а добавляет его в игру как СС? 

Сегодня, 15:57

перестал отображаться в игре

Сегодня, 14:37

у меня перестал работать

Сегодня, 14:32

А скоро обновите?

Сегодня, 14:28

ждать обновы, у меня также

Сегодня, 13:40

Эта инфа висела на scarletsrealm когда вышел игровой патч с функционалом отключения допов, там еще другой, сторонний, метод рекомендовался.

Сегодня, 12:59

Вот чё реально подбешивает, сам процесс игры при запуске слетает.
Т.е тут как повезёт, запустится игра или нет. По нескольку раз запускаешь, процесс 500 метров в память выкинет, и завершается. Раз на 5, а может и 10 соизволит запуститься.

Сегодня, 12:49

Это, пожалуй, был самый быстрый способ принятия и решения "проблемы". Это ли не Чудо!1

Сегодня, 12:42
Инструкция есть в инете.

 

Инструкция прилагается к Апдейтеру и её можно открыть во время попытки запуска игры не активированным акком EA "онлайн".

Сегодня, 12:39

полет нормальный. я тупая) это,видимо визуальный баг, ибо уже в прцессе игры все наборы есть. Мискузи

Сегодня, 12:36

Вы написали о проблеме, но ни слова про то, что делали с игрой. Как тут угадаешь? Разве что становится понятно что у вас пиратская лицензия в стиме, а это в тему Анлокера надо писать.

Сегодня, 12:29

Здрастьте. я либо тупая - либо да.
Уже все переделала, но  4 дополнения так и не отображаются. 2 день мучаюсь.
Игра лицензия стима. до этого не было таких приколюх.
в чем я туплю, подскажите?

Сегодня, 12:16

Почему-то не работает перевод, никакой

Сегодня, 11:20

Пользуется тот кто не ставит MCCC

Сегодня, 11:17

Потестил мод, работает, но пользоваться буду только тогда когда автор совместит с модом Townie Overhaul Less Fame от Bienchen ибо генерация Петровых и Васечкиных в этой плюхе от Zero не отключена. К тому же используется прокладка Lot51, а набор модов от Bienchen этого не требует. Вывод если нет модов Townie Overhaul Less Fame то берем особенно в связке с Multi AssignNPCRoles от Zero. Минусы переодически удалять генерированных болванчиков вручную.

Сегодня, 10:52

Галлерея работает и на связке EA Basegame + DLC + анлокер. Так же работает на полной пиратке с кряком от Ааros. Это утверждение верно до 6 утра по МСК может позже что то слетело или очередной глюк на серверах EA. Попробуйте снова привязакть акк к игре скопировать remid из куки и тд. Инструкция есть в инете. 

Сегодня, 10:34

Логов нет, тех которые по крайней мере пишущися дефолтно. В тайминге анимации указано время цикла в сим минутах, 1сим.минута = 25 мс реального времени. Тут уже можно что то посчитать. Некоторые "редиски" авторы устанавливают n-ное кол-во повторов одного и того же цикла тем самым увеличивая длительность анимации. В WW можно задать продолжительность цикла анимации но почему то работает это не со всеми видами и не для всех авторов.

Сегодня, 10:28

Не работает эта функция)

Сегодня, 08:55

Отличный мод, кстати. Спасибо за обновление!

Сегодня, 07:58

Мне нравится этот мод. Не играемые персонажи живут свою жизнь :)

Сегодня, 07:38

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

Сим, увидевший измену, получает негативный слух о партнёре.
Этот слух может передаться другому симу при дружеском разговоре, если он доверяет собеседнику и имеет склонность к сплетням (экстраверт, межличностный интеллект, тип эннеаграммы 2/3/7).
Получивший слух сим будет испытывать меньшее желание общаться с фигурантом автономно, а при общении с ним может получить негативные эмоции и снижение удовлетворённости.
Успешные дружеские и романтические взаимодействия, наоборот, создают положительные слухи, улучшающие отношение и делающие общение более приятным.
Слухи живут 7 дней, потом забываются.

 

Сегодня, 07:15

Ребята большой вопрос, до последнего обновления все работало супер, теперь все все еще работает очень даже, но отвалился доступ к галерее(бесконечный connect, внутри игры вообще нет доступа к EA), есть мнения или похожие ситуации, как считаете пофиксится ли это с обновлением апдейтера, или может мне нужно перейти на анлокер версию(пользовалась всегда только апдейтером и проблем с коннекшном не возникало).

Сегодня, 04:58

Дай Бог ему здоровья!

Сегодня, 02:59

Может кто знает совершенно случайно есть ли возможность просмотреть где-то количество секунд прошедших с начала старта WW-анимации в моменте или при установке паузы во время анимации. Читы, логи?

Сегодня, 02:12

На 119 игре мод заработал отлично.

Сегодня, 01:45

В прошлый раз этот мод ставил (у меня другая версия игры стояла), он у меня ломал что-то.

Заработал этот мод у меня на 119 версии. Довольно удобный, теперь постоянно им пользуюсь.

Заметил, особенность, что если долго (мин 5-10) находится в меню строительства с расширенным окном (не закрывая его), то игра начинает подвисать.

Сегодня, 01:40

привет ну я так и думал то кто то возьмет и выпустят мод на маркет плейса для симс 4 я сам скачал и внутри игры скачал бесплатный длс внутри игры спасибо большое

Сегодня, 01:35

Второй мой заход по установке этого мода и повторное удаление.

У меня все работало и в прошлый раз и работает в этот на 119 версии.

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

При Shift+Click на симе появляется иконка шестерёнки при нажатии на которую открываются настройки этого мода, в которых можно выставить вроде как переназначение клавиш, чтобы поиск активировался нажатием Shift+Enter, но работает эта настройка к сожалению глючно и всё равно продолжаются проблемы с клавишами (~, 1, 2, 3) при окрытом круговом меню.

Сегодня, 01:35

Ну пока всё работает. В целом можно было бы UI, но это надо вникать. Да и в целом, отображение информации на которую игрок всё равно никак не влияет - просто логирование. Лишний код. Что-то можно посмотреть через консоль.

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

Сегодня, 01:00

Это сложный вопрос, файлов примерно 7600, если верить Sims 4 Mod Manager, то СС там 7300.

96%, на объем 42 гигов, это примерно 40 гигов всякого.

Ну и на сколько я понял, проблема была с теми CC что использовали некоторые DLC. И видимо логика была нарушена, от чего все остальные СС уходили в ошибку.

Вроде фиксанули, 18 числа, и если всё так же сбоит, значит нужно выискивать то что уже не поддерживается игрой. Через BE или пытаться методом исключения 50/50.

Сегодня, 00:44

Работает с новыми обновами?

Сегодня, 00:30

Дело Симс 3 Стора живёт... к сожалению.

Сегодня, 00:06

спасибо большое! Юрочка просто волшебникprinyatie

Сегодня, 00:04

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

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


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

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

Переводчик