BZepeto — ZEPETO Item Creator Suite for Blender, Unity & ArmorPaint
🇺🇸 English | 🇰🇷 한국어
BZepeto is an independent tool made by Chamiseul (ChamIseul Creator). It is not made, endorsed or supported by NAVER Z (ZEPETO), the Blender Foundation, Unity Technologies or the ArmorPaint authors.

The whole route of a ZEPETO item in one place: build it in Blender, paint it in ArmorPaint, and hand it to ZEPETO Studio in Unity — without exporting, importing and wiring materials by hand at every step.
Blender ──①──> ArmorPaint ──②──> Blender
│ └────③────> Unity (ZEPETO Studio)
└──────────────④──────────────> Unity (ZEPETO Studio)
① the mesh goes to ArmorPaint live ② painted textures come back ③ textures go straight to Unity ④ the finished item goes to Unity, checked and packaged
Pick a tool in the menu on the left:
| Page | What is in it |
|---|---|
| Blender Add-on | install, loading the base character, checks and Send, Review Tools, face expressions |
| Maya Plug-in (MZepeto) | the Maya edition: drag-and-drop install, Setup, the dockable panel and every section, step by step |
| Unity Package | install, automatic import and ZEPETO shaders, review menu |
| ArmorPaint | install, live link, node samples for beginners, the material library, ZEPETO Mode, stitches |
| Help & FAQ | troubleshooting, frequent questions, rejection reasons, licence |
What you need
| OS | Windows 10 / 11, 64-bit |
| Blender | 4.5 or later (tested on 4.5 – 5.3) |
| Maya (MZepeto) | Autodesk Maya 2027 |
| Unity | ZEPETO Studio project, Unity 2020.3.9f1 |
| GPU | DirectX 12 capable (for ArmorPaint) |
| ZEPETO base character | creatorBaseSet_zepeto.fbx from ZEPETO's creator resources — it is ZEPETO's file, so it is not included |
Your download
Gumroad gives you one file, BZepeto_<version>.zip. Unzip only this file (right-click >
Extract All). The BZepeto_<version> folder it makes holds:
| File | What it is | Install |
|---|---|---|
bzepeto_blender-<version>.zip |
Blender add-on | Blender page |
com.bzepeto.unity2020-<version>.tgz |
Unity package for ZEPETO Studio (Unity 2020.3.9) | Unity page |
BZepeto_ArmorPaint_<version>_win64.zip |
ArmorPaint with the BZepeto plugins enabled and the node samples (Template) |
ArmorPaint page |
SHA256SUMS.txt |
checksums to verify the downloads | — |
Do not unzip the Blender add-on
Blender installs bzepeto_blender-<version>.zip as it is. Unzip only the outer
BZepeto_<version>.zip and the ArmorPaint zip.
This guide is the only manual — there are no README files in the download.
Working in Maya?
The Maya edition, MZepeto, is its own download, MZepeto_<version>.zip: the Maya plug-in plus the same Unity
package and ArmorPaint. Install it from the Maya page.
Updating? Gumroad emails you when a new version is posted; download the new
BZepeto_<version>.zip from your Gumroad Library and install all three files. The Blender
add-on and the Unity package replace the old ones; ArmorPaint goes into a new folder.
Where BZepeto keeps its files
Everything lives under %USERPROFILE%\BZepeto. Put the base character in
%USERPROFILE%\BZepeto\Samples\creatorBaseSet_zepeto.fbx (or set ZEPETO Files Folder in the add-on preferences to the folder that holds it).
Blender and Unity both use %USERPROFILE%\BZepeto\HotExport as the hand-over folder, so there is
nothing to set up between them. To move everything, set the environment variable BZEPETO_HOME
(e.g. D:\BZepeto) and restart Blender and Unity.
What's New
v1.3.3 — MZepeto for Maya, ZEPETO's own Validate Items, custom characters
Update the Blender add-on and the Unity package
ArmorPaint 1.3.2 keeps working (only its version label changes). Maya users: install MZepeto_1.3.3.zip.
ZEPETO Validate Items in BZepeto — ZEPETO Studio SDK 3.2.18 added Validate Items: it checks a converted prefab against the rules ZEPETO's upload enforces, on ZEPETO's own server, so its verdict is the authoritative one. BZepeto now runs it for you: BZepeto > Review > ZEPETO Validate Items, or the ZEPETO Validate Items box on the dashboard's Import tab (the last imported item, or the selected prefabs), with an option to validate after every import (Unity page). It needs ZEPETO Studio SDK 3.2.18 or later.
BZepeto built-in shaders in the Unity package — the 13 BZepeto/Builtin/… shaders (Lit, Cloth, Fur, HairAlpha, Sparkle, Toon, Stocking, Strand Hair …) now install with the package. Items you upload still need the ZEPETO shaders; the review check tells you. BZepeto/Builtin/CustomEnv gains Gem Body: light refracts into the stone, bounces off the facets and leaves split into rainbow fire, with the stone's colour deepening inside, bright and dark facets, and sparks where the lamp is caught (Refractive Index 2.42 diamond, 1.77 ruby, 1.5 glass). BZepeto/Builtin/Stocking gains Foam: a soap lather over the stocking, switched on like Water Drops, with bubbles of mixed sizes, popped bubbles that thin into lace at the edge, a ragged waterline (Foam Up To Height) and a little puff, and controls for bubble size, depth, gaps, gloss, reflection and soap-film rainbow.
Import Custom Character — Wearables can load your own ZEPETO character FBX instead of the base set (Blender guide).
Export and Send leave out the bones the item does not use — the FBX now holds only the bones the item needs (a bone with weight on it, the bones above it, swing and high-heel bones), the same ones ZEPETO's converter keeps, so the item looks the same in ZEPETO. Your scene keeps every bone. After writing the FBX, BZepeto reads it back and checks its bones, meshes and skin (FBX check OK: 82 bones, 22 unused left out, 2 meshes) -- in Blender and in Maya (Blender guide). Bone Cleaner no longer cuts a chain: a bone above a kept bone stays.
The output folder is one setting now
In the Blender add-on, HotExport Path in the add-on preferences and Output Path in the Export panel used to be two separate settings, and Export, Send and ArmorPaint only read the panel one -- so changing the preference did nothing. They are the same setting now (saved with Blender's preferences, not in the .blend file). If you had set an Output Path in the panel, set it once more in the preferences or in the panel.
MZepeto brings BZepeto to Maya 2027: the same panels, buttons and ZEPETO checks, sending to the same Unity
package and painting in the same ArmorPaint. Install by dragging install.mel into the viewport; everything sits in one
dockable panel. Maya-only extras: Mirror Weights, Fix Scale Bones, Fit to Triangle Budget, Wrap to Body, Swing Test,
the viewport Status Badge and Playblast Review (Maya page). MZepeto uses the same version number as
BZepeto from now on: this first release is 1.3.3.
Maya: delete history only on the garment
In Maya a skin is history. Deleting history with the character selected, or with nothing selected, also deletes the character's skin, and then no garment can be bound any more (The body has no skinCluster). Select only the garment first, or use Delete by Type ▸ Non-Deformer History, which keeps skins (Maya page).
MZepeto in this release also has: set outfits (UDIM) sent from Maya, the Clothing Offset slider, the ZEPETO Shader menu that really sends the shader, swing buttons that build and weight chains on the rig, a clean Female bust rebuild, and MZepeto Live as a tool of its own, separate from BZepeto Live (Blender): different plug-in, folder and files.
v1.3.2 — ArmorPaint filters, mesh-driven generators + diagnostics
The ArmorPaint effect stack, reworked against Substance Painter:
- Filters (6 adjustment layers): Blur · Sharpen · Invert · HSL Shift · Levels · Warm Tint — they edit everything painted below (the Substance filter-layer way)
- Mesh-driven generators: Edge Wear and Cavity Dirt read the mesh's curved areas directly in the shader — they appear on edges and in crevices only
- 6 new GPU nodes (19 total): Tartan Plaid · Gingham · Polka Dots · Grunge · Water Drops · Glow Bands
- 10 new smart materials (32 total): Denim Wash · Rose Gold · Patina Copper · Neoprene · Cork · Terrazzo · Chalk Paint · Crushed Velvet · Tulle Net · Gold Sequin
Convert Diagnostics improved — fixed diagnosing the old target instead of the FBX picked in the Project window, the diagnosed path is shown in full, a Check the original FBX button appears for converted prefabs, and item meshes count skinned meshes too (correct FBXs no longer report "no item mesh")
Live preview removed — the Unity edit-mode scene has no character of its own (the SDK builds it on Play), so the feature had nothing to move. Blender's Playground covers body shape and pose checks
v1.3.1 — Studio render, Marvelous Designer link, long-skirt swing & accurate checks
Update the Blender add-on and the Unity package
ArmorPaint 1.3.0 keeps working (only its version label changes).
Studio render — the new Studio Render panel shoots the character in its items with a seamless backdrop, soft light and a portrait camera: background and light colour presets (rainbow too), full / upper body / head framing, builder sliders, EEVEE and Cycles, transparent PNG and the ZEPETO shaders' look (Blender guide).
Marvelous Designer link — The MD Live panel sends the ZEPETO character to Marvelous Designer and brings the garment back rigged for its category and worn. With Live on, every pose or body change swaps the avatar in Marvelous Designer and the refitted garment comes back by itself (Blender guide).
Auto skirt swing — Rigging > Swing Bones > Auto Skirt Swing puts swing chains on a skirt, dress or long coat in one go (4 from the front, hip joints to hem). The default hem swing of 0.4 keeps the legs inside the skirt in a stride
More accurate checks — things reported as errors or warnings that were not:
- a head item's (NoColor) material tag failed the naming check, and Fix Material Names removed it
- a refitted garment's internal shape key went out in the FBX as a blend shape (a real bug)
- _shd material names and DR/TOP mesh names are the guide's suggestion: shown as one, not a warning
- "too large" for heels and platform soles, "empty mask" for accessories, "hair colour" for hairbands/pins
- Export checks: "merge to one material" on a two-material dress, unused bones, absolute image paths
- Unity: the Sprites-Default warning on every converted prefab, "no hips" on unskinned items, the blend
shape error on hats without expressions, "texture matched no slot" when an item is sent again, and
"Can't import tangents" on every item (the FBX now carries tangents)
v1.3.0 — The ArmorPaint material library & high heels
Update all three tools together
Install the v1.3.0 Blender add-on, Unity package and ArmorPaint. Unzip ArmorPaint into a new folder and point ArmorPaint Executable at it.
The ArmorPaint material library (the BZepeto Library panel) — the star of this release:
- 22 smart materials — Wool·Canvas·Linen·Suede·Corduroy·Tweed·Velvet·Satin·Sequin·Camo, Gold·Chrome·Copper·Rusty Iron·Painted Metal·Brushed Aluminium·Carbon Fiber·Gem, Glitter·Wood·Marble·Plastic·Rubber. Colour, roughness, metal and relief land in one click, and being procedural they stay crisp at 512 px
- 6 generators — Dirt·Bleach Fade·Mud·Rust·Chipping·Sparkle Dust. One click makes a layer whose opacity is the pattern; paint its black mask to place it (the Substance smart-mask job)
- 9 quick setups — top·hoodie·jeans·skirt·coat·shoes·gem·hair·toon. The ZEPETO mode and a matching material, one button each
- Match materials by name — rebuilds the item's materials from the names they arrive with from
Blender (
gold_trim→gold,denim→denim,leather→leather ...). Hair, fur, eyes, mouth and lace are left alone
High heels — lift the heels with the Heel Angle and Sole (cm) sliders, model the shoe on
them, and the shoe's FBX carries ZEPETO's heel data (the expressions bones) so the preview wears it
the way you modelled it. Read Heel From Rig pulls the values of an imported ZEPETO heel item
Gloves, nails, rings — the finger weights no longer blend into the next finger when it bends; check with Glove Test > Fist
Mascot head expressions — a head bigger than the face gets expressions too: Mark Eyes / Brows / Mouth → Transfer to Mascot Head. A mascot eye 1.3x the face's blinks 1.3x as far
Skirts and dresses — no longer split open in the middle on a stride
Live preview removed — the Unity edit-mode scene has no character of its own (the SDK builds it on Play), so the feature had nothing to move. Checking body shape and poses stays with Blender's Playground (ZEPETO's preview menu and the clip tests)
Also — every panel folds into sections (▸/▾, the status stays on the folded row); check results list the problems first; panels stay fast after importing a GLB; Bind keeps a belt's and its buckle's thickness; the wrong T-pose coat warning is gone; symmetry fixes keep the 4-bones-per-vertex limit; Unity's hot folder survives bursts of files
v1.2.0 — Major update
Update all three tools together
Install the v1.2.0 Blender add-on, Unity package and ArmorPaint. Unzip ArmorPaint into a new folder and point ArmorPaint Executable at it.
All 10 ZEPETO shaders, end to end — pick the shader per item in Blender (Lit, Cloth, Fur, HairAlpha, Sparkle, Iridescence, Prism, CustomEnv, Toon, Detail Normal); ArmorPaint's ZEPETO Mode exports exactly the maps that shader reads; Unity sets shader, slots, keywords and factors by itself.
Fewer review rejections (ZEPETO's current guide, 2025–2026)
- Pose / body clip test: ZEPETO's 10 preview poses × 2 body types × 5 deformations, skin coming through the item marked in red (leg lifts through short skirts, holes in large body types)
- Face expressions: the 249 ZEPETO expression shape keys on the base character, transferred to headwear and masks so they follow the face; per-expression clip test; name and order checks
- Category triangle limits updated (socks 3,500, nail art 1,500); warnings for a mask reaching the neck/hands/feet, items far outside the preview, flat hair cards, a showing scalp, swing bones on bangs
- Over 1 MB of textures: which map to shrink to what size, and a Shrink Textures to 1 MB button
- Hair on a non-hair item (no hair colour) and hair cards invisible from behind are flagged
- Unity: "(NoColor)" added to headwear/mask materials; Light components, particle limits and particles without material or texture (white squares), non-ZEPETO shaders, Color Grading and fur length checked; thumbnail draft with particles; Import BlendShapes switched on
- Review Tools: head size test, baby hairs drawn in front, FX joint, female/custom torso fitting, content checklist
ArmorPaint — 13 BZepeto nodes with a finished sample material for each (Template folder), ZEPETO viewport preview, animated painting with a pose clip, emission in its own colour, rebuilt from current ArmorPaint sources
CustomEnv (gems, high gloss) — an HDRI set on the item lights ArmorPaint's viewport and becomes the Unity reflection cubemap
Set outfits (UDIM) — a top and a bottom material each get their own maps: painted as UDIM tiles in ArmorPaint, wired per material in Blender and Unity (how)
One download — all three tools in one file, BZepeto_1.2.0.zip, with checksums; the ArmorPaint
folder no longer includes ArmorPaint's downloaded brush and mask cache, so it is smaller
Hair quality — strand direction check, Sort Hair Layers, alpha check, clean strand ends
Fixes — textures painted in Blender without saving arrived blank; Unity live body shape / pose preview; normal maps, metallic/smoothness, emission and sheen colours, colour space, cut-out transparency in Unity
v1.0.0 — First release
- Blender add-on: ZEPETO checks and Send, swing bone wizard, body shape, wearables, playground
- ArmorPaint live link: paint while you model, smart ZEPETO materials, automatic stitches
- Unity package for ZEPETO Studio (Unity 2020.3.9): hot folder import and automatic ZEPETO shaders
© 2026 Chamiseul