diff --git a/SourceAssets/Models/Heroes/README.md b/SourceAssets/Models/Heroes/README.md index fa0027a..da45716 100644 --- a/SourceAssets/Models/Heroes/README.md +++ b/SourceAssets/Models/Heroes/README.md @@ -1,44 +1,44 @@ -# Magnetic knight candidate +# 자력 기사 모델 후보 -This is a model review candidate. It is not connected to a prefab, scene, stage, -collider, input target or game state. User model/material approval precedes game -adoption. No Unity import or Android appearance/selection pass is claimed here. +사용자 모델·재질 검토를 위한 후보이며 아직 게임에 채택하지 않았다. +프리팹·씬·스테이지·콜라이더·입력 대상·게임 상태에 연결하지 않았고, +Unity 가져오기나 Android 표현·선택 검사를 통과했다고 주장하지 않는다. +게임 적용은 사용자 모델·재질 승인 이후에 진행한다. -`MagneticKnight.blend` contains separately named editable collections for the -one-meter spherical body, knight equipment, existing-face preview, thin ribbon -preview, and render studio. The face atlas is packed unchanged for portability. -The review face and ribbon are excluded from the FBX exports; retain the game's -six-expression SpriteRenderer and existing animated light ribbon during later -integration. There is no new face, head, arm, leg, rig or animation. +`MagneticKnight.blend`에는 지름 1m 구 몸체, 기사 장비, 기존 얼굴 미리보기, +얇은 리본 미리보기, 렌더 스튜디오가 각각 이름 붙은 편집 가능한 컬렉션으로 +분리되어 있다. 기존 얼굴 atlas는 바이트 변경 없이 원본에 패킹했다. +얼굴·리본 미리보기는 FBX에서 제외했으므로 후속 게임 적용에서는 기존 +6표정 SpriteRenderer와 움직이는 빛 리본을 유지한다. 새 얼굴·머리·팔·다리· +리깅·애니메이션은 만들지 않았다. -`HeroBody.fbx` has a body-centered pivot and radius 0.5 meters. `KnightEquipment.fbx` -has the same attachment origin and contains named meshes for the open helmet, -short rounded toy sword, and layered round magnet-emblem shield. Object scales -are applied. Authoring is Z up in meters; exports use -Z forward / Y up without -animation. Preserve the imported axis transform when creating the later wrapper. -The existing SphereCollider radius 0.5, root scale 1, and ball IDs remain owned by -the existing game. Equipment must stay visual-only, without colliders or input -targets. The equipment is a GroupBadge candidate for one representative per group. +`HeroBody.fbx`의 피벗은 몸체 중심이며 반지름은 0.5m다. +`KnightEquipment.fbx`는 같은 부착 기준 원점을 사용하고 열린 투구, +짧고 끝이 둥근 장난감 칼, 자석 문양의 둥근 다층 방패를 이름별 메시로 담는다. +배율을 적용하여 오브젝트 scale은 1이다. 원본은 m·Z-up이며 내보내기는 +-Z forward·Y-up, 애니메이션 없음이다. 후속 wrapper를 만들 때 가져온 +축 변환을 보존한다. 기존 SphereCollider 반지름 0.5, 루트 배율 1과 구 ID는 +기존 게임이 소유한다. 장비는 콜라이더·입력 대상 없는 시각 장식으로 유지하고, +묶음별 대표 구 한 개의 GroupBadge에 부착할 후보로 취급한다. -The opaque export materials use uniform portable base colors, roughness and -metallic values, with no procedural texture or Blender-only shader dependency. -Their exact values are in `provenance.json`. The body is smooth with welded poles -and no geometric seam. Helmet details follow its shell, and sword/shield stay -beside the open eye-and-mouth area. Verify numbers, selection highlights, crowded -groups and camera-facing behavior in Unity after approval; Blender shots alone -do not prove those gameplay checks. +내보낸 불투명 재질은 균일한 base color·roughness·metallic 값만 사용하며 +절차적 텍스처나 Blender 전용 셰이더에 의존하지 않는다. 정확한 값은 +`provenance.json`에 기록했다. 몸체는 극점을 연결한 매끄러운 메시이며 +기하학적 이음새가 없다. 투구 세부 장식은 곡면을 따르고 칼·방패는 열린 +눈·입 영역의 양옆에 배치했다. 숫자·선택 강조·밀집한 묶음·카메라 추종은 +승인 후 Unity에서 확인해야 하며 Blender 렌더만으로 게임 검사를 대체하지 않는다. -Regeneration (from this worktree root, with the Blender execution owner): +재생성은 이 checkout 루트에서 Blender 실행 소유자와 순차 진행한다. +다른 PC에서는 설치된 Blender 실행 파일 위치를 사용한다. ```powershell -& 'C:/Program Files/Blender Foundation/Blender 5.2/blender.exe' --background --python tools/models/build_hero.py -- --review-dir 'C:/git/MagnetismHeroes/artifacts/verification/VisualUpgrade/ModelReview/Heroes' +& 'C:/Program Files/Blender Foundation/Blender 5.2/blender.exe' --background --python tools/models/build_hero.py -- --review-dir 'artifacts/verification/VisualUpgrade/ModelReview/Heroes' & 'C:/Program Files/Blender Foundation/Blender 5.2/blender.exe' --background --python tools/models/build_hero.py -- --verify-only ``` -The tool only writes the Heroes source/export folders and the specified review -folder. It does not run the initial scenery builder. Provenance includes the -actual Blender version, source/export bytes and SHA256, existing sprite records, -material values, source licensing, and review limits. `verification.json` records -the actual source reopen, body radius/scale/geometry gates and FBX reimport checks. -Unity-generated `.meta` files are deliberately absent from this candidate; the -later Unity import owner must create them after approval. +도구는 Heroes 원본·내보내기 폴더와 지정한 검토 폴더만 작성하며 초기 배경 +builder는 실행하지 않는다. 출처 기록에는 실제 Blender 버전, 원본·내보낸 +파일의 바이트 수와 SHA256, 기존 sprite rect, 재질 값, 사용 조건과 검수 범위를 +담았다. `verification.json`은 실제 원본 재열기, 몸체 반지름·배율·메시 검사와 +FBX 재가져오기 결과를 담는다. 후보에는 수동 작성한 `.meta`가 없다. +후속 Unity 가져오기 담당자가 승인 이후 Unity에서 생성해야 한다.