Моды (Modding Mechanic)

Remixed Pixel Dungeon имеет встроенную поддержку модов, что позволяет игрокам и разработчикам расширять функциональность игры. Моды могут заменять ресурсы игры, добавлять новый контент и изменять существующую механику.

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

Чтобы установить мод на Remixed Dungeon вручную, выполните следующие действия:

Версия Android >= 11 (требуется Remixed 32.1+):

Вариант 1 (если вы разрабатываете мод):

• распакуйте архив мода в любую директорию в папке Downloads
• в игре: Моды → Установить локальный мод → выберите директорию мода (см. видео)

Вариант 2 (если просто хотите установить готовый мод):

• поместите архив мода в формате rpd на устройство
• перейдите к нему в файловом менеджере (см. видео)
• нажмите, чтобы открыть
• выберите приложение Remixed Dungeon
• в приложении: подтвердите установку мода

Версия Android < 11:

• распакуйте архив мода в Android/data/com.nyrds.pixeldungeon.ml/files/
• готово.

Remixed Pixel Dungeon имеет встроенную поддержку модов (с некоторыми ограничениями).

Мод представляет собой подмену ресурсов игры из папки assets. Помимо ресурсов, таких как спрайты и звуки, здесь можно найти:

• файлы конфигурации в формате JSON - Assets directory
• скрипты на языке Lua - Scripts directory

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

Мод обязательно должен содержать файл version.json со следующим содержимым: {“version”:n}, где n - номер (целое число) версии мода.

Моды хранятся на файловой системе устройства по адресу (сюда же их можно поместить самостоятельно):

\Android\data\com.nyrds.pixeldungeon.ml\files\

• Каждый мод сохраняет прогресс игры независимо от других
• Значки, полученные в модах, не учитываются в общих достижениях

По ссылке можно посмотреть список основных модов.

• https://vk.com/wall-84207769_24963
• https://vk.com/wall-84207769_25117
• https://vk.com/wall-84207769_25151

Пример раскадровки: Rat.json

{
 "texture" : "rat.png",
 "width"  : 16,
 "height" : 15,
 "idle"   : { "fps" : 2,  "looped" : true,     "frames" : [0,0,0,1] },
 "run"    : { "fps" : 14, "looped" : true,     "frames" : [6,7,8,9,10] },
 "attack" : { "fps" : 11, "looped" : false,    "frames" : [2,3,4,5,0] },
 "die"    : { "fps" : 11, "looped" : false,    "frames" : [11,12,13,14] }
}

• Название .json файла отвечает за то, какому мобу будет заменена текстура. Например, для крысы используется Rat.json, для гнолла - Gnoll.json. Полный список можно посмотреть в папке spritesDesc
• texture - файл с текстурой
• width - ширина кадра
• height - высота кадра
• Анимации покоя, движения, атки и смерти. fps - скорость проигрывания кадров, looped - определяет, будет ли анимация зацикливаться

Самое главное - JSON файл нужно поместить в папку spritesDesc, которую надо создать в папке с модом.

Моды также могут менять абсолютно любой текст в игре, будь то название предмета, описание тайтла или сообщение в лог. Исходные файлы с текстами можно найти в values-ru directory и values directory (для английского языка).

Пример замены описания крысы: Описания мобов находятся в файле strings_mobs.xml, и на 122-й строке находится описание нашей крысы:

• <string name=“Rat_Name”>сумчатая крыса</string>
• <string name=“Rat_Gender”>feminine</string>
• <string name=“Rat_Name_Objective”>крысу</string>
• <string name=“Rat_Desc”>Сумчатые крысы - агрессивные, но довольно слабые обитатели канализации. Тем не менее в больших количествах, они могут представлять опасность.</string>

Для замены русского описания создайте файл с именем strings_ru.json в корне папки с модом:

• [“Rat_Name”,“DM50”]
• [“Rat_Gender”,“masculine”]
• [“Rat_Name_Objective”,“DM50”]
• [“Rat_Desc”,“Устаревшая инженерная машина дворфов, созданная для ремонта, но способная оказать сопротивление в случае опасности.”]

Важные моменты:

1. Для замены текста каждой локализации необходим один файл, в который вставляются строчки в формате [“ссылка на строку xml файла”, “текст, который необходимо заменить”]
2. Для описания необходимо правильно указывать половую принадлежность, чтобы в дальнейшем текст подставлялся правильно (крыса ударила, гнолл ударил, чудище ударило и т.п.)

Пример атрибутов уровня: “1”:{“kind”:“SewerLevel”, “depth”:1, “size”:[32,32], “tiles”:“tiles4.png”, “water”:“water_guts.png”, “music”:“surface.mp3”,“feeling”:“CHASM”, “viewDistance”:8 }

• атрибут size игнорируется для PredesignedLevel и RandomLevel
• атрибуты tiles, water, music, feeling, viewDistance - опциональны
• варианты feeling - NONE, CHASM, WATER, GRASS
• waterSx, waterSy - скорость анимации воды

• RandomLevel
• PredesignedLevel

• Предметы
• Мобы
• Объекты

• The-dungeon-of-heroes-RPD-MOD
• PD_mini-RPD-MOD

Для редактирования JSON-конфигов и Lua-скриптов:

• Turbo Editor - Text Editor
• Enlightened - Code Editor

• Информация о моддинге основана на ModManager.java
• Конфигурации спрайтов находятся в spritesDesc directory
• Файлы конфигурации модов: assets directory
• Lua-скрипты: scripts directory
• Файлы локализации: values-ru directory и values directory

• Начало
• Ограничения моддинга
• Предметы в модах
• Мобы в модах
• Скрипты модов
• Конфигурационные файлы
• Предметы
• Мобы