A 3D model pipeline, pushed by Gemini 4 Carbon
agent (cont.)
+0:51read_file{"Path":"~/work/lowmarch/docs/vroid.md"}
input
{ "Path": "~/work/lowmarch/docs/vroid.md" }result, 272 lines
Showing lines 1-271 of 271 1: # VRoid base models 2: 3: **Status (2026-11-09):** current. The files carry 57 expression shapes (2.14 exports) or 56 (older), not the 54 below. Licence terms were read by hand on 11-09: see "Licence, read 2026-11-09" below, which replaces the licence notes further down (led #1443). 4: 5: ## Licence, read 2026-11-09 6: 7: Read by hand from pixiv's own pages on 2026-11-09 (headless browser, no login). Page copies and text dumps are in 8: `~/citadel-render/workers/handoff/overnight-1109/lowmarch-prep/pages/`. This is a reading of the terms, not legal advice. 9: The English terms of use are a translation; pixiv says the Japanese original prevails. 10: 11: Sources, with the date each page gives: 12: - **[G]** VRoid Studio guidelines, edited 2023-12-21: <https://vroid.com/en/studio/guidelines> 13: - **[T]** VRoid Studio terms of use, revised 2026-06-24 (articles renumbered then): <https://policies.pixiv.net/en.html#vroidstudio> 14: - **[AZ]** "VRoidPreset_A - Z", the page the 2.14 samples point at, updated 2024-12-26: <https://vroid.pixiv.help/hc/en-us/articles/4402394424089> 15: - **[SC]** "Do VRoid Studio's sample models come with conditions of use?", undated: <https://vroid.pixiv.help/hc/en-us/articles/4402614652569> 16: - **[F]** FAQ "Can I use the models created with VRoid Studio Stable Ver. for commercial purposes?": <https://vroid.pixiv.help/hc/en-us/articles/4405813333657> 17: - **[β1 to β4]** <https://vroid.pixiv.help/hc/en-us/articles/360012381793>, `.../360014900273`, `.../360014900113`, `.../360014900233` 18: - **[SF]** Sakurada Fumiriya <https://vroid.pixiv.help/hc/en-us/articles/360014788554>; **[SS]** Sendagaya Shino <https://vroid.pixiv.help/hc/en-us/articles/360013482714> 19: - **[H]** VRoid Hub terms <https://policies.pixiv.net/en.html#vroidhub>, and the official VRoid Project account's model licences 20: (read from `hub.vroid.com/api/character_models/<id>`, the same JSON the model page shows) 21: 22: ### What we hold, and whose terms apply 23: 24: | Our folder | What it is | pixiv's terms | 25: |---|---|---| 26: | `avatarsample_d` to `_g` (OpenGameArt) | Not the 2.14 D to G. They are β Ver AvatarSample_1 to 4: Sendagaya Shibu, Vivi, Vita, Victoria Rubin (file titles match the Japanese β pages) | CC0 [β1 to β4]. The official Hub copy of β1 also allows everything, credit unnecessary [H] | 27: | `sakurada_fumiriya`, `sendagaya_shino` | VRoid's mascots | CC0 [SF] [SS]. Official Hub copies allow everything, credit unnecessary [H] | 28: | `hairsample_male`, `hairsample_female` | alpha-era hair samples | CC0 [SC] | 29: | `base_male`, `base_female` (OpenGameArt) | alpha-era bases, Studio 0.14 exports | **Unclear.** [SC] lists "Base models" under CC0, as a picture of the 2021 bases. [G] says "All content provided by pixiv, including the base models when creating a new avatar, is not CC0." Either way [T] Art. 13 licenses them for any purpose | 30: | `samples_2_14/avatarsample_a` to `_z` | VRoidPreset A to Z, from Studio 2.14 | [AZ]: not CC0, any use, no credit, a list of prohibited acts (below) | 31: | `lowmarch_bodies/base_masc`, `base_fem` | Studio 2.14 new-model bases | Provided Content under [T] Art. 13: any purpose, not CC0 [G] | 32: | `faces/face_sexy.vrm`, our armory bodies | our own outputs | Ours, except the pixiv content inside them, which keeps its own terms [T] Art. 11 | 33: 34: The armory bodies are built on `base_masc`/`base_fem` with A to Z faces and hair, so [T] and [AZ] are the terms that 35: matter for them. 36: 37: ### 1. A character made in VRoid Studio from scratch 38: 39: Allowed: ship it in a game, sell the game, show it on a public page, post renders on a public blog, change it in code. 40: - Rights: "The copyright and other rights for textures and hair meshes you created from scratch on VRoid Studio or other 41: tools belong to you, the creator." The body and clothing meshes and presets are pixiv's, licensed "so that you can use 42: it for as wide a range of purposes as possible." [G] 43: - Licence: pixiv grants "a non-exclusive, perpetual, worldwide, non-transferable, non-sublicensable license to use, 44: duplicate, archive, modify, and display Provided Content ... for (1) any purpose and (2) any use, except where 45: different license conditions are specified and displayed for individual items" [T] Art. 13. 46: - Games, sale, web pages, renders: "You can use images and videos of models created with VRoid Studio and generate 47: profit from videos, books, ... games, applications, software, collections of materials, websites" and "You can sell 48: the model data exported from VRoid Studio." [G] 49: - Changing it in code: "You can edit and use the model data exported from VRoid Studio using software other than VRoid 50: Studio." [G] 51: - Limits: items with their own clause keep it ("When using items that display special licensing terms, please observe 52: those specific terms" [G]); nothing may suggest pixiv backs it ("refrain from creating any publication or video 53: production that leads people to believe it was created in collaboration with VRoid Studio or pixiv Inc." [G]); and 54: the character-creator rule in 3. 55: 56: ### 2. The sample avatars 57: 58: - **β 1 to 4 (our old D to G), Sakurada Fumiriya, Sendagaya Shino:** all of the above, with no conditions. "The CC 59: license* for this model is CC0. This model can be edited and used freely." [β1] [SF] [SS] 60: - **A to Z (2.14):** game, sale, public page, blog renders and code changes are allowed. "This model's .vroid and VRM 61: files can be used by anyone in any kind of activity, be it for-profit or not." Examples given: "Edit its texture and 62: parameters, and create an original 3D character" and "Edit its texture and parameters, upload it to BOOTH for sale to 63: others." [AZ] Prohibited, among others [AZ]: 64: - "Distributing a sample model or its VRM file to a third party by setting the 'Redistribution and alteration' 65: conditions of use to 'Copyright Disclaimer (CC0)'." 66: - "Development of a character creation service using data contained in the sample model, or diversion of data 67: contained in the sample model to an existing character creation service." 68: - "Redistributing the .vroid or VRM file of the sample model (or other data such as image data within the model) in 69: exchange for a fee." 70: - "Acts that can lure people into thinking that the Company supports or recommends some product/event." 71: - pixiv may narrow the terms later: "it's possible that the conditions of use may be limited if there are incidents". 72: - **Unclear:** whether a paid game that ships a sample's textures unedited (our faces keep each sample's iris, 73: highlight, brow and eyeline drawings as they are) counts as redistributing "image data within the model" for a fee. 74: Edited and sold is allowed; how much editing is enough isn't said. 75: - **Metadata against the page:** for our use, pixiv's page wins. The licence fields in our 2.14 exports 76: (`Redistribution_Prohibited`, `OnlyAuthor`, commercial `Disallow`) were set at our export, not by pixiv: "Users will 77: be licensed to set licenses freely for VRM data constituting Output Items, as long as they do not breach the license 78: conditions for Provided Content" [T] Art. 12. They bind whoever receives our file, not us. pixiv's own terms for its 79: items apply to us: "Where the Company has specified and displayed license conditions for individual items of Provided 80: Content, Users will use such Provided Content in accordance therewith" [T] Art. 13. No page states a precedence rule 81: in so many words; this is a reading of those two articles. The OpenGameArt files carry pixiv's own metadata (a VRoid 82: Hub licence allowing everything, or CC0), which agrees with the pages. 83: - If we ever hand out VRM files built on A to Z, their licence field must not be CC0 [AZ]. 84: 85: ### 3. A player-facing character creator 86: 87: Confirmed: it needs a separate licence from pixiv, and pixiv may refuse. 88: - "Users are not licensed to use Provided Content, or 3D models or Output Items containing Provided Content, to create 89: applications having functions that allow avatars, items, or other 3D models to be created by deforming meshes or 90: combining meshes or textures. When a User wishes to create an application containing such a function, they must 91: receive a separate license from the Company; provided, however, that this does not apply when the User is creating 92: the application for personal use." [T] Art. 13; also a prohibited act in [T] Art. 7. 93: - "Please contact us if you'd like an application creation license. It's possible that we may decline granting you a 94: license." [G] [F] 95: - [AZ] prohibits a creator built on A to Z data outright and names no licence route. 96: - So our own build tools are fine (personal use), and baked characters in a game are fine. A creator in the game, built 97: on anything from Studio 2.x or A to Z, needs pixiv's licence. 98: - **Unclear:** whether CC0 parts alone (β 1 to 4, the mascots, the hair samples) would escape this. CC0 waives 99: copyright, but [T] is a contract we agreed to by using Studio, and our exports pass through it. Not settled by the 100: pages. 101: 102: ### 4. Credit lines 103: 104: None required. 105: - A to Z: "There is no need to credit the original creator when using this sample model." [AZ] 106: - CC0 models: "Copyright is waived, and there is no particular limit when using them." [β1] 107: - Official VRoid Hub copies: `credit: unnecessary` [H]. 108: - Studio outputs: [G] and [T] ask for none (none found). [G] asks only that nothing implies pixiv's backing, and notes 109: "VRoid is a trademark or registered trademark of pixiv Inc." 110: 111: ### Superseded 112: 113: The licence notes further down (the table's "Licence in the file", the yomox9 D to Z note, "That page is behind a 114: Cloudflare check and wasn't read") predate this read. Where they differ, this section holds. 115: 116: Since 2026-10-08 our portraits (and later battle sprites) are rendered from VRoid sample models 117: through our own pipeline. VRoid supplies a professionally built anime head, hair, body, skeleton and 118: 54 expression shapes. Pose, archetype reshaping, hair swaps, colours, shading, outlines and the 119: reduction to GBA pixels are ours. 120: 121: ## Where they live 122: 123: `~/.local/share/lowmarch/vroid/<name>/*.vrm` (override with `LOWMARCH_VROID`). They are 11–17 MB 124: each and stay out of the repo. Source: <https://opengameart.org/content/vroid-studio-cc0-models>. 125: 126: | Model | Licence in the file | 127: |---|---| 128: | Base_Male, Base_Female, HairSample_Male, HairSample_Female | CC0 | 129: | AvatarSample D–G, Sakurada Fumiriya, Sendagaya Shino | VRoid Hub licence: everyone, commercial use allowed, modification allowed, redistribution allowed, credit unnecessary | 130: 131: The last two are VRoid's mascot characters. Use their parts (hair), not their look. Our characters 132: are built from the CC0 bodies. 133: 134: **AvatarSample A–Z (researched 2026-10-09):** exported by `tools/winvroid` into `samples_2_14/avatarsample_<x>/` (apart from the older D–G above, which are other characters). 135: All 26 were exported on 2026-10-10 (VRM 0.0, VRoid Studio 2.14, 15 to 22 MB each). They are clothed 136: exports, so VRoid has deleted the body skin under their clothes: use their heads and hair, not their bodies. 137: 138: **VRoid's own bases, unclothed (2026-10-10):** `lowmarch_bodies/base_masc.vrm` and `base_fem.vrm`: a new 139: character from the Masc or Fem base at default settings, every outfit category set to none, exported as 140: VRM 0.0 (`python3 tools/winvroid/winvroid.py bases`). They keep all their skin (10,934 body triangles; 141: the old `base_male/Base_Male.vrm` export has 7,340). The briefs and band are painted on the skin texture, 142: not geometry. `tools/mass.py` builds on `base_masc.vrm`. 143: VRoid Studio 2.1.0 and later ship 26 144: sample avatars. The VRoid Project account on VRoid Hub publishes A–C with VRoid Hub's licence: 145: - everyone may use them; 146: - corporate commercial use is allowed; 147: - modification and redistribution are allowed; 148: - no credit is needed. 149: 150: D–Z are on VRoid Hub only as exports by another user (yomox9, character 2175138617022572467). Their 151: files carry the same terms in VRM 1.0 metadata (`commercialUsage: corporation`, 152: `allowModificationRedistribution`, credit unnecessary), pointing at pixiv's "AvatarSample A-Z" help page. 153: That page is behind a Cloudflare check and wasn't read. Take them from VRoid Studio itself, or the 154: official account where it has them. 155: 156: What the set offers: 157: - about 9 male and 17 female faces, all young and slim, two of them adult men (T, V); 158: - different eye drawings, hair and outfits. 159: 160: **VRoid Studio's guidelines** (vroid.com/en/studio/guidelines, read 2026-10-09): 161: - **Allowed:** models made in VRoid Studio may be sold, edited in other software, and used in games. 162: - **Restricted:** "You cannot create an application that can generate or output 3D models, avatars, 163: or items consisting of deformed or combined meshes and textures that were created in VRoid Studio" 164: without a separate licence from pixiv. Tools meant only for your own use are exempt. 165: - **For us:** our build pipeline (the graft, the costume kit) is for our own use, and shipping baked 166: characters in the game is fine. A player-facing character creator built on VRoid parts would need 167: pixiv's licence. 168: 169: ## Heads (`tools/heads.py`, 2026-10-13) 170: 171: The armory's bodies all wore VRoid's base face. A head is now one of the 26 samples' faces on our base: 172: - **One template:** every VRoid face mesh has the same skin, eye-white and mouth triangles and texture coordinates 173: (4,232 skin triangles in each), so a face moves vertex for vertex. The irises, highlights, brows and eyelines are 174: each sample's own geometry: that is where its eye drawing lives, and it comes along whole. 175: - **Only the face is taken:** eyes, nose, mouth, cheeks and jaw, fading out up the forehead, toward the ears and toward 176: the seam with the body. VRoid's face mesh is the head's front; the back of the skull is in the body mesh, and the 177: seam between them runs from the neck to the crown. Taking a sample's whole front set its skull against the base's 178: back, and VRoid's hair base (the short cap) couldn't sit on both. The base's skull, ears, seam and cap stay. 179: - **Also taken:** the sample's 57 expressions (the same names, in the same order, in every model), its skin weights 180: mapped by bone name, its eye bones (so the eyes turn about their own centres), and its eye, brow, eyeline and mouth 181: materials. The face skin keeps the base's texture, so the skin tone matches the body. 182: - **Sculpted in the file:** the face controls of `tools/vroid_portrait.py` (lower-face length, jaw, chin, cheek, brow 183: ridge, nose, eye size and tilt, iris, mouth), with one rule for the face and the neck so the seam holds. The checks 184: then measure the face that is shown. 185: - **Blends:** a face spec's `sample` may be several samples with weights; the face's shape is their weighted mean 186: (one template, so a blend stays coherent from every angle) and the first gives the eye drawing and expressions. 187: - **Not fitted (2026-10-13):** `heads.fitted` can move the lower face's length, the cheeks and the eye size until a 188: face archetype's ratios pass (`docs/proportions.md`), but the armory doesn't use it. Those ratios were measured on 189: the study's paintings, mostly seen from the front; held to them, faces were stretched (lower faces up to 17% 190: longer, eyes 20% larger) and read too sharp from the side and too wide from the front. VRoid's faces all set the 191: eyes low (0.56 to 0.64 of the head down from the crown), the young look; the study's adults have them at 0.40 to 192: 0.58. The armory's faces are VRoid's as built, chosen and blended by look, and the ratios are reported. 193: - **Then the cage** (`tools/cage.py`, a spec's `face`) builds the body on the headed base and sizes the head to its 194: reference's, so head size stays held in metres. 195: 196: What the face rests in (a frown, half-closed eyes) and age lines are drawn when the figure is built, not in the file. 197: 198: ## Tools 199: 200: - `tools/vrm.py`: VRM/glTF loader (meshes, materials, textures, morph targets, skins) and a numpy 201: z-buffer rasterizer with alpha testing. 202: - `tools/vroid_portrait.py`: `Portrait(model, morphs, pose, shape, hair_from)` and `.render(yaw)` 203: give a 96×80 char grid; `image(char, palette=...)` gives a PNG; `smooth_view()` shows the 3D model. 204: - `tools/outfit.py`: costume pieces generated in code and fitted to the posed body (`COSTUMES`). 205: - `art/cast/cast.py`: one entry per character (base model, hair donor, shape controls, colours, costume). 206: 207: ## Notes 208: 209: - VRoid models face −z; `FLIP` turns them toward the camera. Character's left is −x. 210: - They stand in a T-pose. `BUST_POSE` lowers the arms through linear blend skinning. 211: - Expression names end in `Fcl_EYE_Close`, `Fcl_MTH_A`, `Fcl_ALL_Joy` and so on; match the suffix 212: exactly (`_Close` also prefixes `_Close_L`). 213: - The eyeline texture is a thick graded band over the iris. Only texels darker than `LID_CORE` 214: count as the lash line, or the eyes read as half shut at 1×. 215: 216: ## Review tooling 217: 218: `python3 review/vroid-02/build.py aldric` builds the model viewer: `bust`/`battle` GLB models 219: (`tools/export_glb.py`), pixel frames every 15°, and `camera.json` so the three.js orthographic 220: camera matches the pixel camera exactly. `tools/poses.py` holds poses (BUST, BATTLE_IDLE, `fist`), 221: `tools/terrain.py` holds battle ground (`plains`). 222: 223: ## Hair (`tools/heads.py`, 2026-10-13) 224: 225: A head spec's `hair` names a sample whose hairstyle goes on. Every VRoid head matches point for point (the face skin, 226: and the 562 vertices of skull in the body mesh, by texture coordinates), so the style is warped from its sample's 227: head onto ours (a similarity plus the matched points' residuals spread by inverse distance) and held 1.5 mm off the 228: skin. It keeps its hair base (HairBack), which replaces the base's; its hair bones (only those its mesh moves with: 229: the samples' skins list accessory ears too, and the weightless end bones that say where a lock's last bone points); 230: its spring groups; and its head's collision sphere, warped onto our head. `tools/cage.py` scales the head's sphere 231: and the hair's spring radius with the head. Hair colour is the character's. 232: 233: **Collision (`tools/collide.py`, 2026-10-13).** Spring bones collide only with spheres the model carries 234: (`secondaryAnimation.colliderGroups`); every runtime that plays a VRM (UniVRM, three-vrm, the review page) runs 235: those and nothing else, so what the hair can't pass through is set here, not by the engine. The samples' body 236: spheres were sized for VRoid's slim sample bodies, with none over the back or bust, and v11's hair sank up to 237: 6 cm into our bodies' upper backs, shoulders and napes. Now, on each finished body, `tools/cage.py` calls 238: `collide.hair`: 239: - **Spheres fitted to the skin:** medial balls (each touching the skin at a point, as large as fits inside), chosen 240: greedily until all the skin the hair can reach (within a lock's length below its joints; the shoulders and upper 241: arms whole once the hair reaches them) stands within 1 cm of one. Each rides the bone most of its skin is 242: weighted to, the breasts' spring bones included. They stand 2 cm out from the skin: a lock's bone runs down its 243: middle, and VRoid's locks stand a median 2.3 cm round it, so a bone held at the skin left the lock in it. That 244: comes to 30 to 60 spheres per body. 245: - **The hair draped at rest:** each lock's bones, root to tip, keep their own way unless the body is in it. A bone 246: is turned until its whole length (not only its tail: the body bulges between two joints) is out of the spheres 247: and the mesh it carries stands off the skin, and what no turn can lift (points the head carries) is pushed off. 248: That is the bind pose, so the hair starts where it rests, not inside the body. 249: - **The check:** `tools/hair_check.py` replays the page's spring bones (Still, Twist, Bounce; arms out or down) and 250: counts hair vertices inside the skin. 251: 252: ## Designing faces in VRoid Studio (first session, 2026-10-13) 253: 254: - **The face editor** (Face tab) has 89 sliders: eye size, position and slant, eyelids, droopy and scornful eyes, 255: iris size, brows, nose, mouth and lips, teeth, ears, jaw, chin and cheeks, and masculine and feminine blends of 256: each feature. Its **Face Sets** are presets that set many sliders and textures at once (eye, lash and brow 257: drawings, lips, blush). Several read more adult than any of the 26 samples. 258: - **The sliders are subtle:** a step of 0.2 to 0.3 barely shows at full-head zoom. Presets move the face far more. 259: - **A face made there transplants like a sample:** export it (`winvroid.export_vrm`) to `faces/` under 260: `LOWMARCH_VROID`, and name it in a head spec (`cast._head(face="faces/....vrm", makeup=True)`; `makeup` keeps its 261: lips, blush and eye shadow, which live on the face's skin texture). 262: - **First result:** one face, the sexy woman's, from preset 11 (lashes, almond eyes, fuller lips) with a longer chin, 263: sunken cheeks, heavier lids and upturned corners. In the painted renderer its glossy eyes and blush read cuter, 264: not sultrier, so it was kept aside (`faces/face_sexy.vrm`). Next time: start from a narrower-eyed preset (3 or 5) 265: and change the iris to one with small highlights. 266: - **The driver** (`tools/winvroid`): the parameter panel scrolls smoothly and is long (89 rows), so a row search 267: waits for it to settle and scrolls 140 ticks to the top. A notification toast took the foreground from VRoid 268: repeatedly and Windows refused to give it back; `front()` now falls back to a real click on VRoid's own title bar, 269: checked to be VRoid's window. **That change stopped the session:** it rebuilt the driver's helper DLL (V.dll), and 270: Windows' application control ("An Application Control policy has blocked this file") refuses to load the new, 271: unsigned build. The PC's owner has to allow it before the driver works again.