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

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


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

Категории

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

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

lol

Сегодня, 21:01

"Выглядит немного странно"? Купание в реке, море или бассейне — это не то же самое, что душ с мылом, логика базовой игры вполне себе реалистична :D

Сегодня, 19:24
Обновлённый список консольных команд

Вот бы это всё через интерфейс сделать...

Сегодня, 19:02

Со словами "я фсьо сделал(а) привильна, а ана ниработаит".

Сегодня, 17:32

у автора на патреоне 5 карт обновлено под последний патчsurrender

Сегодня, 17:26

Жду обновления,опять слтели некоторые карты городов.cry2

Сегодня, 17:22

Так неинтересно, лучше потом «здесь» спросить: «А почему?», «А как?» и т. п ;)

Сегодня, 17:14

А посидеть, почитать, вникнуть? И только потом качать и раскидывать файлы.

Сегодня, 15:30

 

 

 

           >Бразильский сайт<

 

 

 

Сегодня, 14:30

Почитайте тему, откройте "Инструкция для ручной установки", далее "Как получить все DLC, если у вас пиратка (для файлов от Бразильского Комьюнити)" и "Отдельные DLC, файлы для РУЧНОЙ УСТАНОВКИ и УСТАНОВКИ Patcherом"  в самом низу ссылки "здесь".

Сегодня, 14:00
Цитата: Sergo4576

на бразилии уже добавили 

А можете пожалуйста подсказать что за бразильский сайт или дать на него ссыль если не сложно пожалуйста😭😭😭😭
Сегодня, 13:56

Как они стараются ради "2%", даже картинки им рисуют. Вчера тоже у меня, на 121, эта хрень выскочила как чёрт из табакерки. Хотел заскринить, но рука сама закрыла.

 И, да, нихрена они, ЕА, ничего не поняли. Будут гнуть свой маркет до талого.

Сегодня, 13:40

Открытого Мира как в 2-3 это то чего нехватает в симс 4.

Как по мне это самое тупое решение было убрать из игры возможность свободного перемещения между лотами. Тот кто это придумал дабы снизить нагрузку на проц и ОЗУ, полный дебил которому надо скрипты писать к тетрису.

Есть куча прикольных симуляторов от ЕА, которые имеют офигенную графику открытого Мира и при этом работает это всё на бюджетных ПК. Но конкретно разработчики Сиис 4 решили заново изобрести велосипед и по итогу мы имеем то что имеем.

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

Сегодня, 12:42

   Обновил на: весь СС контент работает исправно.

 

Те кто использует мод UI Cheats v1.53 для версии 1.122.212.1030 на версии 1.122.218.. может вызывать чёрный экран. Я решил у себя эту проблему откатом мода на v1.52 для версии игры 1.121.. Мод вполне адекватно работает и чёрных экранов не наблюдается.

Сегодня, 11:55

Привет) Мод в феврале обновился ;)

Сегодня, 11:41

то же самое у меня

Сегодня, 11:08

Я симс 2 и симс 3 даже не оставляла, они намного душевней 4. Но я согласна в последнее время с четвертой частью происходит какая-то дичь и стоит подождать пока, либо играть в пиратскую версию 1.121,которая работала нормально.

Сегодня, 10:12

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

Сегодня, 10:10

Обновление The Sims 4 1.122.218.1030 от 23 марта 2026 года.

ПРИМЕЧАНИЯ К ОБНОВЛЕНИЮ

У нас есть решение для пользователей пользовательского контента и модов, у которых всё ещё возникали проблемы с запуском игры. Теперь весь ваш пользовательский контент должен загружаться и работать должным образом. Спасибо за оперативное обращение и помощь в решении этой проблемы!

 

 

 

Гыы.. Мудилы полоумные.😁 Народ их засрал негативными отзывами и эти дятлы из ЕА поняли что их маркетинговый ход не удался.

Сегодня, 06:20

а мне низя посмотреть?

Сегодня, 06:05

уже новый дис есть

Сегодня, 02:31

Исправлено. Нужно проверить.

Версия файла 1.3.8a



Здравствуйте!
Ошибка, которую вы показали, связана с редкой ситуацией, когда игра присылает событие о добавлении трейта, но сам трейт по каким-то причинам отсутствует (None). Это может происходить при активной работе модов, которые динамически управляют трейтами (например, ассигнование ролей, генерация NPC, моды, массово добавляющие и удаляющие трейты).

Я добавил защиту в код, чтобы такие события не вызывали сбой. Обновите мод до последней версии - ошибка должна исчезнуть. Если проблема повторится, пожалуйста, сообщите.

Спасибо за обратную связь.

Сегодня, 02:25

Спасибо! Скачал, поставил, всё работает.

Сегодня, 01:08

Вы не оставили им выбора, теперь они точно всё исправят.

Вчера, 22:56

ну раз не выпустил, то нет

Вчера, 22:21

итак пока расрабы не исправят это биду 
ришлось все таки удалить симс 4crycat и устоновить симс 3chill

Вчера, 22:13

а $100 хоть успел он забрать?

Вчера, 22:04

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

Вчера, 21:33

В МСС можно отредактировать униформу для карьеры 1го сима из 1й играемой семьи.

 

В этом же моде можно например настроить униформу для всех массажистов (на публичном лоте) во всех мирах. Причем можно настроить чтобы массажисты из одного салона в Сан-Мишуно носили одну униформу, а все остальные массажисты из прочих миров носили другую униформу.

 

Можно настроить, чтобы все посетители при посещении спа-салонов вместо всегда 1го стандартного белого халата переодевались (случайным распределением) в 1 из 3 преднастроенных униформ (синий/красный/белый халаты).

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

 

И так можно сделать со всеми пассивными ролями в любых мирах: полицейские, уборщики, повара, официанты, бармены и тд. (школьникам можно школьную униформу сделать для М/Ж отдельно).

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

 

Кажется тут можно одеть кого-угодно во что угодно. Но как обычно есть один нюанс: где брать все эти новые нарядыidk

Вчера, 21:22

охота на ведьм началась прям...

Вчера, 21:19

на гитхабе выкладывают, мб там появится, но в дисе было удобнее

Вчера, 21:07

да как так?help3

Вчера, 20:57

Довольно полезный мод усложняющий процесс игры. Но заметил, что без опционального дополнения "Истинное счастье" (файлы которого кажется уже здесь есть в архиве) как-то это всё усложнение исчезает вообще.

Как по мне этот мод может быть особенно актуален тем у кого установлена целая гора модов, каждый из которых добавляет всяческие "положительные" мудлеты вашему симу. В результате чего сим просто становится "суперменом" (так как механика симс4 устроена так, что успешность многих действий определяется общим настроением сима, которое зависит от мудлетов (тоесть сим с 1 нейтральным мудлетом значительно менее успешен, чем сим с 10 кокетливыми мудлетами из мода PEP).

 

А этот мод просто вам говорит "можеш засунуть все свои позитивные мудлетики в Ж, сегодня твоё настроение +жопа+, иди молись к зеркалу".idk

Вчера, 20:50

Дискорд был удален, так что где брать след обновление не знаю

Вчера, 20:48

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

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


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

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

Переводчик