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:

What you need

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:

This guide is the only manual — there are no README files in the download.

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 point the add-on preferences at 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.0 — The ArmorPaint material library & high heels

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

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