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

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


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

Категории

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

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

Пусть лучше автор добавит торнадо или сильный шторм, но конечно же без разрушений домов🤗
Сегодня, 19:15

Не обязательно грамотный)) Какой-нибудь для начала тоже сойдёт)
Из него ты поймешь куда тыкать, как подгружать модель, скелет, как анимировать и т.д.
Может там же покажут как подгружать референсы, или даже расскажут об анатомии.
Скелет и моделька симов коллизии не имеет, легко тянется, растягивается. Селешены - то и дело уходят впляс. И насколько я понял, для анимации нет базы - как нормы. От того, выпирающая вагина, и неестественно плоска попа, это то с чем приходится сталкиваться аниматорам, т.к в учёт не входят слайдеры, которые самовольно перезначают "зависимости" на модели. Т.е там где раньше была спина - теперь попа. К примеру Dumbaby, там формы далеки от человеческих, результат может выдать непредсказуемый, слайдеры переделывают селешкены по своему усмотрению. В итоге, вполне обычная поза, буквально ломает сима пополам.
Ну и насколько я помню, по анализу ванильных логов, практически все анимации которые сейчас делают, все имеют ошибку. А точнее предлагают игре не то, что она ожидает увидеть.

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



Т.е базы как нормы нет, но есть шаблон который:
Вместо полноценного списка (U) выдаёт просто текст (T)
Порядок элементов нарушен
Типы данных не совпадают с ожидаемыми
Т.е это костыли, благо игра может парсить это, хоть скрипя зубами и матерясь

Сегодня, 15:32

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

Сегодня, 15:01

Если с впн, то проще скачать с патреона автора по ссылке ИСТОЧНИК, там промахнуться сложно. Если без впн, то по кнопке СКАЧАТЬ и нажать большую голубую плашку GENERATE LINK, дождаться пока GENERATING..., потом нажать DOWNLOAD LINK. Больше ни на какие кнопки нажимать не надо, а ещё лучше поставить какой-нибудь блокировщик рекламы, который уберёт все лишние баннеры.

Сегодня, 14:56

Ребят, никто не сталкивался с тем, что когда надеваешь пояс целомудрия на симку он, случайно, надевается на хозяина. и совсем непонятно, как его снять? ключа ни у кого нет. в сети нашла только упоминание проблемы 2 месяца назад и2 года назад. и ноль решений. сохраниение откатывать никак, все старое очень. удалить и поставить мод заново - не помогает.
Upd. Нашла решение. вернее не я, а гугел ии. кладешь карточку сос на землю, шифт+клик на нее, там выбирать "настройки DOS", жадее - DOS дебаг и читы и уже там - снять пояс. 
ррррр

Сегодня, 14:47

Если знаешь базу, то нет. Т.е для того чтобы создать коллаж, достаточно уметь пользоваться фотошопом при этом никогда коллаж не делая. Работа в блендере может напугать, но имея опыт в другом ПО то не покажется сложной.

Хотя как по мне, блендер не самая удачная прога, слишком "особенная" по интерфесу. Я по 3dsMax больше, но и задачи могут быть несколько иными у этих программ.

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

Мне лично хватило 2 урока по моделированию, по 20 минут, чтобы сделать модель автомобиля.

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

Сегодня, 14:46

Две новые анимации zametano Ребят, вопрос, кто пробовал создавать? Очень сложно самому?

Сегодня, 14:37

а как скачать мод? я перехожу на букмекерские сайты или алик

 

Сегодня, 14:30

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

Сегодня, 13:21

большое спасибо!

Сегодня, 12:47

я такая же фигня. ПОшевелите плиз, если ответ появится

Сегодня, 12:20

Почему не работает ?

Сегодня, 09:45

В данном моде присутсвует баг, а точнее упущение автора в одном из ключей. Автор использовал ключ из дополнения День Стирки (0xA05B79A7). В итоге, на стиральной машине или на корзине, теперь кнопка содержит большой кусок текста.

 

выяснил что ключи эти аж в двух местах прописаны:
ErrantRed_GoodTimeGuys_Level08PO03Sugary2 (0x4D412E0D)
ErrantRed_GoodTimeGuys_Level09PO03Sugary2 (0xAB1913B2)

 

В тексте отсутсвуют 0xAB1913B2 и 0x4D412E0D, а только одна строка с 0xA05B79A7 из каталога.

 

Вернул им оригинальный хэш, а для перевода использовал только одну:
ErrantRed_GoodTimeGuys_Level08PO03Sugary2 (0x4D412E0D)

 

Правильно или нет, можно будет понять из контекста, как и косяк со второй строкой, которую еще найти надо. Во всяком случае, "вывесить бельё на веревке" теперь отображается корректно.

 

Сделал фикс чисто для себя, а так, если что, теребите автора.

 

Сегодня, 05:30

Нужно распаковать файлы мода не в отдельную папку папку мода, а напрямую в Mods. Чтобы, когда заходишь в Mods, там сразу лежали папки DDAnimations, DDBody и так далее. 

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

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

 

Ещё, наверное, можно вместо этого оставить для мода папку, но руками перетащить скрипты на уровень повыше. Но я хз, как мод на это отреагирует.

Собственно, тут чуть ниже примерно то же самое и писали. И в README.txt самого автора.

 

Сегодня, 05:08

Я что-то не пойму. Я установил и библиотека sims4communitylib, и Deviant Core и Mod Settings Menu. И последяя версия игры. Но игра не запускается с этим модом: вечная загрузка в режим жизни.
И не понимаю момента указана что версия Sims 4 должна быть 2.3 или выше, чего? Откуда эта цифра?

Сегодня, 00:07

Обновлённый перевод от 10.03.2026

Вчера, 23:11

С этим модом у меня не показываются иконки с эмоциями и мыслями. Просто меняется эмоциональное состояние. Мне так не нравится. Мне нравится читать, что там у них происходит. 

Вчера, 22:02

подскажите, пожалуйста, где можно найти версию данного мода на версию игры 120? обрыла весь интернет, перекидывает только на 121crycat2

Вчера, 20:50

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

Вчера, 17:38

Русификатор который я выкладывал оказался битым
Вот исправленная версия файла

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



Обновлённый перевод от 10.03.2026

Вчера, 23:12

Спасибо

Вчера, 15:02

Я его грохнул, был с ошибкой по инстансам.

Обновят позже, вот исправление

Вчера, 15:01

Перевод от Bondarchuk недоступен, пишет, что страница не найдена

Вчера, 14:56

upd: Удалось найти бутылку для воды в режиме "отладка", но когда сим пытается ее взять игра просто вылетает.

Вчера, 14:13

На ваше усмотрение. Как по мне это "вечеринка", повод чтоб собраться, опять таки что там по знакоместу.

 

Вечери́нка — встреча людей (часто друзей и знакомых), в основном для развлечения и отдыха. Вечеринка обычно проводится вечером, откуда и происходит название понятия. Вечеринка очень схожа с праздником или с фестивалем, но этот термин используется для обозначения непринужденных, небольших встреч близких знакомых, а не для общих государственных или религиозных торжеств.
Вчера, 14:04

Это будет работать если инстансы одинаковые.
Сначала попробовл поменять приоритет zz_
Порнуха переводится, а эскорт от AWE нет.
Меняю на !1_ - эскорт переводится, порнуха нет.
Посмотрел, а инстансы отличаются.
Прога translator, с эскорта нормально инстанс подсасывает для русского языка 0x12, а с порнухи хватает 0х00
Вообщем получается что при zz_ перевод на порнуху стал бы работать.

Хотя даже так, длина пути тоже влияет, пока моды были раскиданы по папкам AWE-EscortCareer и AWE-PornCareer, а русики лежали в Mods с !1_, он нормально их подсасывал. А как только закинул их в одну папку AWE, тот тут алфавитный порядок сделал своё дело.
Косяк. Вообщем учту на будущее.

А пока вот, рабочий:
https://modsfire.com/7G4ByUnNDUg0crO



Дело наверное в том, что перевод этот "собранный", и лишь частичной пеерведённый мною. За основу вероятно взял с битым инстансом, перевёл остатки и всё как бы. Работает и работает. Как? Да вот хз.

Вчера, 14:14

Ну, тогда "Праздник ожидания ребёнка".

Кстати, полностью противоположно нашей традиции: пока ребёнок не родился, нельзя ничего для него покупать заранее, не известно ещё, как оно получится.

Вчера, 13:44

Добавлен перевод от Bondarchuk.

Вчера, 11:10

Версия игры 121.137

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

Вчера, 09:55

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

Вчера, 08:32
может быть просто "Беби шауэр"?

 

Тогда смысл переводить? ) При первом прочтении звучит как беби шаурма...

 

"Праздник/вечеринка в честь рождения ребенка" слишком громоздко

 

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

Вчера, 07:30

Ага, сделал отдельную страничку для него.

Вчера, 07:17
А вот с этим можно поспорить, у меня все переводы (сейчас посмотрел, их 900) ко всем абсолютно модам лежат в тех же папках, где и моды ими переводимые — и всё работает.

 

Аналогично, нет ни одного файла модов/переводов в корне папки Mods, им там делать нечего. Символы ! или 1 предназначены чтоб поднять приоритет загрузки строк из "stbl" перед основным файлом мода.

Вчера, 07:17

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

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


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

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

Переводчик