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

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


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

Категории

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

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

Да, работает, все приперлись. Только я взял мод под свою версию на Curseforge. Взаимодействие находится в меню "Дружелюбные действия"

Сегодня, 02:57

Кнопка "Источник" ведёт на старую версию, поправьте, пожалуйста!

Сегодня, 02:38

Классно, сейчас проверим

Сегодня, 02:14

Интересно! Оказывается основные испоняемые файлы игры (.exe) разные в зависимости от допов, думал, это прописано только в каких-то конфигурационных файлах.

Сегодня, 01:52

просто меня слово переустановите напугало. погнала проделывать все необходимые манипуляции (1-2-21-q)surrender



спасибо! и правда надо былоimfine

Вчера, 22:32

Он у всех есть, скачивать заново, пока не вышли новые DLC, не нужно. Надо просто запустить ещё раз setup.bat и проделать все необходисые манипуляции (1-2-21-q).

Вчера, 22:15

а если у меня до этого и был? сейчас попробую. спасибоthanks

Вчера, 22:11

Их ещё не существет физически.

1. Ждём 12.02, когда они появятся у EA

2. Ждём, когда их сольют в сеть

3. Ждём, когда информацию о них добавят в файл g_The Sims 4.ini в Анлокере.

Вчера, 22:09

Нет, всё тот же, но его нужно запустить и применить заново после обновления EA app.

Вчера, 22:03

анлокер обновился?

Вчера, 21:57

Сегодня обновилась EA app. Те, кто играет с лицензионной базой, переустановите анлокер!

Вчера, 20:23

Спасибо за обновление!

В общем архиве для городов:

EvergreenHarbor
Glimmerbrook
MoonwoodMill
SanMyshuno
SanSequoia
StrangerVille

присутствуют по два варианта карт с разным дизайном.

Устанавливать только один для каждого города по вашему выбору!

 

Вчера, 19:35
где можно скачать эти ДЛСки отдельно именно для корневой папки напиши пожалуйста ссылку.

Так они только 12-го числа должны появиться, сейчас их просто нигде нет, даже у EA за деньги.

Вчера, 19:14

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

Вчера, 19:03

Да, один zip, а другой rar, но я сравнивал в разархивированном виде.

Вчера, 19:01

THANKS

Вчера, 17:58

Но по факту игра обновлялась, киты губки боба также появились в игре. Только на моём торренте. около 70-ти загрузок было и плюс целая куча народу тут скачивали бразильский архив, который также работал.

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

Вчера, 17:57

У Linua отдельная тема. )

Вчера, 17:42

Ссылка на источник с ноября не обновлена, так и отправляет на 2.9.2.

Вчера, 17:37

https://github.com/l1ntol/linua-updater

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

Вчера, 17:27

Про установку в "чистую" я писал с учётом того, что происходило после ухода Анадиуса. Наблюдал за процессом, как вы там манипулировали файлами, не обновляя игру.

Вчера, 17:27

Да я тупанул и это факт)) Во всём виноваты не активные ДЛС и моя тупость))

Вчера, 17:26

ЛАМА слишком много тэгов понаставил)) так что снимай, анимки очень хорошие

Вчера, 17:24

ну так потому они были выложены, для тех кто не любит ждать, но в основном тут файлы анадиуса и его приемника, у них и приоритет
Это вы тут по 3 варинта установки используете, хотя могли остановится на бразильцах, и проблем бы не знали 

Вчера, 17:06

Возможно у Аарос сугубо файлы обновлённые а у бразильцев всё подряд, тобишь кто-то из админов покупает все допы, это все загружается в его игру из серваков ЕА, потом этот админ из своей игры берёт эти файлы разом с остальными ненужными файлами, это всё архивирует со слабой степенью сжатости и всё это выкладывает на свой сайт.
Если помните еще до бразильцев я выкладывал тут патч 1.119.. в тот период когда Анадиус свалил. Потом после меня тут выложили тот же патч но уже от бразильцев, по содержимому архивов они были абсолютно одинаковые, единственное что их отличало это размер, мой архив был на гигабайт меньше. Это потому что я в настройках своего архиватора чуть увеличил степень сжатия файлов.

 

По поводу ЕА, я вкурсе что игра разработана ими, я просто констатирую факт с которым я столкнулся, а имено, на бразильской обнове игра шустро запустилась на старой сохре и не на обновлённых модах. На обнове от ЕА и на обновлённом Викеде, Нисе и Командере, игра запускает теперь сохранение примерно часа полтора, я за этот процесс успеваю просматривать две серии сериала на Нетфликсе)) Плюс к этому переключение между персонажами не работает. Это 100% какой-то мод или несколько модов по какой-то причине начали конфликтовать. Я найду эти моды так или иначе)) Я умудряюсь переносить информацию из старых сломанных сохранений в новые работающие сохры с помощью S4 Studio, и с этим мелочным глюком я точно разберусь.

Вчера, 17:04

У меня обнова 21гб качает. Это нормально?

Вчера, 16:45

А ничего что сама игра от EA? )

И где гарантии того, что после выхода обновления, часть модов, которые сейчас качаете, снова не отвалятся?

Я не настаиваю, я просто предлагаю установить чистую игру и тем самым исключить сомнения относительно самих файлов игры, даже, вероятно, нервы сбережете и время. Кто знает что там "бразильцы" мутят, если от Аароса патч на 3 гига, а от них на 18+языковые пакеты без русского.

 

А моды, качаемые, пока в отдельную папочку.

Вчера, 16:21

От Аароса с опозданием и не стабильно. В прошлый раз он на целую неделю опоздал с обновой. Бразильцы сходу выкладывают свои архивы.

Вчера, 16:08

Сейчас много модов начинают обновляться под 1.121.. Я сперва обновлю все эти моды и если проблема не уйдёт то удалю 1.121.. от ЕА и снова обновлю свою резервную клпию 1.120., но уже через онлайн патчер. Мне кажется вся проблема в ЕА обнове, потому что после этого обновления игра начала глючить. На бразильском патче игра работала нормально.

Вчера, 16:01

так а смысл, если мне больше нра от Aaros, плюс весит меньше

Вчера, 15:52

Делайте откат игры в чистую, на 120-ку, любую, в новую игровую папку (если есть место на дисках, то старую папку пока не трогайте и ничего не трогайте в документах, это сделаете потом).

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

Вчера, 15:42

Urayxor

Продолжайте и дальше от бразильцев брать обновы. По сути две предыдущие обновы с их сайта нормально работали. Даже эта обнова у меня лично работала на старой сохре со всеми модами без проблем, пока я не начал переобновляться из-за не активных ДЛС. Сейчас у меня патч от ЕА и по итогу игра начала глючить, не могу переключиться между персонажами. Короче говоря херня какае-то происходит в игре на этом новом патче от ЕА. Явно новый патч не дружит с модами.

Вчера, 15:27

Спасибо, помогло! 

Вчера, 15:17

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

Вчера, 15:09

проясним ситуацию с говномодами.

основные моды к которым вопросов нет: Викед, МС, Бэйсментал, XML Injector.

про вопросом: Ниса, KMI и прочие тоже довольно крупные моды.

из мелких модов к которым не вопросов, они как правило соевременно обновляются и проблем не создают: Improved Drink Trays, Ask to Eat and more и родственные к нему от этого же автора, Release Bladder Anywhere, возможно есть еще полезные и безглючные мелкие моды, но тут хз.

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

говномоды: это все остальное, черты характера, пукнуть влелво, пописять вправо, и тд и тп.

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

Вчера, 15:09

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

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


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

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

Переводчик