Добро пожаловать в VoxelCdx

VoxelCdx — воксельный редактор от Collidx Studio для моделей, готовых к игре: строите и красите вокселями, ставите кости, анимируете на таймлайне, рендерите трассировкой путей и экспортируете прямо в Unity, Blender, Godot или любой движок.

Четыре сцены, один проект

Вся работа идёт в четырёх сценах. Переключайтесь кнопками слева на панели инструментов или клавишами Ctrl/⌘+1 … Ctrl/⌘+4.

Проект (.vcdx) хранит сколько угодно моделей — как объекты в MagicaVoxel, — и у каждой свои слои, холст, скелет и анимации. В палитре 1024 цвета с материалами, а в проекте может быть несколько страниц палитры.

Free и Pro

Страницы и функции со значком Pro требуют VoxelCdx Pro или бесплатный пробный период на 7 дней — см. Установка и лицензия.

Как читать документацию

• Клавиши указаны для обеих систем: Ctrl/⌘+S — это Ctrl+S в Windows и Linux и ⌘+S в macOS. Любую клавишу можно сменить в Edit ▸ Keyboard shortcuts.
• Пути в меню выглядят так: File ▸ Export ▸ FBX. Названия кнопок и меню написаны так же, как в программе (по-английски).
• Плашки отмечают советы, предупреждения и функции Pro.
• Нажмите / или Ctrl/⌘+K в любом месте документации, чтобы искать; F1 в VoxelCdx открывает копию этой документации, которая работает без интернета.

Установка и лицензия

Скачайте VoxelCdx для своей системы, запустите и решите, нужен ли вам Pro. Одна загрузка содержит всё: программа работает как Free, пока вы не начнёте пробный период или не введёте ключ.

Скачать и установить

Free, Pro и пробный период

Кнопка Free · Get Pro в правом верхнем углу окна (когда Pro активен, на ней написано Pro) открывает окно лицензии.

• Free не заканчивается: моделирование, покраска, рендер и статичный экспорт бесплатны.
• Start the free 7-day Pro trial открывает все функции Pro на этом компьютере. Карта не нужна. Когда пробный период закончится, программа вернётся в Free, а проекты останутся с вами — проекты с ригом по-прежнему открываются и сохраняются.
• Pro бывает помесячно, на год или навсегда — See plans & buy Pro ↗ открывает раздел с ценами . Вы получите ключ вида VXC-XXXXX-XXXXX-XXXXX-XXXXX.

Активировать ключ

1. Откройте окно лицензии

   Нажмите Free · Get Pro в заголовке окна.

2. Введите ключ

   Вставьте его в поле Already bought? Enter your key и нажмите Activate.

3. Готово

   Значок меняется на Pro. Ключ работает на двух компьютерах одновременно.

• Без интернета: после успешной проверки VoxelCdx работает офлайн до 14 дней.
• Перенести ключ на другой компьютер: на старом нажмите Deactivate this computer в окне лицензии, затем ещё раз для подтверждения.
• Manage online ↗ открывает страницу аккаунта voxelcdx.pages.dev/account . Там видно лицензию и её компьютеры, и можно убрать компьютер. Войти можно ключом, а для полного управления — кодом владельца (VXO-…), который показывается после покупки.

Первый персонаж за 10 минут

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

1. Создайте проект

File ▸ New project… (Ctrl/⌘+N) спрашивает:

• Canvas (холст) — заготовки от 16³ до 256³, свои X / Y / Z или Unlimited world (без границ). Позже можно сменить через Model ▸ Canvas size….
• Start with — Empty (только сетка), Cube, Floor (пластина в один воксель), Solid (весь холст заполнен, чтобы вырезать) или Character — готовый персонаж с ригом, анимацией Idle, мечом и лазерной винтовкой, чтобы разобрать его.
• Palette — Default, Pastel, Vivid, Earth, Warm, Cool или Grayscale.

2. Соберите части тела

1. Слой на каждую часть тела

   Ctrl/⌘+Shift+L создаёт новый слой, двойной клик — переименовать: Body, Head, Arm.L, Arm.R, Leg.L, Leg.R. Отдельные слои делают риг почти автоматическим.

2. Рисуйте

   Выберите цвет в палитре, инструмент Attach (1) и кликайте по земле или граням. Box (8) рисует блоки, Face (9) вытягивает целые грани.

3. Зеркальте

   Включите Mirror drawing X (X), чтобы строить обе руки и ноги сразу.

4. Красьте

   Paint (3) перекрашивает, не меняя форму; Fill (0) перекрашивает целую область.

Всё уже построено одним слоем? Выделите часть и нажмите Layer ▸ Selection to new layer (Shift+L). См. Слои.

3. Риг

1. Откройте сцену Rig

   Нажмите Ctrl/⌘+2.

2. Авториг

   Нажмите Auto-rig на панели инструментов. Получится кость на каждый слой, суставы там, где части соприкасаются, иерархия (руки следуют за телом) и имена для движков — Arm.L, Arm.R…

3. Проверьте суставы

   Кликните по голове или хвосту кости и подвиньте стрелки, чтобы точнее задать место сгиба.

Подробнее: Кости и скелет и Привязка вокселей.

4. Анимация

1. Откройте сцену Animate

   Нажмите Ctrl/⌘+3 и создайте клип кнопкой + рядом со списком клипов — например Walk, 24 кадра, 12 FPS, Loop включён.

2. Поза и ключ

   На кадре 0 выберите ногу, нажмите R и поверните её кольцами, затем I — поставить ключ. Сдвиньте плейхед →, снова поза, снова ключ.

3. Отзеркальте другую сторону

   Скопируйте позу (Ctrl/⌘+C), перейдите в середину клипа и нажмите Paste flipped (Ctrl/⌘+Shift+V) — левая нога получит движение правой.

4. Воспроизведите

   P — пуск и пауза.

Подробнее: Клипы и позы, Таймлайн и ключи.

5. Отрендерите картинку

Tab — сцена Render. Выберите Lighting preset на панели инструментов, поставьте Quality на High и нажмите Render image… (Ctrl/⌘+Shift+R), чтобы сохранить PNG. Выберите Animation в Show in render, чтобы отрендерить клип в MP4 или GIF. См. Сцена Render.

6. Экспорт в движок

File ▸ Export ▸ Rigged & animated model (FBX / glTF)…:

Интерфейс

Окно VoxelCdx устроено одинаково во всех сценах: меню и инструменты сверху, палитра слева, 3D-вид посередине, свойства сцены справа.

1234567891011121314

1. 1
   Меню File, Edit, Select, Transform, Filters, Model, Layer, Scene, View, Render, Help — у каждого пункта указана его клавиша.
2. 2
   Search commands Открывает поиск команд (F3 или Ctrl/⌘+R).
3. 3
   Сцены Model, Rig, Animate, Render (Ctrl/⌘+1…4).
4. 4
   Инструменты Attach, Erase, Paint, пипетка, Select, Move, волшебная палочка.
5. 5
   Кисть Режимы кисти, размер, куб или шар, зеркальное рисование.
6. 6
   Вид и отмена Сетка, кадрирование, затенение, фон, отмена / повтор, настройки.
7. 7
   Хотбар Зеркальное рисование, отражение, поворот, зеркальная копия, масштаб, фильтры, поиск команд и шпаргалка клавиш.
8. 8
   Палитра Страницы цветов, недавние цвета и материал выбранного цвета.
9. 9
   Вкладки моделей Все модели проекта, папки, звёзды и сортировка.
10. 10
    3D-вид Здесь строят. Подсказки в углах показывают инструмент и холст.
11. 11
    Навигатор осей Клик по оси — вид с этой стороны.
12. 12
    Стрелки панелей Возвращают скрытые панели и открывают браузер файлов.
13. 13
    Слои Видимость, замок, имена, число вокселей, группы.
14. 14
    Холст и быстрые действия Размер холста, генераторы, импорт и быстрый экспорт.

Части окна

Поиск команд

F3 или Ctrl/⌘+R — как поиск по меню в Blender. Введите часть названия (mirror, hollow, export, key) — появятся все подходящие команды с их клавишами; Enter запускает, ↑ ↓ выбирают. Недавние команды идут первыми.

Стартовый экран

Показывается при запуске (отключается галкой Show this screen at startup). Слева: New project…, Sample character, Open…, Browse a folder… и Quick new canvas — размеры от 16 до 256. Справа — недавние проекты с превью. Если прошлый сеанс закончился без сохранения, Recover unsaved work предложит вернуть работу. Открыть снова — File ▸ Start screen (Ctrl/⌘+Shift+H).

Панели

• Тяните край палитры, правой панели, списка костей или верх таймлайна, чтобы поменять размер. Размеры запоминаются.
• Масштаб содержимого 1.2.8: Ctrl/⌘ + колесо над палитрой делает образцы больше или меньше — крупные переносятся рядами по 8 или 4, мелкие помещают всю палитру без прокрутки. Над правой панелью то же колесо масштабирует её содержимое от 70% до 140%. Оба значения запоминаются; те же шаги и сброс — в View ▸ Panel size.
• Двойной клик по краю панели скрывает её. Вернуть — стрелкой у края 3D-вида, N (панель свойств), Shift+N (палитра) или через меню View.
• Подсказки на 3D-виде (инструмент слева сверху, модель и холст справа сверху, клавиши навигации снизу) отключаются по одной в View ▸ Hints on the viewport или все сразу — Alt+H.
• В узком окне строка инструментов прокручивается колесом мыши или стрелками ‹ › по краям.

Числовые поля и ползунки

Числовые поля работают как в Blender: тяните влево или вправо, чтобы менять значение (Shift — мелкий шаг, Ctrl/⌘ — крупный), кликните, чтобы ввести число, Enter или Esc — выйти. Стрелки ‹ › появляются при наведении. Число Size у кисти превращается в поле ввода по двойному клику.

Браузер файлов

Стрелка на правом краю 3D-вида (B) выдвигает браузер в стиле Blockbench: карточки с превью для каждого .vcdx и .vox в папке, подпапки, фильтр, сортировка и ползунок размера карточек. Наведите курсор на карточку — увидите большое превью с числом вокселей, размером и именами моделей. Двойной клик открывает файл; правый клик добавляет его в текущий проект как модель, переименовывает или показывает в Finder / Проводнике.

Отмена

Ctrl/⌘+Z отменяет, Ctrl/⌘+Shift+Z или Ctrl/⌘+Y повторяет. Отменяется всё — воксели, слои, модели, палитра, кости, ключи и даже позы без ключей. Одно перетаскивание — один шаг; одна правка поля — один шаг.

Камера и 3D-вид

Двигайтесь вокруг модели мышью, клавиатурой или навигатором осей и решайте, что показывает 3D-вид.

Управление камерой

Навигатор осей

Оси X / Y / Z в левом нижнем углу. Кружки с буквами — положительные направления, бледные — отрицательные. Клик по кружку — вид с этой стороны; повторный клик — с противоположной. Скрыть — View ▸ Axis gizmo.

Что показывает вид

File ▸ Export ▸ Viewport screenshot (.png)… сохраняет ровно то, что показывает вид.

Фон и туман

Кнопка с картинкой справа вверху на панели инструментов (Background, fog and reference pictures):

• Фон 3D-вида: как в теме, свой цвет, градиент (верх и низ) или своя картинка.
• Готовые фоны — Studio, Midnight, Sky, Paper и другие — в один клик; те же есть в разделе Scene сцены Render.
• Свои пресеты: поменяв цвета пресета, Save to “имя” перезаписывает ваш пресет, а Save as new preset… сохраняет оба. Пресет, совпадающий с текущими цветами, обведён.
• Fog (туман) растворяет дальние части модели в фоне.

Фон — ваша личная настройка, она действует во всех проектах.

Референсы

Моделируйте поверх эскиза, фото или видов спереди и сбоку:

1. Добавьте картинку

   В той же панели нажмите Add и выберите изображение.

2. Выберите, где она стоит

   Front, Side, Top — плоскость в сцене у задней стенки холста — или Screen: закреплена позади модели и не двигается при вращении камеры.

3. Настройте

   Размер, положение, прозрачность и Draw over the model — видеть её сквозь воксели, как через кальку.

Референсы сохраняются в проекте в полном разрешении и никогда не попадают в экспорт и рендер.

Инструменты и кисти

Инструмент решает, что делать с вокселями: добавить, стереть, покрасить, взять цвет или выделить. Режим кисти решает форму мазка: точка, линия, коробка, целая грань. Любой инструмент работает с любым режимом.

Инструменты

Режимы кисти

Размер кисти

• [ и ] уменьшают и увеличивают кисть; ползунок Size на панели делает то же самое.
• Двойной клик по числу рядом с ползунком — ввести точный размер, затем Enter.
• C переключает куб и шар.

Коробка со стрелками

В режиме Box с включёнными Box arrows (кнопка рядом с режимом):

1. Нарисуйте основание

   Зажмите и протяните по земле или грани — получится прямоугольник.

2. Задайте размер

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

3. Поставьте

   Enter или клик мимо коробки ставит её. Esc — отмена.

С выключенными Box arrows коробка ставится сразу при отпускании; крутите колесо во время протягивания, чтобы задать высоту.

Инструменты на нескольких слоях

Когда выбрано несколько слоёв (см. Слои), Paint, Select, Magic wand и всё, что делается с выделением — перемещение, поворот, отражение, удаление, перекраска, — работает на всех выбранных слоях сразу.

Симметрия и трансформации

Рисуйте обе стороны модели сразу, а построенное отражайте, поворачивайте, зеркально копируйте, масштабируйте и двигайте одной клавишей.

Зеркальное рисование

X, Y и Z (или кнопки MIRROR DRAW на хотбаре) включают зеркальное рисование по каждой оси: добавление, покраска и стирание идут с обеих сторон сразу.

View ▸ Symmetry planes показывает, где проходят плоскости зеркала.

Трансформации

Трансформации работают с выделением, а без выделения — со всем слоем или со всеми выбранными слоями. Они есть на хотбаре и в меню Transform.

Зеркальная копия копирует выделение на другую сторону оси: постройте одну руку — вторая появится сама.

Кнопка Transform в простой раскладке

В простой раскладке (см. Внешний вид) те же команды собраны в одной кнопке Transform ▾ с простыми названиями: Flip left ↔ right, Turn 90° left / right, Mirror copy to the other side, Double the size, Half the size, Put on the ground, centred, Make hollow, Smooth.

Выделение и буфер обмена

Выделяйте воксели, чтобы красить, двигать, копировать или выносить их на отдельный слой. VoxelCdx работает как MagicaVoxel: сдвинутый кусок парит над моделью и ничего не портит по пути.

Как выделить

• Select (5) текущим режимом кисти: Free выделяет кистью, Box — прямоугольником на экране, Face — плоской гранью, Fill — связной областью цвета.
• Magic wand (M): все воксели цвета под кликом.
• Select ▸ All (Ctrl/⌘+A), Select ▸ None (Esc, Ctrl/⌘+Shift+A), Select ▸ Invert (Ctrl/⌘+I), Select ▸ Same colour as current, Select ▸ Grow.
• Shift добавляет к выделению, Ctrl/⌘ убирает из него.

Рамка выделения

Выделение показывает рамку с шестью цветными стрелками:

• Тяните стрелку, чтобы увеличить или уменьшить рамку с этой стороны.
• Shift + перетаскивание стрелки двигает сами воксели.
• Стрелки клавиатуры и Page Up / Page Down сдвигают выделение на один воксель.
• Fill box (Shift+F) заливает пустую часть рамки текущим цветом.

Раздел SELECTION правой панели повторяет эти действия кнопками: Copy, Cut, Paste, Dupe, Paint, Delete, Fill box, Grow, Invert и Deselect.

Перемещение без потерь

При перемещении ничего не стирается по пути: выделенный кусок парит. Воксели, над которыми он проходит, возвращаются, как только он двигается дальше. Заменяется только то, что останется под куском, когда вы снимете выделение.

Копирование и вставка

• Вставка кладёт кусок туда, откуда он взят, если там хватает холста; иначе — в центр холста на землю, целиком, без обрезки.
• Копия поверх оригинала: Ctrl/⌘+C, Ctrl/⌘+V — вставленная копия парит над оригиналом на том же слое. Отразите, поверните или сдвиньте её — оригинал останется на месте. Delete сразу после вставки удаляет только копию.
• Цвета подбираются: если в другом файле цвет лежит в другом слоте палитры, берётся тот же или ближайший цвет.
• Буфер обмена хранится в файле, поэтому вставка работает во втором окне VoxelCdx и после перезапуска.

Выделение в новый слой

Layer ▸ Selection to new layer (body part)… (Shift+L) переносит выделенные воксели в отдельный слой — самый быстрый способ разделить цельную модель на части тела перед ригом.

Отмена

Ctrl/⌘+Z отменяет, Ctrl/⌘+Shift+Z или Ctrl/⌘+Y повторяет — любую правку, включая выделения, менявшие воксели, слои, модели, палитры, кости и ключи.

Слои

Слои разделяют части модели: голову, руку, оружие, деталь, которую хочется отключать. Держите одну часть тела на слой — и риг станет почти автоматическим.

Список слоёв

Раздел LAYERS правой панели (сцена Model):

• Глаз показывает или скрывает слой, замок защищает его от правок, число справа — количество вокселей.
• Двойной клик по имени — переименовать; или наведите курсор на слой и нажмите F2.
• Кнопки над списком: новый, дублировать, слить вниз, выше, ниже, удалить.
• Перетаскивайте слой (или группу слоёв) вверх и вниз, чтобы поменять порядок.
• Правый клик по слою — его меню: копировать, вставить, дублировать, слить, переместить, переименовать, соло, скопировать в другую модель, удалить.

View ▸ Dim inactive layers приглушает все слои, кроме активного, пока вы работаете.

Несколько слоёв сразу

• Shift + клик выбирает диапазон от активного слоя до нажатого; Ctrl/⌘ + клик добавляет или убирает один слой. Число выбранных слоёв показано под списком.
• Без выделения Move (T), стрелки, отражение, поворот, зеркальная копия, масштаб и центр на земле двигают все выбранные слои как одно целое. Оранжевая рамка обводит группу; поворот и отражение идут вокруг её центра. Одно действие — один шаг отмены.
• Paint, Select, Magic wand и все действия с выделением работают на всех выбранных слоях; Attach и Erase остаются на подсвеченном слое.
• Кнопки над списком работают со всей группой: дублировать, удалить, переместить, слить (всё сливается в самый нижний слой).
• Скрытые и заблокированные слои не трогаются. Обычный клик по одному слою заканчивает группу.

Слои между файлами

1. Скопируйте

   Выберите слои и нажмите Ctrl/⌘+C, когда воксели не выделены, — или Layer ▸ Copy layers (Ctrl/⌘+Shift+C).

2. Вставьте

   Откройте другую модель или файл и нажмите Ctrl/⌘+V или Layer ▸ Paste layers (Ctrl/⌘+Shift+V). Слои придут новыми слоями; в пустой активный слой — прямо в него.

Внутри одного проекта ещё быстрее: правый клик по слою ▸ Copy … to model ▸ нужная модель. Слои сохраняют место, если оно помещается в холст, иначе ставятся по центру. Имена, видимость, привязка к костям (если такие кости есть), оружие и аксессуары переносятся; цвета подбираются по палитре.

Модели на сцене в списке слоёв

Модель, поставленная в другую модель (см. Модели), появляется в списке слоёв под своим заголовком:

• стрелка сворачивает её слои в одну строку;
• кнопка со стрелками выбирает все её слои, чтобы двигать её по сцене;
• +N добавляет слои, которые позже появились в оригинале;
• цепочка показывает, связана ли она (правки уходят в оригинал) или это свободный вариант (изменения остаются здесь), — клик переключает.

Модели и папки

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

Вкладки моделей

• Вкладки над 3D-видом переключают модели; Ctrl/⌘+Page Up / Ctrl/⌘+Page Down — предыдущая и следующая.
• + создаёт новую модель (Ctrl/⌘+Shift+N) — пустую или копию текущей, со своим размером холста.
• Двойной клик по вкладке — переименовать. Правый клик — меню: закрепить, поставить в сцену, переложить в папку, переименовать, дублировать, сдвинуть влево / вправо, удалить.
• Звезда ☆ закрепляет модель: закреплённые всегда идут первыми.
• В одну строку колесо мыши прокручивает вкладки вбок, а активная вкладка всегда остаётся на виду.
• Кнопка ▾ разворачивает панель моделей: все вкладки в несколько строк, поле Filter models…, меню Sort, New folder и нижний край, за который можно менять высоту.

File ▸ Import ▸ Add a .vcdx / .vox file as a model… добавляет модели другого файла в этот проект новыми вкладками.

Папки

• Правый клик по пустому месту панели моделей (или ⋯) ▸ New folder… создаёт пустую папку; перетаскивайте на неё вкладки моделей.
• Правый клик по вкладке ▸ Move to folder или ⋯ ▸ Put this model in a folder…. Вложенные папки задаются через /, например Level/Walls.
• Правый клик по папке: Rename folder…, Icon, Colour, New folder inside… (подпапка), Remove folder (keeps the models).
• В развёрнутой панели папки показаны деревом; в одну строку — чипами, которые сворачивают и разворачивают свои модели.

Сортировка

Sort models (в меню правого клика, ⋯ или в развёрнутой панели) упорядочивает модели внутри каждой папки. Выбор сохраняется в проекте.

Модели в сцене

Собирайте уровень или диораму из других моделей и продолжайте править их прямо на месте:

1. Откройте модель-сцену

   Сделайте активной модель, в которую будете ставить остальные.

2. Поставьте модель

   Правый клик по вкладке другой модели ▸ Place in “…” · linked — или просто перетащите вкладку в 3D-вид. Place a free copy in “…” ставит независимую копию.

3. Правьте на месте

   Поставленная модель держит все свои слои внутри своей рамки. Покраска, добавление и стирание на сцене меняют и оригинал; дубли синхронизируются. Перемещение двигает её только на сцене.

• Связанные модели отправляют каждую правку в оригинал. Добавление, дубль, вставка, удаление, слияние и переименование их слоёв делают то же в оригинале, а слои, добавленные или удалённые там, сами появляются или исчезают на сцене.
• Свободные варианты оставляют изменения у себя — удобно пробовать цвета. Кликните по цепочке у модели или правый клик по слою ▸ Make a free variant.
• Правый клик по слою варианта ▸ Apply this variant to … — перенести его в оригинал, или Link to … again — отбросить изменения.
• Модели на сцене остаются внутри холста: вставка его не увеличивает, а перемещение всей модели останавливается у края.
• Строка над списком подсказывает, какую модель вы сейчас правите (сцену или поставленный оригинал).

Холст

Раздел CANVAS правой панели показывает размер и кнопки Resize… и Fit to model. Импорт сам увеличивает холст, если модель не помещается.

Фильтры и генераторы

Фильтры меняют весь слой (или выделение) разом; генераторы строят формы и ландшафт по настройкам. Все они в меню Filters, самые частые — ещё и на хотбаре.

Фильтры

Генераторы

Generate shape… строит примитив:

Generate terrain… строит ландшафт на шуме Перлина: ширина, глубина, максимальная высота, размер деталей, детализация (октавы), сид, нижний и верхний слоты цвета, уровень воды (0 — без воды) и цвет воды.

Палитра и материалы

В палитре 1024 цвета, у каждого свой материал для рендера. Проект может хранить несколько полных страниц палитры и мгновенно переключать их.

Палитра

• 1024 цвета в 64 рядах по 16: классические 256 плюс приглушённые, пастельные и глубокие наборы. Экспорт в .vox сам упаковывает использованные цвета в 255 слотов MagicaVoxel.
• Правый клик по цвету — редактировать на месте (с отменой). Под сеткой: RECENT — недавние цвета, и карточка выбранного цвета — большой образец (клик открывает пипетку-выбор), hex (введите и нажмите Enter), имя ряда и сколько вокселей им покрашено.
• Copy и paste переносят цвет вместе с материалом между слотами и страницами.
• ⋯ — настройки палитры: имена рядов, размер образцов, применить пресет к странице, загрузить и сохранить палитру, градиент из выбранных, сбросить цвет, выделить воксели этого цвета, заменить цвет.
• Размер образцов 1.2.8: Ctrl/⌘ + колесо над палитрой или ⋯ ▸ Swatch size задают образцы от 8 до 64 px независимо от ширины панели. Крупные переносят ряд из 16 цветов на 8 + 8 или 4 × 4; Fit swatches to the panel снова растягивает их на ширину.

Имена рядов и группы

Включите ⋯ ▸ Show row names, чтобы подписать ряды, как заметки в MagicaVoxel. Правый клик по имени ряда: Rename, Name from its colours, Clear name или Start a group here — группы делят длинные палитры на разделы.

Страницы палитры

Держите в одном проекте сколько угодно полных палитр — день и ночь, цвета команд, сезоны:

• Переключатель страниц вверху палитры, ◀ ▶ или , / . меняют страницу; модель перекрашивается мгновенно.
• New page… начинает с пресета, копии или файла. Дублировать, переименовать, двигать и удалять страницы — в меню переключателя или File ▸ Palette.

Пустые страницы и категории

New empty page начинается без цветов и растёт, как палитра в Aseprite: + добавляет цвет и открывает выбор. Цвета вокселей, вставленных из других файлов, добавляются сами.

+ New category под цветами начинает именованный раздел — Skin, Metal, Cloth — со своим +. Заполненный ряд сам продолжается в новом ряду. Двойной клик по имени — переименовать; правый клик ▸ Remove category (keeps the colours). Готовые палитры вместо категорий используют обычные группы.

Загрузка и сохранение

File ▸ Palette ▸ Load palette into this page… читает .png, .gpl (GIMP), .pal, .hex, .txt, палитру файла .vox или любую картинку. File ▸ Palette ▸ Save this page as a file… пишет те же форматы. Gradient from selected… строит переход между двумя слотами.

Материалы

Блок MATERIAL под палитрой задаёт, как выбранный цвет выглядит в сцене Render. Материалы сохраняются в .vcdx и .vox.

Импорт

Открывайте файлы MagicaVoxel, вокселизируйте 3D-модели, превращайте пиксель-арт и карты высот в воксели или объединяйте проекты. Можно просто бросить файл на окно: проекты и .vox откроются, 3D-модели и картинки импортируются.

Сцены MagicaVoxel

.vox с несколькими объектами становится отдельными моделями (вкладками), когда включено Each object as a separate model — или когда в настройках включено Preferences ▸ Saving ▸ Open each MagicaVoxel object as its own model; иначе объекты станут слоями одной модели. Use the file's palette заменяет вашу палитру палитрой файла.

Вокселизация 3D-моделей

Картинки

Кости и скелет

Сцена Rig (Ctrl/⌘+2) хранит скелет модели: кости, иерархию — какая кость за какой следует — и то, как скелет нарисован. Воксели выбранной кости остаются яркими, всё остальное приглушается.

Инструменты рига

Кнопки на панели: Auto-rig, Bind to nearest, Extrude child (Alt+E — новая кость, продолжающая хвост выбранной), Delete bone и Clear rig….

Авториг

Auto-rig делает кость на каждый видимый слой: суставы ставятся там, где части соприкасаются, часть с наибольшим числом соседей (обычно тело) становится корнем, и каждый слой привязывается к своей кости. Кости сразу получают имена для движков — Body, Head, Arm.L / Arm.R, Leg.L / Leg.R, Hand, Foot — а осмысленные имена слоёв сохраняются.

Имена для Unity

⋯ ▸ Name bones for Unity (Body, Arm.L / Arm.R…) переименовывает так же любой скелет. Лево и право определяются по положению кости: .L — собственная левая сторона персонажа, это +X в VoxelCdx, когда модель смотрит на вид спереди. Дубли имён теряют номера копий (hand.0002 становится Hand.R), а сокеты оружия и аксессуаров не трогаются.

Гизмо кости

• Клик по кости — появляется гизмо. G двигает, R вращает (или кнопки на панели).
• Клик по голове или хвосту — стрелки двигают только этот сустав. Сдвиг хвоста тянет за собой головы соединённых дочерних костей.
• Клик по телу кости — стрелки двигают кость вместе с детьми; Alt — только эту кость.
• Кольца поворачивают кость и её детей вокруг головы: цветные — вокруг одной оси, серое — вокруг взгляда, внутри — свободно.
• Ctrl/⌘ привязывает к половине вокселя или 15°. Точные значения — поля Head (joint) и Tail (end) в разделе BONE.

Несколько костей сразу

Shift + клик добавляет кости к выбору. Перемещение и поворот действуют на все сразу — а кости на другой стороне зеркалятся: выберите обе руки, поднимите одну — вторая поднимется так же. Ctrl/⌘+A выбирает все кости, Esc или Alt+A снимает выбор.

Иерархия — кто за кем следует

Список костей в SKELETON работает как аутлайнер Blender: пунктир показывает дерево, стрелки сворачивают детей, полоска под списком делает его выше. ⋯ ▸ Expand all / Collapse all раскрывают или сворачивают всё дерево.

• Правый клик по кости (в списке или на таймлайне) ▸ Follows — выбрать родителя или ничего, чтобы сделать кость свободной корневой. В том же меню: сделать выбранные кости её детьми, освободить, сделать корнем (цепочка выше перевернётся и будет следовать за ней), выбрать детей, цвет, свернуть детей.
• Перетаскивание: бросьте кость на другую — она будет следовать за ней; на пустое место — станет свободной. Во время перетаскивания целевая кость подсвечивается, а строка поясняет, что произойдёт, — собственные дети кости краснеют, потому что кость не может следовать за своим ребёнком.
• Ctrl/⌘+P — выбранные кости следуют за активной (последней кликнутой); Alt+P освобождает их — как в Blender.
• Поле Follows есть и в разделе BONE (Rig), и в разделе POSE (Animate).

Как выглядит скелет

Цвета костей: ряд Colour в BONE — 24 цвета и Custom colour для любого цвета; правый клик ▸ цвет на кости тоже работает. Несколько выбранных костей получают цвет сразу.

Армата и файлы скелета

• Armature — имя корня скелета в FBX и glTF. Моделям, которые делят анимации в Unity, нужны одинаковое имя арматы и имена костей.
• ⋯ ▸ Save skeleton… / Load skeleton… — шаблон .vxskel, чтобы переиспользовать скелет в других проектах. При загрузке можно подогнать суставы под размер модели и привязать каждый воксель к ближайшей кости.

Привязка вокселей

Привязка решает, какие воксели за какой костью следуют. Каждый воксель следует ровно за одной костью (вес 1 — как группа вершин в Blender), поэтому воксельные модели остаются чёткими в движении.

Три уровня привязки

Список BINDING

У каждого слоя есть строка с полем кости. Под строкой каждая окрашенная на этом слое кость показана чипом с числом вокселей:

• × на чипе убирает только эту покраску — воксели возвращаются к кости слоя.
• Кнопка очистки в строке слоя убирает всю покраску на этом слое.
• Clear painting под списком убирает покраску на всех слоях; Ctrl/⌘+Z возвращает её.
• Nearest bones отдаёт каждый воксель ближайшей кости — быстрый старт перед доводкой.

Инструменты покраски

Чтобы отложить инструмент покраски, кликните по нему ещё раз или нажмите Esc — вернётся Select.

Привязать слои как у другой модели

⋯ ▸ Bind layers like another model (same layer names → same bones) копирует привязку другой модели: слои с теми же именами следуют за теми же костями. Удобно после того, как построен второй персонаж с теми же именами слоёв.

Сокеты, оружие и аксессуары

Сокет — маленькая вспомогательная кость. Слои, прикреплённые к сокету, следуют за ним в каждой анимации, не попадают в сетку тела и сохраняют свой размер, поворот и положение. У раздела SOCKETS на панели Rig две вкладки:

И то и другое можно положить внутрь FBX персонажа сразу в сокет или выгрузить отдельными файлами с началом координат в сокете. Чистая сетка и общий материал работают для них так же, как для тела.

Сокет и оружие

1. Добавьте сокет

   Выберите кость кисти и нажмите Add socket в SOCKETS ▸ Weapons. На конце кисти появится маленькая кость WeaponSocket.R (или .L).

2. Постройте оружие

   Моделируйте его на отдельном слое, любого размера, в любом месте холста.

3. Прикрепите

   Нажмите Attach weapon…, выберите слой и сокет.

Сокет может держать несколько видов оружия; радиокнопка выбирает видимое. Другие кнопки в строке оружия: в руке (размер, хват, поворот), экспорт и открепить (снова обычный слой).

Аксессуары

1. Смоделируйте на месте

   Постройте шапку или пояс на отдельном слое прямо на персонаже.

2. Прикрепите

   SOCKETS ▸ Accessories ▸ Attach…: выберите слой, сокет — New socket in the middle of the accessory или уже созданный — и кость, за которой он следует: Head для шапки, Body или Hips для пояса.

3. Настройте

   Аксессуар остаётся ровно там, где вы его построили, и теперь двигается с этой костью. Кнопка на теле открывает его панель: размер, поворот, положение, опорная точка и Follows.

• Add socket на вкладке Accessories ставит пустой AccessorySocket в середину выбранной кости — потяните его концы, чтобы поставить на пояс, и прикрепите к нему сколько угодно аксессуаров.
• Галочка в строке аксессуара показывает или прячет его. В отличие от оружия, все аксессуары могут быть видны сразу — в Rig, Animate и Render.
• Follows на панели меняет кость, на которой висит сокет, — всё на этом сокете начинает двигаться с новой костью.
• Аксессуары сохраняются в проекте, копируются и вставляются вместе со слоем, а у каждого варианта семейства — свои.

Как сидит в руке или на теле

Кнопка в руке / на теле открывает панель:

Гизмо работает в Rig и в Animate — на персонаже в позе. Закройте панель, чтобы вернуть гизмо кости.

Экспорт

• Внутри FBX персонажа 1.2.8 — Export rigged FBX / glTF… ▸ Weapons & accessories: сразу на сокетах (уже привязаны и следуют за каждой анимацией) или отдельными объектами. Один файл вместо кучи; см. Экспорт с ригом.
• Отдельным файлом — кнопка экспорт в строке пишет FBX, OBJ или glTF с началом координат в сокете, с уже применёнными размером, хватом и поворотом. Используйте тот же размер вокселя, что и у персонажа. В Unity положите его под кость сокета с позицией 0, поворотом 0, масштабом 1 — см. Unity.

Семейства персонажей

Семейство — это базовая модель с анимациями плюс варианты, которые делят её скелет — те же имена костей и иерархию, — но держат свои пропорции, сокеты, оружие и аксессуары. Knight01 — база; Knight02–04 — варианты, которые играют все клипы Knight01 на своих телах.

Создать семейство

1. Подготовьте базу

   Ригните её, назовите кости, добавьте сокеты и сделайте анимации.

2. Вступите в семейство

   На варианте (вкладка в том же проекте): Rig ▸ ⋯ ▸ Join a family: use the skeleton of another model ▸ база.

3. Выберите настройки

   Joints: Fit to this model's size. Its animations: Link them — this model joins its family and follows its animations. Which voxels follow which bone: Like Knight01 — layers with the same names follow the same bones.

В SKELETON появляется блок FAMILY. Если у базы позже появятся кости, он покажет разницу, а Match skeleton добавит недостающие кости, подогнав их под эту модель.

Настройте каждого персонажа

• Пропорции и сокеты: в сцене Rig варианта двигайте суставы и WeaponSocket гизмо. Это поза покоя варианта, анимации она не трогает.
• Оружие и аксессуары: каждый вариант крепит свои слои к своим сокетам, со своей посадкой.
• Анимации: в сцене Animate варианта клипы базы помечены ⇠ Knight01. Проиграйте их, чтобы увидеть, как оружие сидит именно на этом персонаже.

Переделать клип для одного варианта

Поставьте ключи нужным костям прямо на варианте — например поверните сокет в Attack, чтобы лук не уходил в голову:

• Своими становятся только кости, которые вы поменяли: на таймлайне они получают ✎, а клип показывает ⇠ Knight01 ✎.
• Если потом поменять Attack у базы, вариант получит всё, кроме своих костей.
• Правый клик по кости на таймлайне ▸ Follow Knight01 again возвращает одну кость; в меню клипа Revert this clip to the base model's version возвращает весь клип. Update linked animations now сразу подтягивает последние изменения базы.

Экспорт семейства

• Пакет семейства Pro — всё общее в одном файле: участники, клипы, оружие и аксессуары, один общий материал, очистка сетки и настройка Unity. Рекомендуется.
• Быстрый экспорт семейства — FBX-файлы и описание .vxfamily без общего материала.

Клипы и позы

Сцена Animate (Ctrl/⌘+3) превращает модель с ригом в движение. Каждый клип — Idle, Walk, Attack — отдельная анимация со своей длиной и скоростью; вы ставите кости в позы гизмо и записываете ключи на таймлайне.

Клипы

Слева на таймлайне: список клипов, + — новый клип (имя, длина, FPS) и ⋯ с Rename…, Duplicate и Delete…. Справа:

Позы

• Клик по кости — выбрать; Shift добавляет кости; Ctrl/⌘+A выбирает все; Esc или Alt+A снимает выбор.
• Поворот (R): цветные кольца — вокруг X / Y / Z, серое — вокруг взгляда, внутри — свободно.
• Перемещение (G): стрелки по осям и центральный квадрат.
• Масштаб (T): кубики по собственным осям кости; центральный квадрат масштабирует по всем трём. Ctrl/⌘ привязывает к шагу 0.1.
• Тяните кость напрямую — она качается за мышью.
• Несколько костей: гизмо, ползунки и введённые значения меняют все выбранные кости одинаково, за один шаг отмены.
• Пока вы тянете гизмо, точные значения и изменение видны в углу 3D-вида — сдвинуть или скрыть это можно в View ▸ Hints on the viewport ▸ Transform values while dragging.

Раздел POSE

Auto-key

Auto-key на панели таймлайна записывает ключ на текущем кадре каждый раз, когда вы меняете позу кости. Без него поза остаётся без ключа, пока не нажмёте I, — и её тоже можно отменить.

Таймлайн и ключи

Таймлайн — это dope sheet: строка на кость, ромбик на ключ. Выбирайте ключи, тяните их, чтобы менять тайминг, копируйте и зеркальте, выбирайте, как движение идёт между ними.

Ключи и воспроизведение

На панели таймлайна то же кнопками: Key, Key all, удалить ключи, Auto-key, Copy, Paste, Paste flipped и Flip L↔R (отзеркалить выбранные ключи на месте).

Dope sheet

• Строка All bones вверху — сводка: показывает все ключи, клик по ключу выбирает этот кадр на всех костях.
• Ниже — строка на кость в порядке иерархии, с пунктиром и стрелками сворачивания. Свёрнутая кость показывает и ключи своих детей.
• Клик выбирает ключ, Shift / Ctrl/⌘ добавляют. Тяните ключи, чтобы менять тайминг. Двойной клик переносит плейхед к ключу.
• Ctrl + колесо — зум, Shift + колесо — прокрутка, Home сбрасывает вид. Тяните верхний край таймлайна, чтобы сделать его выше.
• Правый клик по ключу: интерполяция к следующему ключу, копировать, удалить, отзеркалить лево ↔ право, дублировать на кадр плейхеда, вставить, вставить зеркально и Key tool edits on this key…
• Правый клик по пустому месту: ключ на выбранные или на все кости на этом кадре, вставить, дорожка Key tools, сброс зума.
• Правый клик по имени кости: меню кости (Follows, цвет, сворачивание…).

Интерполяция

Интерполяция решает, как кость движется от ключа к ключу. Для новых ключей выберите её на панели таймлайна, для существующих — правый клик по ключам ▸ Interpolation (to the next key). Цвет ключа показывает тип.

Зеркальное движение

Paste flipped и Flip L↔R находят другую сторону по имени: Arm.L ↔ Arm.R, hand_L ↔ hand_R, L.Foot ↔ R.Foot, Left ↔ Right. Кости без пары (Body, Head) отражаются на месте.

Инструменты ключей

Инструменты ключей меняют готовые ключи одним ползунком, как AnimAide в Blender: смешивают с соседями, добавляют промежуточные позы, усиливают, сглаживают, масштабируют или наклоняют движение. Каждая правка запоминается — её можно изменить или откатить потом.

Как пользоваться

1. Выберите ключи

   Клик по ключу, Shift / Ctrl/⌘ + клик по другим, или клик по кадру в строке All bones — все кости на нём. Меняются только выбранные ключи — пустой кадр ничего не делает.

2. Выберите инструмент и тяните

   Выберите инструмент в KEY TOOLS и тяните ползунок влево или вправо. Поза обновляется на лету.

3. Отпустите

   Отпустили — изменение сохранено. Один Ctrl/⌘+Z его отменяет.

Инструменты

История правок

Каждая правка инструментом ключей отмечается:

• ★ на каждом изменённом ключе;
• полосой на дорожке Key tools таймлайна поверх изменённых кадров.

Клик по ★ или полосе открывает правку:

Правый клик по таймлайну ▸ Key tools lane — дорожка сверху, снизу или скрыта (★ на ключах остаются). Правый клик по ключу ▸ Key tool edits on this key… показывает все правки, которые его касались. История сохраняется в проекте.

Сцена Render

Сцена Render (Tab или Ctrl/⌘+4) — прогрессивный трассировщик путей на видеокарте: настоящий солнечный свет, мягкие тени, отражения, стекло и светящиеся воксели. Картинка сначала шумная и очищается с каждым сэмплом.

Отрендерить картинку

1. Выберите, что показать

   SHOW IN RENDER: Model (как построена), Pose (поза из Rig / Animate) или Animation (любой кадр клипа).

2. Осветите

   Lighting ▸ Preset… на панели: Daylight, Golden hour, Overcast, Studio, Sunset или Night — затем подстройте Sun и Sky.

3. Задайте качество

   QUALITY: Draft, Medium, High или Final.

4. Сохраните

   Render image… (Ctrl/⌘+Shift+R) рендерит PNG любого размера.

Что показывать

Пресеты качества

Любое значение, изменённое вручную, переключает на Custom; в разделе Quality ниже есть Light bounces, Sample limit, Samples per frame и Preview resolution.

Свет и сцена

Фоны

• Готовые градиентные фоны — в один клик; те же пресеты есть в панели фона 3D-вида.
• Поменяйте цвета пресета, затем Save to “имя” — перезаписать свой пресет, или Save as new preset… — оставить оба; правый клик по пресету — переименовать или удалить.
• Своя картинка: Choose… (PNG, JPEG, WebP, BMP или GIF). Fill the frame (crop the picture) заполняет весь кадр; если выключить, картинка показывается целиком, а вокруг — цвет фона.
• Картинки и градиенты не меняются тональной компрессией.

Render image

Render image… (Ctrl/⌘+Shift+R) рендерит отдельную картинку в полном качестве:

Restart render перезапускает накопление в 3D-виде — полезно после больших изменений.

Рендер видео

Отрендерите весь клип трассировщиком и сохраните как MP4, зацикленный GIF, AVI или кадры PNG — для Discord, страницы магазина или трейлера.

1. Выберите клип

   В сцене Render выберите Animation в SHOW IN RENDER и клип.

2. Выставьте кадр

   Настройте камеру, свет и фон, как для картинки.

3. Рендер

   Render video… (или Render ▸ Render animation (MP4 / GIF)…). Каждый кадр трассируется отдельно с текущей камеры.

Настройки

Видео использует FPS и длину самого клипа; GIF повторяется бесконечно.

Форматы и настройки экспорта

Экспортируйте модель в любую 3D-программу или движок через File ▸ Export. Статичный экспорт бесплатный; персонажи с ригом и анимацией, общие материалы и семейства — в Pro.

Форматы

Настройки

Скрытые слои и слои оружия и аксессуаров на сокетах в экспорт не попадают. Выбор запоминается для каждого формата.

Чистая сетка

Clean mesh — встроенный VoxCleaner: грани сливаются в большие полигоны через цвета, а цвета запекаются в текстурный атлас. Полигонов во много раз меньше, меш герметичный и готов для движков — без аддонов очистки.

• Однотонные грани делят один образец цвета, а одинаковые узоры хранятся один раз, поэтому атлас остаётся маленьким.
• У каждого блока в атласе есть запасная рамка, поэтому края не подхватывают цвет соседа.
• Используйте фильтрацию Point (Unity) или Closest (Blender) — FBX-экспорт уже приносит правильные настройки для Unity (см. Unity).

Экспорт с ригом и анимацией

File ▸ Export ▸ Rigged & animated model (FBX / glTF)… — или Export rigged FBX / glTF… внизу панелей Rig и Animate — пишет меш, скелет, привязку и все анимации в один файл.

Выбор формата

Что попадает в файл

• Кости сохраняют имена (Arm.L…), а корень называется по полю Armature. Каждый клип — отдельная анимация (take).
• Привязка — каждый воксель следует ровно за одной костью с весом 1.
• Кривые только поворота для костей, которые не смещаются: ключи перемещения пишутся только для костей, которые реально двигаются, поэтому модель другого размера может играть те же клипы и сохранить свои пропорции.
• Масштаб кости ровно как выглядит, включая выключенный Scale children too (маленькая вспомогательная кость <кость>_scale несёт масштаб там, где обычной трансформацией его не выразить).
• Скрытые слои не попадают.

FBX — Blender

У FBX-импортёра Blender свои правила: каждая кость смотрит вдоль своей локальной оси Y, её длина берётся по детям, а Ignore Leaf Bones удаляет любую концевую кость. Цель FBX — Blender сделана ровно под это:

• Кости смотрят как в VoxelCdx — рука вниз к кисти, носок вперёд, — поэтому скелет выглядит соединённым.
• Каждая концевая кость получает маленький кончик _end, который задаёт её точную длину. С включённым Ignore Leaf Bones Blender прячет кончики, а сокеты и кисти остаются.
• Оружие и аксессуары на сокетах приходят отдельными объектами с родителем — костью своего сокета, поэтому они сразу в руке или на теле и следуют за ними.

Деформация точно такая же, как у цели для Unity, — отличается только ориентация костей в покое. См. Работа с Blender.

Частота кадров

В FBX одна частота кадров на весь файл, а у каждого клипа VoxelCdx свой FPS. Экспорт выбирает частоту, при которой каждый клип ложится на целые кадры, — наименьшее общее кратное частот клипов, до 120 (например клипы на 5 и 12 FPS дают 60), иначе самую высокую. Ключи хранятся в секундах, поэтому каждый клип играет со своей скоростью в Unity и Blender.

Оружие и аксессуары

Если у модели есть оружие или аксессуары на сокетах, окно экспорта спрашивает, куда их деть:

• Один файл вместо персонажа плюс файла на каждое оружие — меньше мусора в проекте.
• Clean mesh чистит и их, а текстурный атлас и материал у них общие с телом.
• Остальное оружие на том же сокете (скрытое) приходит в FBX выключенным: Unity импортирует его с выключенным Mesh Renderer, Blender прячет. Включите нужное — и оружие сменилось. В glTF попадает только видимое.
• FBX — Blender: объекты привязаны к кости сокета как к родителю и следуют за ней без всяких ограничителей.

Общий материал

File ▸ Export ▸ Shared material — one texture for many models… кладёт много моделей — боссов, пропсы, целый уровень — на одну текстуру и один материал. В движке модели с общим материалом батчатся и рисуются быстрее.

Файлы

Держите их рядом с моделями — для Unity внутри Assets.

Как пользоваться

1. Создайте материал

   New… — начальный размер текстуры (она растёт сама) и пикселей на воксель. Сохраните его в проект игры.

2. Добавьте модель

   Откройте модель и нажмите Add “модель”: формат (FBX, OBJ, glTF, glTF + риг, FBX + риг), размер вокселя, pivot, слои. Файл модели сохраняется рядом с материалом.

3. Добавьте ещё

   Add every model of this project или Add files… — несколько файлов .vcdx / .vox сразу.

4. Держите в актуальном виде

   Изменённая модель помечается changed. Update — или Update N changed — переэкспортирует только эти модели.

Окно материала

• Превью атласа с областью каждой модели: клик выбирает модель, наведение показывает имя и размер. Пунктирная область хранит общие однотонные цвета.
• Статусы: up to date, changed, project not found (Locate project), model not in project, no project.
• TEXTURE: пикселей на воксель, максимальный размер, автоувеличение, Repack & shrink (плотная упаковка и уменьшение текстуры; все файлы переписываются).
• Merge in… переносит все модели другого общего материала в этот.
• Recent, Show folder, Check for changes.
• UNITY: установить скрипт-помощник — см. Unity.

Пакет семейства

File ▸ Export ▸ Family pack… — или Family pack… в блоке FAMILY — хранит всё общее для семейства персонажей в одном файле пакета (.vxmat) и экспортирует или обновляет его в один клик.

Что хранит пакет

Export / update the whole family выгружает новых и изменённых участников; тех, кого вы убрали из семейства, можно убрать и из пакета (их файлы остаются). Откройте пакет через неделю — настройки на месте; нажмите Export — и всё обновится.

Быстрый экспорт семейства

File ▸ Export ▸ Quick family export (separate textures)… — или Export family… в блоке FAMILY — выгружает семейство без общего материала:

• FBX базы со всеми клипами;
• FBX каждого варианта (свои пропорции и сокеты) только с переделанными клипами — или со всеми, если выбрать;
• FBX каждого оружия и аксессуара с началом координат в сокете;
• файл .vxfamily с описанием, кто есть кто.

Sort into folders 1.2.8 (включено по умолчанию) раскладывает папку как в игровом проекте:

Knights.vxfamily
Models/        Knight01.fbx, Knight02.fbx
Weapons/       Knight01_Sword.fbx, Knight02_Bow.fbx
Accessories/   Knight01_Helmet.fbx
Textures/      PNG + .meta на каждый файл
Animations/    Knight01_Animator.controller, Knight02_Animator.overrideController
Prefabs/       Knight01.prefab, Knight02.prefab

Animations/ и Prefabs/ создаёт помощник Unity при импорте. Выключите опцию, чтобы всё лежало в одной папке, как раньше.

Если включено Set up Unity automatically и папка внутри Assets проекта Unity, ставится помощник VoxelCdx, и Unity настраивает всё при импорте — см. Unity.

Работа с Unity

VoxelCdx пишет FBX так, как ждёт Unity: без поворота, 1 единица = 1 метр, модель смотрит вперёд (+Z), Arm.L — левая рука персонажа. Анимации приходят отдельными клипами, аватар можно делить между персонажами, а оружие и аксессуары приходят уже на своих сокетах.

Статичная модель

1. Экспорт

   File ▸ Export ▸ FBX (.fbx)… с Voxel size 0.1 (10 вокселей = 1 м) или своим масштабом.

2. В Assets

   Скопируйте .fbx, его текстуру .png и .png.meta текстуры в папку Assets проекта — или экспортируйте прямо туда.

3. Используйте

   Перетащите модель в сцену. Scale Factor 1 с включённым Convert Units (по умолчанию) — поворачивать не нужно.

Чёткие текстуры

Каждый экспорт FBX пишет рядом с текстурой файл Unity .meta, поэтому Unity сразу импортирует её с такими настройками:

Персонаж с ригом и анимацией

1. Экспорт

   File ▸ Export ▸ Rigged & animated model… ▸ FBX — Unity, Unreal.

2. Вкладка Rig

   Animation Type: Generic, Avatar Definition: Create From This Model.

3. Вкладка Animation

   Каждый клип VoxelCdx — отдельный клип. Включите Loop Time у зацикленных (Idle, Walk).

4. Animator

   Создайте Animator Controller, перетащите в него клипы и назначьте персонажу.

using UnityEngine;

public class PlayClip : MonoBehaviour
{
    [SerializeField] private Animator animator;

    private void Update()
    {
        if (Input.GetKeyDown(KeyCode.Space))
        {
            animator.Play("Attack");
        }
    }
}

Один аватар и Animator на всех врагов

1. Одинаковый скелет

   У всех персонажей должны совпадать имена костей, иерархия и имя Armature. Проще всего дать каждому скелет первого персонажа через Rig ▸ ⋯ ▸ Join a family или Load skeleton….

2. Первый персонаж

   Avatar Definition: Create From This Model.

3. Остальные

   Avatar Definition: Copy From Other Avatar, Source — аватар первого персонажа.

4. Один контроллер

   Один Animator Controller на всех — клипы первого персонажа играют на остальных с их собственными пропорциями.

Оружие и аксессуары

using UnityEngine;

public class SwitchWeapon : MonoBehaviour
{
    [SerializeField] private Renderer[] weapons;

    public void Equip(int index)
    {
        for (int i = 0; i < weapons.Length; i++)
        {
            weapons[i].enabled = i == index;
        }
    }
}

С отдельными файлами смена оружия — это смена дочерних объектов. Из кода:

using UnityEngine;

public class EquipWeapon : MonoBehaviour
{
    [SerializeField] private GameObject weaponPrefab;
    [SerializeField] private string socketName = "WeaponSocket.R";

    private void Start()
    {
        var socket = FindDeep(transform, socketName);
        var weapon = Instantiate(weaponPrefab, socket);
        weapon.transform.localPosition = Vector3.zero;
        weapon.transform.localRotation = Quaternion.identity;
        weapon.transform.localScale = Vector3.one;
    }

    private static Transform FindDeep(Transform parent, string name)
    {
        foreach (Transform child in parent)
        {
            if (child.name == name) return child;
            var found = FindDeep(child, name);
            if (found != null) return found;
        }
        return null;
    }
}

Общий материал и помощник

• Сохраните .vxmat внутри Assets и нажмите Install Unity helper в окне общего материала. Скрипт ляжет в Assets/Editor/VoxelCdx.
• Он выставляет общей текстуре Point без сжатия, создаёт один Name.mat рядом с .vxmat и назначает его каждой модели этого материала, чтобы они батчились.
• Без помощника: в настройках импорта каждого FBX, вкладка Materials, перенаправьте материал с именем общего материала на один .mat.
• Обновите модель в VoxelCdx — Unity переимпортирует её сам; префабы сохраняют ссылки.

Семейства и автоматическая настройка

С пакетом семейства или быстрым экспортом семейства внутрь Assets помощник настраивает всё при импорте:

• Generic — Create From This Model у базы, Copy From Other Avatar (аватар базы) у вариантов;
• Loop Time у зацикленных клипов;
• Base_Animator.controller с состоянием на каждый клип (Idle по умолчанию);
• Variant_Animator.overrideController на каждый вариант, заменяющий только его переделанные клипы;
• префабы с Animator, контроллером, аватаром, а также оружием и аксессуарами под их сокетами на 0 / 0 / 0, масштаб 1.

С Sort into folders 1.2.8 помощник кладёт контроллеры в Animations/, а префабы — в Prefabs/, рядом с Models/, Weapons/, Accessories/ и Textures/ — см. Быстрый экспорт семейства. FBX сами находят свои текстуры в Textures/, по-прежнему с фильтром Point и без сжатия.

Повторный экспорт обновляет FBX, контроллер и переопределения. Префабы не перезаписываются, так что ваши правки в них в безопасности — удалите префаб, чтобы собрать его заново. Запустить настройку вручную: Assets ▸ VoxelCdx ▸ Set up character families.

Работа с Blender

Персонажи с ригом идут в Blender через цель FBX — Blender; статичные модели — через OBJ, FBX или glTF. Вот как получить связный скелет, рабочие анимации и чёткие цвета вокселей.

Персонажи с ригом

1. Экспорт для Blender

   File ▸ Export ▸ Rigged & animated model… ▸ FBX — Blender.

2. Импорт

   В Blender File ▸ Import ▸ FBX (.fbx) с настройками по умолчанию. Частота кадров сцены берётся из файла.

3. По желанию: спрятать кончики

   У каждой конечной кости есть маленький кончик _end, который держит её точную длину. Включите Ignore Leaf Bones в импортёре, чтобы спрятать кончики, — сокеты и кисти останутся.

4. Играйте клипы

   Каждый клип становится действием Armature|Clip|BaseLayer. Переключайте их в Action Editor (Dope Sheet ▸ Action Editor) или отправьте в NLA.

Чёткие цвета

Blender по умолчанию сглаживает текстуры, и цвета вокселей размываются:

• В рабочем пространстве Shading выберите узел Image Texture и поставьте Interpolation на Closest.
• Чтобы видеть текстуру во вьюпорте: Z ▸ Material Preview или в режиме Solid Color ▸ Texture.

Статичные модели

• File ▸ Import ▸ Wavefront (.obj), FBX или glTF. С Voxel size 0.1 модель в 10 вокселей — это 1 м.
• С включённым Weld vertices каждая часть — одна связная сетка, и L берёт её целиком. Экспортируйте с One object per layer, чтобы получить отдельные объекты.
• Clean mesh даёт во много раз меньше полигонов — отлично для рендера больших сцен.

Общий материал в Blender

• Сначала выгрузите все модели в общий материал, потом импортируйте их в Blender.
• Каждый импорт OBJ создаёт свою копию материала (Name.001). Назначьте всем моделям один материал, а остальные удалите через File ▸ Clean Up ▸ Purge Unused Data.
• Добавили или обновили модель, пока Blender был открыт? В Image Editor выберите текстуру и Image ▸ Reload (Alt+R) — Blender держит старую картинку в памяти.
• Если VoxelCdx сообщает, что текстура выросла или была перепакована, импортируйте модели заново: у старых копий в Blender устаревшие UV.

Godot, three.js и другие движки

glTF binary (.glb) — универсальный формат: один самодостаточный файл с сеткой, текстурой, скелетом и анимациями. Unreal использует FBX.

Godot 4

1. Экспорт

   File ▸ Export ▸ Rigged & animated model… ▸ glTF binary (.glb) — или File ▸ Export ▸ glTF binary (.glb) для статичной модели.

2. Импорт

   Скопируйте .glb в проект. Двойной клик открывает настройки импорта; каждый клип — анимация в AnimationPlayer.

3. Чёткая текстура

   Откройте материал сетки ▸ Sampling ▸ Filter: Nearest (извлеките материал в окне импорта, чтобы изменение сохранилось).

extends Node3D

@onready var anim: AnimationPlayer = $AnimationPlayer

func _ready() -> void:
    anim.play("Idle")

func _unhandled_input(event: InputEvent) -> void:
    if event.is_action_pressed("attack"):
        anim.play("Attack")

three.js

import * as THREE from "three";
import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";

const mixers = [];
new GLTFLoader().load("hero.glb", (gltf) => {
  gltf.scene.traverse((node) => {
    if (node.isMesh && node.material.map) {
      node.material.map.magFilter = THREE.NearestFilter;
      node.material.map.minFilter = THREE.NearestFilter;
      node.material.map.needsUpdate = true;
    }
  });
  scene.add(gltf.scene);

  const mixer = new THREE.AnimationMixer(gltf.scene);
  mixer.clipAction(THREE.AnimationClip.findByName(gltf.animations, "Walk")).play();
  mixers.push(mixer);
});

Вызывайте mixer.update(delta) каждый кадр. Видимое оружие и аксессуары — дочерние объекты костей своих сокетов; найти их можно через gltf.scene.getObjectByName("Sword").

Unreal Engine

• Экспортируйте как FBX — Unity, Unreal и импортируйте как Skeletal Mesh с включённым Import Animations.
• Для чётких цветов откройте текстуру: Filter: Nearest, Mip Gen Settings: NoMipmaps, Compression Settings: UserInterface2D (RGBA).

Оформление и темы

Сделайте VoxelCdx таким, как вам нравится: две раскладки, девять встроенных тем — включая три пиксельные со своим расположением панелей — и любой акцентный цвет. Всё применяется сразу и запоминается.

Откройте через Edit ▸ Preferences… ▸ Appearance (Ctrl/⌘+,) или View ▸ Appearance: theme and accent….

Раскладка

Переключайтесь когда угодно через View ▸ Simple layout (big tools, fewer panels) — ничего не теряется. Всё, что прячет Simple, остаётся в меню и в поиске команд (F3).

Встроенные темы

Тема меняет панели, таймлайн и фон 3D-вида.

Акцентный цвет

Акцентом подсвечиваются выделение и активные кнопки. Theme colour оставляет у каждой темы свой; или выберите:

Пиксельные темы

Pixel Grey, Pixel Warm и Pixel Dark превращают VoxelCdx в пиксель-арт-редактор:

• чёткий пиксельный шрифт (Tiny5) без сглаживания, в размерах, где он остаётся резким;
• пиксельные иконки — каждая иконка перерисована пиксель-артом;
• объёмные кнопки с чёрной обводкой, светлыми и тёмными гранями и нажатым состоянием;
• пунктирные линии после заголовков разделов.

Pixel DarkPixel WarmPixel Grey

Ещё они переставляют панели:

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

Своя тема

Пакет темы — это папка с theme.json (цвета, шрифт, размеры текста и где стоят панели) и необязательными файлами styles.axaml с полным контролем над видом каждого элемента — как CSS для всего приложения. Поделиться темой — значит поделиться её папкой.

Создать тему

1. Начните с любой темы

   В Preferences ▸ Appearance выберите тему и нажмите New theme from the selected one…. VoxelCdx создаст папку с theme.json, styles.axaml, папкой fonts и README, переключится на неё и откроет папку.

2. Правьте

   Откройте theme.json в любом текстовом редакторе и меняйте цвета. Сохранение файла мгновенно перезагружает тему, пока она включена.

3. Делитесь

   Отправьте папку. Другие кладут её в свою папку тем и нажимают Reload themes.

Папка тем лежит рядом с настройками VoxelCdx — кнопка Open themes folder в Preferences ведёт туда:

theme.json

{
  "name": "Neon Night",
  "author": "you",
  "description": "Dark violet panels with a hot pink accent.",
  "base": "VoxelCdx Classic",
  "variant": "dark",
  "font": "JetBrains Mono",
  "colors": {
    "Background": "#0E0B16",
    "Panel": "#15111F",
    "Raised": "#1D1729",
    "Accent": "#FF4FA3",
    "Text": "#F1E9FF",
    "Glow": "#5B2A86",
    "ViewTop": "#1B1430",
    "ViewBottom": "#07050C"
  },
  "layout": {
    "tools": "top",
    "inspector": "right"
  },
  "styles": ["styles.axaml"]
}

Цвета

Для пиксельного стиля: Outline, BevelLight, BevelDark (светлая и тёмная грань кнопки), Field, FieldShade, SectionText, Pressed, Tooltip, List, SelectionText. Грани также превращаются в ресурсы теней ButtonBevelShadow, ButtonPressedShadow, FieldBevelShadow и PopupHardShadow.

Свои цвета: любое другое имя становится кистью с этим именем и суффиксом Brush — "Glow": "#7CFFCB" превращается в GlowBrush, который ваши стили могут взять как {DynamicResource GlowBrush}.

Раскладка

"layout": {
  "scenes": "left",
  "tools": "right",
  "inspector": "bottom",
  "hotbar": "bottom"
}

styles.axaml — полный контроль

Файлы стилей — это Avalonia XAML, они загружаются поверх стилей приложения, поэтому поменять можно что угодно: цвета, шрифты и размеры, отступы, скругления, рамки, тени, даже целые шаблоны элементов. Селекторы работают как в CSS: Button, Button.small, Button:pointerover, ListBox.layers ListBoxItem:selected, TextBlock.section.

<Styles xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">

  <!-- Section titles in the accent colour -->
  <Style Selector="TextBlock.section">
    <Setter Property="FontWeight" Value="Bold" />
    <Setter Property="Foreground" Value="{DynamicResource AccentTextBrush}" />
  </Style>

  <!-- Rounder buttons and boxes -->
  <Style Selector="Button, ToggleButton, RadioButton, ComboBox, TextBox">
    <Setter Property="CornerRadius" Value="8" />
  </Style>

  <!-- The active layer row in your own "Glow" colour -->
  <Style Selector="ListBox.layers Border.layerpick.active">
    <Setter Property="Background" Value="{DynamicResource GlowBrush}" />
  </Style>

</Styles>

Классы, которые используются по всему приложению: section, muted, hint, small, mini, icon, accent, segment, seg, toolgroup, separator, compact, layerpick, folderline, bindingrow, bonechip, filecard.

Ресурсы, которые можно брать: AppBackgroundBrush, PanelBrush, PanelRaisedBrush, PanelBorderBrush, StatusBarBrush, TextBrush, SoftTextBrush, MutedTextBrush, SubtleTextBrush, AccentBrush, AccentSoftBrush, AccentFaintBrush, AccentStrongSoftBrush, AccentTextBrush, ControlBrush, ControlHoverBrush, ControlBorderBrush, PopupBrush, TrackBrush, HoverBrush, OverlayBrush, OverlayBorderBrush, AppFontFamily.

Шрифты

Положите файлы .ttf или .otf в папку темы fonts и укажите в "font" имя семейства из самого файла (не имя файла). Без font тема использует шрифт приложения; имя, которого нет в fonts, ищется среди шрифтов, установленных в системе.

{
  "name": "My Pixel",
  "base": "Pixel Dark",
  "font": "Press Start 2P",
  "pixelText": true,
  "textSize": 8,
  "largeTextSize": 16,
  "iconPixel": 2,
  "sectionRules": true
}

Настройки

Edit ▸ Preferences… (Ctrl/⌘+,) — три вкладки: Saving, Keyboard и Appearance.

Сохранение

Клавиатура

У каждой команды может быть одно или несколько сочетаний:

• Кликните по клавише команды и нажмите новое сочетание.
• + добавляет ещё одно сочетание, × удаляет, ↺ возвращает стандартное.
• Поле поиска находит команды или клавиши — наберите Ctrl+D, чтобы узнать, что это сочетание делает.
• Reset all возвращает все стандартные.

Edit ▸ Keyboard shortcuts… (Ctrl/⌘+K) открывает эту вкладку сразу; Help ▸ Quick reference показывает шпаргалку. Полный список стандартных сочетаний — в разделе Горячие клавиши.

Оформление

Раскладка, цветовая тема, свои темы и акцентный цвет — см. Оформление и темы и Своя тема.

Discord Rich Presence

Когда Discord запущен, ваш профиль показывает, что вы работаете в VoxelCdx и чем заняты — моделированием, ригом, рендером. Статуса нет? В Discord проверьте Settings ▸ Activity Privacy (показывать активность), что ваш статус не «Невидимый» и что активность не выключена для сервера.

Горячие клавиши

Каждая команда VoxelCdx со стандартным сочетанием. Список собирается из самого приложения, поэтому всегда полный. Поменять любое сочетание — Edit ▸ Keyboard shortcuts… (Ctrl/⌘+K); команды без сочетания — в одном нажатии F3 через поиск команд.

Программа

Файл

Рендер

Правка

Выделение

Инструменты

Кисть

Трансформации

Фильтры

Генераторы

Холст

Слои

Модели

Палитра

Вид

Сцены

Риг

Анимация

В 3D-виде

В списках и на таймлайне

Файлы и форматы

Что VoxelCdx сохраняет, что открывает и как бережёт вашу работу.

Файлы проекта

Открытие файлов

• File ▸ Open… (Ctrl/⌘+O) открывает проекты .vcdx и файлы .vox.
• Перетащите файл на окно: проекты и .vox открываются; 3D-модели и картинки импортируются.
• Недавние файлы — на стартовом экране, в File ▸ Open Recent и в браузере файлов.

Сохранение и восстановление

• Save Ctrl/⌘+S, Save As Ctrl/⌘+Shift+S. Точка перед именем в заголовке окна — есть несохранённые изменения.
• Изменения сравниваются по содержимому: копирование, выделение или отмена до сохранённого состояния изменением не считаются.
• Autosave (Preferences ▸ Saving): выкл., копия для восстановления или сохранение прямо в файл проекта каждые N минут.
• После сбоя стартовый экран предложит Recover unsaved work.

Импорт и экспорт одним взглядом

Решение проблем и FAQ

Быстрые ответы на самые частые вопросы. Не нашли свой? Ищите через / или спросите в Discord .

Моделирование

Ничего не рисуется

Активный слой заблокирован или скрыт, либо вы рисуете вне холста. Проверьте глаз и замок в списке слоёв и Model ▸ Frame canvas, чтобы увидеть холст.

Paint или Select меняют несколько слоёв

Выбрано несколько слоёв (их число — под списком слоёв). Paint, Select и действия с выделением работают по всем. Обычный клик по одному слою снимает группу. См. Слои.

Я опустил модель ниже земли

Воксели вне холста сохраняются. Верните их или используйте Model ▸ Fit canvas to model.

Как сдвинуть или повернуть модель из многих слоёв?

Кликните первый слой и Shift + клик по последнему (или Ctrl/⌘ + клик по нужным), затем Move (T), стрелки или FLIP / ROTATE — все выбранные слои двигаются как один.

Риг и анимация

Кость двигается, а часть — нет

Её воксели не привязаны к этой кости. В Rig: поле кости слоя в BINDING, Part to bone или Nearest bones. См. Привязка вокселей.

Модель становится невидимой после Rig или Animate

Исправлено в 1.2.5 — обновите VoxelCdx (Help ▸ Download the latest version…).

Оружие огромное и не влезает в руку

Кнопка в руке рядом с оружием ▸ Size (например ×0.5) и Grip на рукояти. Воксели не меняются, а экспорт получает тот же размер.

Шапка не двигается с головой

Сокет аксессуара висит не на той кости. Кнопка на теле рядом с аксессуаром ▸ Follows ▸ Head. См. Аксессуары.

Paste flipped не меняет стороны

У костей нет пары по имени. Назовите их Arm.L / Arm.R или используйте Rig ▸ ⋯ ▸ Name bones for Unity.

Unity

Одиночные пиксели другого оттенка или цвета размыты

Unity сжал или отфильтровал текстуру. Копируйте .png.meta, который VoxelCdx пишет рядом с текстурой, вместе с PNG — или выставьте вручную Filter Mode: Point, Compression: None, Generate Mipmaps: off. См. Чёткие текстуры.

Модель огромная или крошечная

Используйте Voxel size 0.1 и Scale Factor 1 с включённым Convert Units. VoxelCdx пишет FBX в сантиметрах, как ждёт Unity.

Где оружие?

Экспортируйте персонажа с Weapons & accessories ▸ Inside the file, on their sockets — оно появится под костями сокетов. Оружие с выключенным Mesh Renderer было скрыто в VoxelCdx (на том же сокете было показано другое); включите его, чтобы сменить. См. Оружие и аксессуары.

Клипы одного врага не играют на другом

Разные имена костей, иерархия или имя armature. Дайте им одинаковый скелет через Join a family и поставьте Copy From Other Avatar. См. Unity.

Blender

Пропал сокет оружия

Ignore Leaf Bones удаляет конечные кости из FBX в стиле Unity. Экспортируйте как FBX — Blender — у его конечных костей есть кончики _end, так что сокет сохранится в любом случае.

Анимация сжата в несколько кадров

До 1.2.7 клипы с разным FPS в одном FBX пересчитывались по частоте первого клипа. Обновитесь и экспортируйте снова — теперь каждый клип ложится на целые кадры.

Все кости смотрят строго вверх

Так Blender читает кости из FBX в стиле Unity. Экспортируйте как FBX — Blender.

Цвета размыты

Поставьте у узла Image Texture Interpolation на Closest.

Чёрные или неверные цвета после добавления модели в общий материал

Image ▸ Reload (Alt+R) в Image Editor; если текстура выросла — импортируйте модели заново.

Приложение и лицензия

macOS пишет, что приложение нельзя открыть

Откройте Системные настройки ▸ Конфиденциальность и безопасность и нажмите Всё равно открыть — нужно один раз, потому что приложение пока не нотаризовано.

Пробный период закончился — проекты в безопасности?

Да. VoxelCdx переходит на Free; каждый проект, включая проекты с ригом, по-прежнему открывается и сохраняется. Активируйте ключ — и Pro вернётся.

Как перенести ключ на новый компьютер?

На старом компьютере: окно лицензии ▸ Deactivate this computer, нажмите ещё раз для подтверждения. Или удалите старый компьютер на странице аккаунта .

В Discord не видно VoxelCdx

См. Discord Rich Presence.

Словарь

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