Mod-Bot Discord: https://discord.com/invite/Em4n6gB
Mod-Bot: https://modbot.org/
Level Editor Tools Mod: https://modbot.org/modPreview.html?modID=286ea03e-b667-46ae-8c12-95eb08c412e4

Всего есть 2 вида файлов которые вы можете импортировать:

• .vox модели
  
• картинки разных форматов (не считая .webp)
  
• obj, fbx и прочие форматы если вы заранее конвертируете их в .vox (из-за разнообразия цветов придётся играться с настройками чтобы не вышло 20 тыс объектов)

Также есть 2 способа указать путь к файлу:
- Включить галочку "использовать полный путь к файлу" и вставить в поле полного пути к файлу этот путь.
Путь к файлу можно скопировать нажав Ctrl + Shift + лкм по файлу в проводнике и выбрав соответствующую опцию (в Windows 10).

- Переместить нужный файл в папку модов и в поле "имя файла" в общих настройках мода вставить скопированное имя файла с расширением.

После указания файла вы можете вернутся в редактор и нажать Ctrl + I, после чего начнётся импорт файла (но я всё же рекомендую пройтись по каждой настройке перед этим процессом).
Во время импорта вы также можете принудительно остановить процесс повторным нажатием Ctrl + I.

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

- Количество маленьких кубов которое будет создано за 1 кадр. Если у вас не стоит флажок "объединять воксели с одинаковым цветом в большие", то эти кубы будут появляться сразу как цельные отдельные объекты в редакторе (у вас будет мало фпс, не делайте так). Если флажок стоит, то кубы будут создаваться гораздо быстрее и их не будет видно (они будут использоваться для объединения и игровые объекты будут создаваться именно тогда).
Если ваша игра сильно зависает при импорте самих вокселей то рекомендую понизить это значение, но не ставьте слишком мало чтобы импорт не длился 3 года.

- Тут всё понятно

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

- Флажок объединения маленьких кубов в куски побольше. Минус - импортированную модель нельзя изменять по индивидуальным вокселям как в редакторе вокселей. Плюс - выходит гораздо меньше объектов в уровне. Рекомендуется вкл.

- Если выключено, воксели с прозрачностью 0 (которых вообще не будет видно) не будут создаваться, если включено, то будут. Рекомендуется выкл.


Первый - обычный CubeFlat без прозрачности или свечения.
Второй - с поддержкой прозрачности (ну и свечения но используется в основном для прозрачности).
Третий - с поддержкой свечения.
Четвёртый - уничтожаемый переливающийся куб.
Пятый - группа из 27 уничтожаемых переливающихся кубиков размером с один куб (тяжело на фпс но красиво уничтожаются)

- Тут всё понятно
.
.
.

- Только для первого, четвёртого и пятого типов кубов.
.
.

- Только для первого, четвёртого и пятого типов кубов.
.
.

- Поле Disable Colliders, только для первого, второго и третьего типов кубов.

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

- Можете сжать изображение заранее до маленького разрешения чтобы не было много объектов и поставить тут 1 чтобы мод не изменил картинку.

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

- Если в полученной после обработки картинке получится очень много вокселей, то мод предупредит вас об этом.
(Подсчитывается общее количество вокселей а не количество объединенных кусков)

- Вся информация о специальной (дополнительной) палитре в разделе 6.

- Количество обрабатываемых кубов за кадр.
.
.
.

- Временной интервал между слияниями кубов в секундах.
.
.
.

- Объединение вокселей по цвету в процентах. Например, если значение 100 и картинка состоит из 5 красных пикселей и 5 синих, то получится 1 большой фиолетовый квадрат.

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

Для начала вам нужно будет экспортировать саму модель .vox и её обычную палитру в одну и ту же отдельную папку.

Палитра:

Далее добавьте к имени палитры в конце -special, иначе мод не найдёт палитру. В моём случае получилось rainbow-special.png
Далее отредактируйте эту палитру в любом предпочитаемом графическом редакторе (paint, gimp или photoshop). Ненужные цвета можно закрасить любым цветом, так как они не будут использоваться. Белый цвет в этой маске это 1, а черный - 0.
Мощность свечения/прозрачность задаётся оттенками серого от 0 до 1, а свечение потом ещё и умножается на "максимальное значение свечения" из настроек импорта моделей.


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

П - проблема
Р - решение


П: При нажатии ctrl+I слышу звук ошибки и ничего больше не происходит.
Р: Попробуйте выключить лимит на 5к пикселей или уменьшить картинку.

П: Вместо моей картинки появляется красный знак вопроса.
Р: Ваше изображение либо:
а) повреждено
б) на самом деле файл другого формата, переименованный в .png или .jpg (или какой формат вы там используете)
В интернете много сайтов которые могут конвертировать изображения из .webp в .png

П: Цвета в моём изображении и в импортированном не совпадают на 100%
Р: Используйте .png


П: При нажатии Ctrl+I игра крашнулась с такой ошибкой:

Р: Ваша .vox моделька повреждена, попробуйте починить её открыв и сохранив как новый файл в MagicaVoxel


П: Я слышу звук ошибки но не понимаю в чём проблема.
Р: Нажмите f1 чтобы открыть консоль, текст ошибки скорее всего будет там (на английском конечно, используйте переводчик)

П: У меня лагает из-за большого количества объектов.
Р: 1. Используйте объединение кубов (вкл/вкл - общие настройки)
2. (если не помогло 1.) Увеличьте % объединения по цветам (третье поле в настройках объединения кубов)
3. (если не помогло 2.) Оптимизируйте модель или изображение вручную (фотошоп, магика воксель)

П: Импорт слишком медленный.
Р: Отмените импорт (Ctrl+I еще раз) и увеличьте количество вокселей за кадр в общих настройках и в настройках объединения кубов.

П: Не могу найти импортированную модель/картинку.
Р: Поищите возле нулевых координат (x=0, y=0, z=0).

П: Тут нет моей проблемы / объяснение не помогло / нашёл баг в моде
Р: Свяжитесь со мной в дискорде (@nikioto4242) или в стиме.

В будущих версиях мода (если они вообще будут) скорее всего будет расширена фича с доп палитрами чтобы можно было использовать и обычные и прозрачные и светящиеся воксели одновременно.