Give Her a 3D Avatar
Turn on her 3D body, pick or import a model, and learn what she does with it.
Follow the bold button names and numbered steps. Technical names are included only when you need to recognize a model or file inside the app.
By default she appears as a flat portrait. The 3D avatar replaces the portrait with a moving model that blinks, breathes, follows your cursor with her eyes, moves her lips when she speaks, and gestures while she talks. It is off until you turn it on.
Turn it on and pick a model
Goal
Show a 3D model in place of the portrait.
Before you start
- Open the chat once so you know which character is active. The model belongs to the active character, so every character can have her own body.
- You do not need to find a file first. Ready-made models are built in.
Steps
- Open Settings → 3D Avatar.
- Turn on 3D avatar.
- Under Model, choose one of the presets. They include six VRoid Hub samples: Avatar Sample A, Avatar Sample B, Avatar Sample C, Darkness Shibuya, Vita, and Sendagaya Shibuya.
- Select Use for and her name. The preview on the left of the tab shows her at once.
- Close Settings. She now stands in the sidebar instead of the portrait.
Expected result
The model blinks and breathes in the sidebar. If it cannot load, the app shows the portrait again and tells you the 3D avatar could not load.
If something goes wrong
- If the preview stays empty, pick another model. A model that fails in the preview cannot be used.
- The model list has a search box and keeps a thumbnail of each model you import yourself.
Import your own model
Goal
Use a character you made or downloaded.
Before you start
- Accepted files are
.vrm(VRoid Studio and VRoid Hub),.pmx(MikuMikuDance), or a.zipwith a model inside. The limit is 100 MB, or 300 MB unpacked for a.zip. - Check the licence. The import shows a licence card: free to use, personal use only, credit required, or no redistribution. MMD models keep their terms in a readme, and many authors allow private use only.
- The model stays on your computer.
Steps
- Open Settings → 3D Avatar and make sure 3D avatar is on.
- Under Model, select Import a model, or drop the file onto the tab.
- Wait while the app checks and copies the model. Large models can take a few seconds.
- Read the licence card.
- Select Use for and her name.
Expected result
The model appears under Your models and is assigned to her.
If something goes wrong
- This file is not a VRM model, This is not a 3D model file, and This model is too large mean the file is the wrong kind or over the limit.
- If you drop several files at once, only the first one is imported.
- Some textures are missing: import the
.zipthe MMD model came in, not the bare.pmx. - A model with no mouth shapes blinks and smiles but its lips do not move.
- Deleting a model that she is using sends her back to the default model, or to the portrait.
The tab also carries a short guide called How to get your own character: it explains making a model yourself in VRoid Studio (free), downloading one from VRoid Hub, and using MMD models. It links BOOTH, Gumroad, and DLsite for more VRM and MMD models.
Fix her face with Expression mapping
Most models are matched automatically. If a feeling does not show on her face, or shows the wrong one, open Expression mapping under Model. Each feeling and eye or mouth shape lets you choose which of the model’s own expressions plays it, and Test shows it on the preview. Back to automatic undoes your choices.
Backgrounds, camera, and behaviour
- Background: ten built-in scenes (such as Cafe, Library, Neon street, Sakura park), No background, or your own picture. A picture can be PNG, JPEG, or WebP up to 25 MB, and Blur and Darken adjust it.
- Camera and look: Framing in the sidebar (Bust, Face, or Full body), Zoom, Height in frame, Brightness, and Render quality. Reset camera and look restores the defaults. If she stutters, lower Render quality, because very detailed hair or clothes use more battery.
- Behaviour: She gestures on her own, Gesture size, Hand movements while talking, Idle fidgets, She does things on her own (sitting, stretching, reading, and now and then dancing), Use either hand, Eyes follow your cursor, Body language, and Reacts to touch. Turn off Reacts to touch if you do not want her to react when you pat or poke the model.
- Emotion tags: asks the chat model to mark where her feelings change, so her face changes at the right moment. It suits strong cloud or large local models, and every reply gets a little longer to write.
Ask her for gestures in chat
She picks gestures herself while she talks, but you can also ask. Type things like “wave”, “sit down”, “dance for me”, “lie down”, “go to sleep”, “spin”, or “make an angry face”. In Settings → 3D Avatar → Animations, Stop ends an animation you are previewing.
If she is holding a pose you asked for, a Stand up button appears on her. Select it to let her stand again.
If something goes wrong
Gestures you ask for still play when She gestures on her own is off. If one cannot play on a particular model, the app says that gesture could not play on this model.
Poses and the pose editor
Pose under Settings → 3D Avatar holds ready-made poses (Arms crossed, Hands clasped, Thinking, Kneeling, and more), grouped as Standing, Cute, Sitting, Lying, On the floor, Actions, Dances, Moving, and Other, with a search box. She keeps breathing, blinking, and gesturing in any pose. Kneeling poses lower her to the floor, so use Full body framing to see it.
To make your own, select Create your own pose, choose a base under Start from, adjust the head, torso, arms, and legs with the sliders, choose a hand shape for each hand, name it, and select Save and use. Edit pose and Delete pose change it later.
Your own animations
Under Your animations you can import a .vrma file (VRM Animation, up to 30 MB). It works on both VRM and MMD models. Make one in Blender with the VRM Add-on, or download one where the licence allows it. MMD motion files (.vmd) and .fbx files are not supported directly.
After importing, choose what the animation is for under Use it as: Idle fidget, One of her gestures, Only when I play it, While she talks, or Full-body animation (dance, walk…). Select Play on the preview to see it. A full-body animation marked as a dance may be chosen when you ask her to dance. Hold a frame as her pose turns one moment of an animation into a pose.
Photo mode and selfies from the 3D model
When she is on screen and you are not in a call, a camera button on her opens Photo mode. Drag to turn her and scroll to zoom. You can change the Pose, the Expression, whether she looks at the camera, the Background (Plain, Transparent, or a picture), and an Animation frame to freeze. Take photo saves the shot to your Gallery, where it is labelled 3D photo.
Make it a real photo asks the image model to redraw the shot, with an optional scene description. It needs an image model that accepts a reference picture: local FLUX.2 klein, Google, or OpenAI. It does not work with SDXL, with a provider that only does text, or in Offline Mode with a local model that cannot take a reference. It also needs an active license. A redrawn shot is labelled 3D photo, made real.
Her selfies can copy her face from the portrait or from the 3D model. Open Settings → 3D Avatar → Selfies and choose Selfie reference: Her portrait, Her 3D model, or Both.
- Her 3D model renders her as she looks on screen right now. If the avatar is not on screen, or the active image model cannot use a reference picture, her portrait is used instead.
- The setting Use it for life and shared photos too also uses the 3D model for photos from her day and for her half of a photo with you. Off keeps her portrait there, which composes better into a new scene.
Windows and macOS
The 3D avatar works the same way on both. The only visible differences are the names of a few poses, such as Cat-paws pose on macOS and Cat paws on Windows.