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

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


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

Категории

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

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

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

 

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

 

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

 

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

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

 

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

Сегодня, 21:22

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

Сегодня, 21:19

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

Сегодня, 21:07

да как так?help3

Сегодня, 20:57

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

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

 

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

Сегодня, 20:50

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

Сегодня, 20:48

Перевел все Kuttoe BasementalAddons

Сегодня, 20:24

Здравствуйте) Поставила, потестила, в первую ночь перед пробуждением сима сработала ошибка. Лог ниже. Дипсик говорит, что как будто что-то про назначение черт.

 

[emotional_memory] 2026-03-24 23:13:19.297647 Traceback (most recent call last):
File "T:\InGame\Gameplay\Scripts\Core\sims4\utils.py", line 179, in wrapper
File "T:\InGame\Gameplay\Scripts\Server\areaserver.py", line 222, in c_api_server_tick
File "T:\InGame\Gameplay\Scripts\Server\sims\masked\v187.16\injector.py", line 26, in _wrapped_function
File "T:\InGame\Gameplay\Scripts\Server\sims\masked\v187.16\zone_tick.py", line 83, in _turbolib_zone_game_update
File "sims4communitylib\utils\common_injection_utils.py", line 242, in _wrapped_self_function
File "sims4communitylib\events\zone_update\common_zone_update_event_dispatcher.p
y", line 79, in _common_zone_update
File "T:\InGame\Gameplay\Scripts\Server\zone.py", line 520, in update
File "T:\InGame\Gameplay\Scripts\Server\time_service.py", line 117, in update
File "T:\InGame\Gameplay\Scripts\Server\scheduling.py", line 231, in simulate
File "T:\InGame\Gameplay\Scripts\Server\elements.py", line 335, in _run
File "T:\InGame\Gameplay\Scripts\Server\interactions\utils\outcome.py", line 177, in on_loot
File "T:\InGame\Gameplay\Scripts\Server\interactions\utils\loot.py", line 193, in apply_operations
File "T:\InGame\Gameplay\Scripts\Server\interactions\utils\loot.py", line 746, in apply_to_resolver
File "T:\InGame\Gameplay\Scripts\Server\interactions\utils\loot_basic_op.py
", line 303, in apply_to_resolver
File "T:\InGame\Gameplay\Scripts\Server\interactions\utils\loot_ops.py", line 426, in _apply_to_subject_and_target
File "T:\InGame\Gameplay\Scripts\Server\sims\occult\sim_info_with_occult_tra
cker.py", line 75, in add_trait
File "T:\InGame\Gameplay\Scripts\Server\traits\trait_tracker.py", line 100, in add_trait
File "sims4communitylib\utils\common_injection_utils.py", line 242, in _wrapped_self_function
File "sims4communitylib\events\sim\common_sim_event_dispatcher.py", line 348, in _common_on_sim_trait_added
File "sims4communitylib\events\sim\common_sim_event_dispatcher.py", line 176, in _on_sim_trait_added
File "sims4communitylib\events\event_handling\common_event_registry.py", line 59, in dispatch
File "sims4communitylib\events\event_handling\common_event_registry.py", line 69, in _dispatch
File "sims4communitylib\events\event_handling\common_event_handler.py", line 94, in handle_event
File "D:\Sims 4 Python Script Workspace\My Script Mods\EmotionalMemory\Scripts\emotional_memory\event_handlers.py", line 174, in on_trait_added
File "sims4communitylib\utils\common_log_registry.py", line 238, in error
File "D:\Sims 4 Python Script Workspace\My Script Mods\EmotionalMemory\Scripts\emotional_memory\event_handlers.py", line 172, in on_trait_added
AttributeError: 'NoneType' object has no attribute 'guid64'
Error in trait add: 'NoneType' object has no attribute 'guid64'

 

Сегодня, 20:16

Поставил на 119 версию. Вроде работает:

- фоточки в флешку вроде запихнуть можно, они там хранятся.

- у каждой флешки свое отдельное хранилище.

- можно конвертировать любые даже "убитые" фото с черным пятном в качестве "плохо" в качество "превосходно" (+100 к счатью моих симовhehe).

- вроде даже в календари/коллажи/портреты можно фото размещать (но я это еще не затестил полностью).

 

Чего пока-что не понял:

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

 

Еще у меня возникла проблема.

- сим из моей семьи нафоткал разных фоток и сложил в флешку и оставил ее дома на тумбочке. Затем мне надо было выселить эту семью из дома (а то тип лота не менялся, а мне надо было поменять его). И после того как я выселил семью с лота, а потом вернул ее обратно и поиграл некоторое время (сейв откатывать не вариант уже), то я обнаружил что фотки в флешке оказались запертыми! Они там вроде есть, но вытащить их оттуда нельзяhelp3 Покач-что оставил эту "заблокированную" флешку на тумбочке, в надежде что она "разморозится".

Сегодня, 20:13

Добавил, спасибо

Сегодня, 16:17

Скрытые трейты можно посмотреть через MCCC, а еще был вот такой мод для управления этим делом. Как пример, поискать среди списка что-то связанное с "virgin". Обновить список WW-черт, которые накинули на него

Сегодня, 15:28

На новые объекты перевода нема, либо я не разбираюсь в сортах и названиях алкоголя

Сегодня, 15:13

Когда у вас пропадёт красный текст(Your game version...), значит, «обнова» вышла.
Заново Updater качать не нужно.
Другими словами: aaros патч пока не добавил.

Сегодня, 15:05

написано, что "в раннем доступе до 28.03.2026" chill

Сегодня, 15:04

А перевод вообще будет доступен бесплатно?

Сегодня, 14:22

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

Сегодня, 12:07

Привет всем а обнова будет 1.122.218.1030 

Сегодня, 12:05

Исправление черты Ответственный (Responsible Trait Nerf), Исправления для Компактной жизни (Tiny Home Nerfs), Осеннний Форготн Холлоу (Autumn Hollow). Этих модов написано "страница не найдена".

Сегодня, 11:49

У меня помог только откат WW на предыдущую версию 

Сегодня, 09:13

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

Сегодня, 08:07

Поставьте - проверьте) В любом случае, бэкапы старых версий имеются, в случае чего перекачаете 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:40

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

Вчера, 18:34

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

Вчера, 17:07

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

Вчера, 16:04

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

Вчера, 16:02

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

Вчера, 16:01

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

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


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

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

Переводчик