| name | texture-packer |
| description | Flutter Flame(flame_texturepacker) 게임을 위한 3D 모델(FBX/GLB/glTF/.blend)을 16방향(기본) sprite frame 으로 Blender 렌더한 뒤 libGDX TexturePacker 로 packed atlas(assets/<kind>/<name>/<name>.png + .atlas)로 묶는 texture-packing 파이프라인. 모든 셀 128px 고정, color compression(256색)·color brightness(밝기·대비)·EEVEE shading 을 기본 자동 적용(각각 옵션으로 끔), --output 으로 결과 폴더 지정 시 <output>/<kind>/<name>/ 자동 저장. 다음 경우 사용 — (1) "pc/mob/npc 를 texture packing 해줘", "sprite sheet 를 atlas 로 패킹", "packed atlas 생성", (2) 캐릭터/몬스터/NPC sprite 를 Flame atlas 로 굽기(sheet.py), (3) 기존 kind 재생성·교체, (4) 행동별 프레임 수(idle/walk/attack/hit/death/run·npc look/talk/wave) 조정, (5) grid 단일 sheet(--texture-pack false), (6) 결과를 뷰어/다른 앱 폴더에 저장(--output ./viewer/assets), (7) TexturePacker·발 정렬(align_feet)·256색 압축·pubspec 자동 갱신 이해/디버깅. sheet.py 등 packing 코드 전체를 소유. 키워드 — texture packing, texture-packer, packed atlas, sprite sheet packing, gdx TexturePacker, sheet.py, flame_texturepacker, pc/mob/npc packing, 16방향 아틀라스, .atlas, align_feet, 통짜 grid sheet, --output. |
| metadata | {"author":"laryen","version":"2.0"} |
texture-packer — Flutter Flame sprite packing
Flutter Flame(flame_texturepacker) 게임을 위해 캐릭터·몬스터·NPC 의 3D 모델을
16방향 sprite frame → packed atlas 로 굽는 파이프라인 전체(scripts/)를 소유하는 스킬.
"pc/mob/npc 를 texture packing 해줘" 요청을 이 스킬의 scripts/sheet.py 로 자율 수행한다.
라리엔에서 출발했지만 특정 게임에 묶이지 않고 Flame 을 쓰는 모든 프로젝트에서 동작한다
(pubspec.yaml 이 있는 프로젝트 루트를 자동 탐색).
이 스킬이 소유한 코드 (모두 scripts/ 안)
| 파일 | 역할 |
|---|
scripts/sheet.py | 메인 CLI(macOS). 렌더→packing→압축→pubspec 갱신 전 과정 오케스트레이션 |
scripts/_sheet_render.py | Blender(-b -P)로 FBX/GLB/.blend → 방향별 frame PNG 렌더(EEVEE·밝기 부스트) |
scripts/_sheet_build.py | --texture-pack false 시 균일 grid 단일 sheet 빌드 |
scripts/align_feet.py | 프레임의 발(불투명 bbox 하단)을 셀 0.85 에 정렬(행동 전환 상하 점프 방지) |
scripts/verify_cells.py | cell 잘림(clip) 자동 검사 — 낱장 프레임 4 테두리 불투명 픽셀로 셀 밖 잘림 판정 + 행동별 권장 --scale-<action>(flutter 실행 불필요) |
scripts/check_all_cells.sh | 배치 cell 잘림 검사 — 여러 자산(game-assets/characters/*.blend 등)을 한 번에 렌더·검사해 자산별 잘림 프로파일 표로 요약(빠른 전체 스캔·최소 프레임, 정밀은 실제 프레임 수로 개별 실행) |
scripts/sheet-win.py | Windows 형제(빌드). sheet.py 와 동일 보조 스크립트 공유 |
scripts/sheet-preview.py | 4방향 preview(macOS+Windows 공용). sheet.py 설정 재사용 + Windows Blender/Python 탐지 |
scripts/combine_to_runtime_sheet.py | 행동별 256 sheet → 런타임 128 단일 16×60 sheet 합성(legacy) |
scripts/gen_all_sheets.sh | 보유 PC/몬스터 모델 일괄 생성 헬퍼 |
scripts/tools/*.jar | libGDX TexturePacker(gdx 1.13.1) — 없으면 sheet.py 가 Maven 에서 자동 다운로드 캐시 |
🛑 compress_image.py 는 이 스킬 소유가 아니다. 범용 PNG 압축 도구라 프로젝트
scripts/compress_image.py 에 남아 있고, sheet.py 는 ROOT/scripts/compress_image.py 를
참조한다. 이 스킬 scripts/ 로 옮기지 않는다.
핵심: 어디서 실행해도 프로젝트 루트를 자동으로 찾는다
이 스킬의 스크립트는 .claude/skills/texture-packer/scripts/ 에 있지만, 산출물은 프로젝트
루트의 assets/·pubspec.yaml 을 대상으로 한다. sheet.py 등은 _find_project_root()
로 루트를 견고하게 탐색한다 — ① 환경변수 LARYEN_ROOT(pubspec.yaml 검증)로 명시 override
→ ② skill 위치 기준 4단계 상위(scripts→texture-packer→skills→.claude→루트) → ③
git rev-parse --show-toplevel → ④ cwd. 따라서 cwd 와 무관하게 절대 경로로 실행하면 된다.
다른 프로젝트에서 쓰려면 그 프로젝트에 이 skill 을 두거나 LARYEN_ROOT=<프로젝트루트> 를 준다.
기본 정책 (2.0 — 4가지 자동 적용)
신규 packing 은 아래를 기본 자동 적용한다. 각각 옵션으로 끌 수 있다.
| 자동 적용 | 기본값 | 끄는 법 |
|---|
| 모든 셀 128px 고정 | --cell-size 128 (pc/mob/npc 전부) | (변경 비권장) --cell-size N 으로 다른 값 지정 가능 |
| color compression — 256색 FASTOCTREE 양자화(번들 용량 절감) | --color-compression true | --color-compression false (무손실 RGBA) |
| color brightness — exposure+gamma 밝기·대비 부스트 | --vivid 9 (1~9) | --vivid 1 (무보정) |
| shading EEVEE — PBR 3점 조명 렌더 | --shading eevee | --shading texture (WORKBENCH TEXTURE) |
왜 128 고정인가: 게임 표시 크기(display 128)와 1:1 이라 축소 렌더가 없어 화질 손실이
거의 없고, atlas page 픽셀이 작아져 iOS 등에서 actor atlas RAM(OOM 위험)을 직접 낮춘다.
RAM 은 W×H×4 로 고정 — 메모리 절감은 셀 픽셀(cell-size)로만, 디스크 절감은 색 압축으로만.
표준 워크플로우 (pc/mob/npc packing)
1. 실행 — kind 별 모델 폴더
🚀 가장 쉬운 사용법 — 경로만 준다 (2026-07-28)
python3 .claude/skills/texture-packer/scripts/sheet.py ./game-assets/characters/mob/chassis/chassis.blend
경로에 이미 정보가 다 들어 있으므로 kind·name·애니메이션·--auto 를 자동으로 채운다.
--kind mob --name chassis --animations … --auto 를 매번 적을 필요가 없다.
- 모델 형식 —
.blend · .fbx · .glb · .gltf 모두 된다(확장자로 import 자동 분기).
예: NPC 5종은 .fbx 모델이다.
- kind·name 추론 —
characters/<kind>/<name>/<name>.<ext> → 그 kind·name.
pc 만 성별 단계가 하나 더 있다: characters/pc/<gender>/<name>/<name>.<ext>.
구 폴더명 blend/ 도 하위호환으로 받는다(2026-07-28 characters/ 로 개명).
name 은 파일명이 아니라 폴더명(폴더가 자산의 단위이고 애니도 그 폴더에 함께 놓인다).
구조를 못 알아보면 조용히 추측하지 않고 경고 후 기존 흐름(대화형·명시 옵션)으로 간다.
- 애니메이션 3단 우선순위
- 모델과 같은 폴더의
idle/walk/attack/death.fbx — 필요한 행동이 전부 있을 때만
(일부만 있으면 rig 가 섞여 팔 꺾임 회귀가 나므로 다음 순위로 넘어간다)
game-assets/animations/<name>/ — 캐릭터 전용 세트(현재 49개 존재)--animations 값 → 4. default
--auto 자동 — 경로만 준 단축 호출일 때만 켜진다. 개별 옵션을 주면 그 값이 이긴다.- 기존 방식(
--character + --kind + --name 명시)은 그대로 동작한다 — 추론이 개입하지 않는다.
--kind | 모델 소스 폴더 | 방향 · cell · 화면 크기 | 행동(col) 순서 |
|---|
pc | game-assets/characters/pc/<gender>/<name>/ | 16방향 · 128 · 128 | idle · walk · attack · death · run |
mob | game-assets/characters/mob/<name>/ | 16방향 · 128 · 128 | idle · walk · attack · death (run 기본 제외) |
npc | game-assets/characters/npc/<name>/ | 1방향(정면 S) · 128 · 128 | idle 단일(24프레임) |
boss | game-assets/characters/boss/<name>/ | 8방향 · 256 · 256(화면 2배) | mob 과 동일 |
minion | game-assets/characters/minion/<name>/ | 8방향 · 64 · 64(화면 절반) | mob 과 동일 |
🛑 hit(피격) 은 2026-07-20 에 제거됐다 — 게임에서 hit 포즈가 화면에 사실상 안 나오는데
(피격 플래시·파티클·사운드가 대체) atlas 만 키웠다. --hit N 옵션은 존재하지 않는다.
🛑 모델 소스 폴더는 GAME-ASSETS.md 가 SSOT(2026-07-27 canonical). 과거의
game-assets/characters·game-assets/monsters 는 존재하지 않는 경로다.
python3 .claude/skills/texture-packer/scripts/sheet.py ./game-assets/characters/pc/male/male_vector/male_vector.blend
python3 .claude/skills/texture-packer/scripts/sheet.py ./game-assets/characters/mob/chassis/chassis.blend
python3 .claude/skills/texture-packer/scripts/sheet.py ./game-assets/characters/boss/halucion_boss/halucion_boss.blend
python3 .claude/skills/texture-packer/scripts/sheet.py ./game-assets/characters/mob/chassis/chassis.blend \
--idle 8 --walk 12 --attack 16 --death 8
python3 .claude/skills/texture-packer/scripts/sheet.py --kind npc --name shopkeeper
python3 .claude/skills/texture-packer/scripts/sheet.py \
--kind mob --name chassis \
--character game-assets/characters/mob/chassis/chassis.blend --animations default --auto
- 인자를 전부 생략하면 터미널에서 순서대로 물어본다(대화형).
- 신규 PC·몬스터는 반드시 16방향(기본).
--directions 8 은 boss/minion 규격이거나 legacy 재생성 전용.
- 일괄 재생성은
scripts/regen_mobs.sh·regen_pc.sh·regen_npc.sh.
2. 출력 (기본: 프로젝트 루트의 assets/)
assets/<kind>/<name>/<name>.png # packed atlas 이미지 (256색 양자화)
assets/<kind>/<name>/<name>.atlas # flame_texturepacker 가 읽는 trim/rotate 메타
pubspec.yaml 의 관리 블록(# >>> AUTO(sheet.py packed actors) >>>)에 자동 등록된다.
--output — 결과 폴더 지정 (뷰어/다른 앱용)
--output <DIR> 을 주면 <DIR>/<kind>/<name>/ 을 자동 생성해 거기에 .png·.atlas 를 저장한다.
python3 .claude/skills/texture-packer/scripts/sheet.py \
--kind pc --name male_vector \
--character game-assets/characters/pc/male/male_vector/male_vector.blend --animations default \
--output ./viewer/assets
- 상대경로는 실행 위치(cwd)가 아니라 프로젝트 루트 기준으로 해석된다(결과 위치가 예측 가능).
- 🛑
--output 지정 시 루트 pubspec.yaml 자동 갱신은 건너뛴다 — 대상이 다른 앱/뷰어일 수
있어 루트 pubspec 을 오염시키지 않는다. 필요하면 대상 앱에 수동 등록한다.
- 중간 작업(frames) 폴더는
--outputs(복수형)로 따로 지정한다(이름 혼동 주의).
3. 게임 적용 & 검증
- 앱 재빌드 필요 — atlas 는 AssetManifest 스캔으로 감지되므로 hot reload/restart 로는
새 atlas 가 안 잡힌다.
ActorAnimationSet.loadActor(kind) 계열이 assets/<kind>/<name>/<name>.atlas
를 로드한다(프로젝트별 로더 규약을 따른다).
- atlas 없는 pc/mob 은 투명 placeholder(안 보임)로 처리될 수 있다(프로젝트 로더 정책에 따름).
- 시각 검증은 실제 Flame 앱에서 수행한다 — analyze/단위테스트로 갈음하지 않는다.
3.5 cell 잘림(clip) 방지 — 자동 검사·조정 워크플로우 (flutter 불필요)
pc/npc/mob 의 큰 모션(run/attack 등)이나 큰 자산(뿔·날개·무기)이 셀 밖으로 잘리는 것을,
flutter 실행 없이 생성 이미지 검사만으로 잡아 자동 조정한다:
- 전체 스캔 — 어떤 자산이 잘리나 한 번에(진행 표시·예상 시간):
bash scripts/check_all_cells.sh mob 'game-assets/characters/*.blend'
- 자동 조정 재생성 — 잘린 자산을
--auto-fit-scale 로:
sheet.py --kind mob --name <name> --character <file> --auto-fit-scale
🛑 --auto-fit-scale 을 켜면 --scale-<action>·전역 --scale 은 모두 무시 되고 1.0(원본)에서
시작해 auto-fit 이 필요한 만큼만 하강한다(대화형 scale 질문도 생략). scale 을 직접 지정하려면
--auto-fit-scale 없이 --scale-<action> 을 쓴다(둘은 배타적 사용).
- 개별 정밀 검사(선택):
sheet.py … --render-only(렌더 후 자동 검사) 또는
verify_cells.py --frames outputs/<name>/frames.
🛑 원리: 작게 구운 scale 은 .atlas 의 laryen.actionScale 메타로 기록돼 게임 런타임이
1/scale 로 원래 크기 복원 — 잘림 방지(작게 굽기)와 화면 크기(원래)가 분리된다.
난이도별 수렴(실측): 작은 잘림 1회 최소 하강 · 여러 행동 1회 · 큰 top 잘림 step 하강 여러 회
· 물리적 불가(여백 없음)만 0.6 하한 안전종료 + margin 조정 안내(상세 references/pipeline.md §9).
| 옵션 | 기본 | 뜻 |
|---|
--output DIR | (없음→assets/) | 결과 저장 베이스 폴더. <DIR>/<kind>/<name>/ 자동 생성(pubspec 갱신 생략) |
--texture-pack {true|false} | true | true=packed atlas, false=grid 단일 sheet(_sheet_build.py) |
--cell-size N | 128 | atlas orig/cell 픽셀(pc/mob/npc 전부 128 고정) |
--color-compression {true|false} | true | 256색 FASTOCTREE 양자화(디스크만 절감, RAM 무관) |
--vivid 1-9 | 9 | 밝기(exposure)+대비(gamma) 부스트. 1=무보정, 9=최대(기본) |
--shading {eevee|texture} | eevee | eevee=PBR 3점 조명, texture=WORKBENCH TEXTURE(금속/갑옷용) |
--render-res N | max(256,cell) | frame 렌더 해상도(→ 128 로 자동 축소, --scale-frames) |
--idle/--walk/--attack/--death/--run N | 8/12/16/8/12 | 행동별 프레임 수. 🛑 --hit 은 없다 — hit 는 2026-07-20 규격에서 제거됐다(FRAME_OPTION_ACTIONS) |
--look/--talk/--wave N | 8 | npc 전용 행동 프레임 수 |
--scale-<action> | 미지정 시 대화형 질문(기본 제안 전부 1.0 — SCALE_PROMPT_DEFAULTS; 비대화형은 그 값 적용) | 행동별 생성 scale. <1 이면 모델을 작게 구워(무기/모션 128 셀 밖 잘림 방지) .atlas 의 laryen.actionScale.<action> 메타에 기록 → 게임 런타임이 1/scale 로 원래 크기 복원(references/pipeline.md §6). 🛑 과거의 walk 0.9 · attack 0.8 일괄 축소 프리셋은 폐기됐다(2026-07-09 셀 확대 전환) — 셀 확대는 atlas RAM(iOS OOM)·page 폭(8192 한계)을 키우므로 잘리지 않는 행동까지 무조건 키우지 않는다. 잘리는 행동만 --auto-fit-scale 이 검출해 낮춘다. 🛑 --auto-fit-scale 사용 시 이 값은 무시 됨(1.0 에서 자동 조정) |
--weapon / --weapon-bone … | — | 무기 손 본 장착 |
--directions {8|16} |
런타임: Flutter/Flame 이 .atlas/.png 를 파싱해 게임 월드에 표시
packing 결과물이 게임에서 로드·렌더되는 소비 측 흐름(전체 소스·복구 SSOT 는
references/flame-runtime.md):
assets/<cat>/<name>/<name>.{atlas,png} (cat=pc|mob)
① AssetManifest 스캔 → name→cat (hasActorAtlas) ← 앱 재빌드 필요(번들 시 고정)
② TexturePackerAtlas.load(path, useOriginalSize:true) ← flame_texturepacker 가 trim/rotate 복원
③ atlas.findSpritesByName('walk_E') → SpriteAnimation.spriteList(frames, stepTime, loop)
→ _table[state][dir16] (6 state × 16 dir)
④ MobComponent/PlayerComponent(=SpriteAnimationComponent):
animation = animSet.getDir16(state, facing16)
size = kActorDisplaySize × displayScaleFor(state) ← laryen.actionScale 메타 배율 복원
anchor = (0.5, 0.85); position = worldToScreen(서버 world cm) ← isometric 투영
핵심 규약(디버깅 시 이 값이 어긋나면 sprite 안 보임/깨짐):
- region 이름 =
<action>_<DIR16>(예 walk_E·attack_SSW) — packing 의 row/action 순서와
런타임 _atlasActions·kDir16Labels(FLARE16)가 동일 SSOT 여야 정합.
- atlas 추가/교체 후 앱 재빌드 필수 —
AssetManifest 는 빌드 시 번들되어 hot reload/restart
로 새 atlas 가 안 잡힌다.
- pc/mob 는 오직 atlas 에서만 로드(격자 폐기). 없으면 투명 placeholder +
missingAtlasKinds
리포트 → sheet.py 로 재생성.
- 화면 크기 =
kActorDisplaySize(128), 발 정렬 anchor (0.5,0.85), 행동 배율은 .atlas 의
laryen.actionScale.<action> 메타에서 자동 복원(1/생성scale).
관련 코드: actor_animation_set.dart
(loadActorAtlas·_buildAtlasTable·getDir16·parseDisplayScales) ·
mob_component.dart ·
iso_projection.dart.
실전 검증 예시 — flutter/(laryen_actor_viewer) 뷰어 앱으로 맵에 몹 띄우고 증명하기
이 리포에는 packing 결과를 바로 눈으로 확인하는 Flame 뷰어 앱 flutter/
(laryen_actor_viewer, flame 1.37 · flame_texturepacker 5.1)가 들어있다. sheet.py
로 구운 mob/pc atlas 를 이 앱 맵(잔디·도로·건물) 위에 스폰해 16방향·애니메이션·발
정렬을 실제로 검증한다. human-developer 가 "몬스터를 맵에 어떻게 띄워 확인하냐" 물으면
아래 순서를 그대로 안내한다. 아래는 dreyer.blend(망치 든 몬스터)로 실제 검증한 예다.
1) atlas 를 뷰어 앱 assets 폴더로 굽기 — --output ./flutter/assets
python3 .claude/skills/texture-packer/scripts/sheet.py \
--kind mob --name dreyer \
--character ./game-assets/mob/dreyer.blend --animations default \
--output ./flutter/assets \
--scale-attack .8
→ flutter/assets/mob/dreyer/dreyer.{png,atlas}(16방향 × idle8·walk12·attack16·hit8·
death8 = 832 프레임). dreyer 는 hand 본에 hammer(망치) 가 붙어있어 body-only
framing 이 자동 적용(무기 1개 제외)되고, --scale-attack .8 은 .atlas 에
laryen.actionScale.attack: 0.8 메타로 주입 → 런타임이 1/0.8=1.25 로 화면 보정한다.
2) 뷰어 앱 pubspec 등록 + kind 별 로드/스폰 코드
--output 저장은 루트 pubspec 만 건너뛴다. 대상은 뷰어 앱이므로 그 pubspec 에 수동 등록:
- assets/mob/hellion/
- assets/mob/dreyer/
lib/game/viewer_game.dart 가 kind 별 atlas 를 ActorAnimationSet.loadFrom(atlas,png)
로 읽어 _spawnWave() 에서 맵에 스폰한다. kind 당 1마리씩 띄우려면 애님셋을 kind
별로 따로 로드하고 스펙 리스트로 1마리씩 스폰한다(hellion 왼쪽·dreyer 오른쪽):
_hellionAnimSet = await ActorAnimationSet.loadFrom(
'assets/mob/hellion/hellion.atlas', 'assets/mob/hellion/hellion.png');
_dreyerAnimSet = await ActorAnimationSet.loadFrom(
'assets/mob/dreyer/dreyer.atlas', 'assets/mob/dreyer/dreyer.png');
// _spawnWave(): [(hellion,-240,40), (dreyer,240,40)] → kind 당 정확히 1마리
atlas 로드 실패(파일 없음/계약 불일치)면 그 kind 는 붉은 placeholder 로 뜬다 → sheet.py
재생성 신호. region 이름은 <action>_<DIR16> 규약이라 packing row 순서와 자동 정합한다.
3) 앱 실행 + 스크린샷으로 증명 (macOS)
cd flutter && flutter pub get
flutter run -d macos --debug
osascript -e 'tell application "System Events" to tell process "laryen_actor_viewer" to set frontmost to true'
osascript -e 'tell application "System Events" to tell process "laryen_actor_viewer" to get {position, size} of window 1'
screencapture -x -R "x,y,w,h" tmp/proof.png
앱이 뜨면 맵 위에서 PC(g)와 몹이 16방향 스프라이트로 걸어다니며 배틀한다. atlas 교체·
추가 후에는 hot reload 로 안 잡히므로 앱을 재실행(flutter run 종료 후 재실행 또는 Hot
restart)해야 새 atlas 가 번들된다. 코드 변경만이면 종료→재실행이 가장 확실하다.
⚠️ 색 압축은 프로젝트 루트의 scripts/compress_image.py 유무에 달려 있다
--color-compression true(기본)이면 sheet.py 가 _find_project_root() 로 찾은 루트의
scripts/compress_image.py 를 import 해 256색 양자화를 in-place 로 돌리고, import 가
실패하면 uv run --with numpy --with pillow 서브프로세스로 폴백한다.
- 그 파일이 있는 프로젝트(예: laryen)에서는 정상 동작한다 — 예전에 "이 리포엔 없어서
스킵된다" 고 적혀 있던 서술은 texture-packer 를 단독 clone 한 환경의 이야기였다.
- 판정은 파일 존재 여부를 추측하지 말고 로그로 한다 — 출력에
⚠️ 압축 실패 가 없으면
압축된 것이다.
- 없는 환경이면 256색 양자화가 스킵돼 무손실 RGBA PNG 가 그대로 남는다(디스크/번들만 커지고
atlas·게임 동작·RAM 엔 무관). 줄이려면 그 스크립트를 루트
scripts/ 에 두거나
pngquant --force 256 <파일>.png -o <파일>.png 로 후처리한다.
🛑 압축은 디스크만 줄인다. RAM 은 1바이트도 줄지 않는다(RAM ≈ 원본 PNG W × H × 4).
RAM 을 줄이는 길은 셀 크기·프레임 수·자산 종류를 줄이는 것뿐이다.
절대 규칙
- 신규 캐릭터/몬스터 sprite 는 16방향·128 cell 만. "8방향으로 만들어 달라"는 거절하고
16방향으로 안내한다(짝수 row 가 8방향과 동일하므로 8방향이 필요해도 16 한 장이면 됨).
- 🛑 예외 —
--kind boss · --kind minion 은 8방향이 규격이다(2026-07-27 사용자 지시로
신설). 보스는 소수 개체가 크게 등장하고 졸개는 다수가 작게 등장해, 둘 다 방향 해상도를
절반으로 줄여 디스크·RAM 을 아끼는 것이 의도된 설계다. 이 두 kind 를 16방향으로
"고쳐" 재생성하지 말 것 — 그것이 회귀다. minion 은 추가로 cell 64 · 화면 표시 64
(다른 몹의 절반 크기)가 규격이다.
- 8방향 sheet 의 region 접미사는 FLARE16 의 짝수 라벨(
E,SE,S,SW,W,NW,N,NE)이고,
런타임은 .atlas 헤더의 laryen.directions: 8 을 읽어 8칸 table 을 만든 뒤 16방향 facing 을
nearest8FromDir16 으로 근사한다. 이 세 가지(생성 라벨·메타·런타임 근사)는 한 세트라
하나만 바꾸면 방향이 통째로 어긋난다.
- 캐릭터·애니 모델은 Mixamo rig(본 이름
mixamorig:). PC 는 부위별 overlay 합성 없이
세트 단위 통짜 sheet. 몬스터는 장비 분리 없이 전체 모델 렌더.
- RAM 은 W×H×4 로 고정 —
--color-compression 은 디스크/번들 용량만 줄인다(OOM 무관).
메모리 절감은 픽셀 축소(--cell-size)로만.
- 검증 불가 시 원점 복구 — packing 결과를 실제 Flame 앱으로 시각 검증하지 못하면 커밋하지 않는다.
관련 워크플로우
- texture-packer(이 스킬) = packing 파이프라인 코드(sheet.py 계열)의 소유·실행·SSOT.
- 상위 자산 생성 워크플로우(확장자 자동감지·내장 애니 매칭 안내 등)는 실행 단계에서 이 스킬의
scripts/sheet.py 를 호출한다. 3D 모델 자체 생성(참조 이미지 기반) 뒤 sprite packing 은 이 스킬로.
