Skip to content

docs: 도트 아트 전면 개편 계획·스타일 바이블·Phase task 추가#110

Merged
SilverSupplier merged 2 commits into
sw1029:mainfrom
SilverSupplier:docs/art-overhaul-plan
Jun 2, 2026
Merged

docs: 도트 아트 전면 개편 계획·스타일 바이블·Phase task 추가#110
SilverSupplier merged 2 commits into
sw1029:mainfrom
SilverSupplier:docs/art-overhaul-plan

Conversation

@SilverSupplier
Copy link
Copy Markdown
Collaborator

작업 배경

현재 게임의 도트 디자인이 빈약하다는 인상이 있다. 원인은 픽셀 배치의 문제가 아니라 파이프라인이 절차적 32×32 도형 합성에 머물러 있기 때문이다. 이 PR은 자산을 만들기 전에 팀이 합의해야 할 계획·스타일 규칙·Phase 단위 작업 분할을 문서로 정리한다.

코드 변경은 0줄이다. 모든 자산 교체는 후속 Phase별 PR에서 일어난다.

변경 내용

1. 마스터 플랜

  • docs/ART_OVERHAUL_PLAN.md — 현 상태 진단(원인 7가지), Phase 0~6 로드맵, 합의 필요 결정, 영향 범위, 자산 소싱 전략, 타임라인 가이드, 롤백 시나리오

2. 스타일 바이블 (Phase 0 산출물)

  • docs/ART_STYLE_BIBLE.md — 시점·해상도·팔레트·라이팅·외곽선·셰이딩·룬 가독성·애니메이션 프레임·파일명 컨벤션·금지 사항을 lock

3. Phase 단위 task 문서 (7개)

  • docs/30_tasks/art-phase-0-style-bible.md
  • docs/30_tasks/art-phase-1-urp-2dlight.md
  • docs/30_tasks/art-phase-2-player-png-anim.md
  • docs/30_tasks/art-phase-3-autotile.md
  • docs/30_tasks/art-phase-4-prop-variants.md
  • docs/30_tasks/art-phase-5-rune-handdrawn.md
  • docs/30_tasks/art-phase-6-postfx.md

각 task는 frontmatter(id/status/depends_on/blocks)·작업 항목·검증·영향 범위·결정 필요 항목을 명시. 후속 자산 PR이 들어올 때 본 task 문서가 리뷰 기준이 된다.

4. Work Queue

  • docs/20_queue/work-queue.md — 7개 Phase task 행 추가, depends_on/blocks로 의존성 표시

팀원에게 합의 요청하는 항목

리뷰 댓글로 의견 부탁드립니다.

항목 권장 대안
캐릭터 해상도 48×64 32×32 유지(불권장), 64×96(Sea of Stars급)
타일 해상도 32×32 16×16(Stardew급)
팔레트 AAP-64 Endesga 32, DB-32, 자체 24색
시점 Top-down 3/4 oblique 45° 순수 top-down, side-view
자산 소싱 자체 + Mystic Woods 보완 100% 자체, 100% 외부 팩
Chromatic Aberration OFF 기본 + 옵션 항상 OFF, 항상 ON

특히 팔레트와 캐릭터 해상도는 다음 Phase 자산 작업의 기준이라 본 PR이 머지되기 전에 확정되어야 합니다.

다른 레이어에 미치는 영향

레이어 영향
Input Capture (sw1029) ❌ 없음
Stroke Session ❌ 없음
Recognition / Personalization ❌ 없음 (SpellRecognitionHandoff DTO 그대로)
Game Runtime ⚠️ Phase 3·4에서 prop spawn 변경 예정 (본 PR 아님)
Render Pipeline ⚠️ Phase 1에서 URP 마이그레이션 예정 (본 PR 아님)
Feedback / Tutorial / Logs ❌ 없음

본 PR 자체는 문서 추가만 있어 어떤 코드·테스트도 변경하지 않습니다.

점진 적용 보장

  • PR #109의 PNG 우선 로더(PixelArtFactory.LoadExternalSprite) 위에서 동작
  • 한 자산만 교체해도 게임 정상 동작 → Phase 5 룬 5종도 family 단위 분할 PR 가능
  • 절차 그림은 placeholder로 영구 유지
  • 각 Phase는 독립 revert 가능

검증

  • git diff --check: 통과
  • 코드 변경 0줄 → Unity 빌드/테스트 영향 없음
  • docs validation: work-queue에 추가된 7개 task 모두 docs/30_tasks/ 아래 frontmatter 포함 파일 존재
  • 마크다운 링크: 상대경로 기준으로 작성

후속 PR 예정 순서

  1. Phase 0 본 PR 머지
  2. Phase 1 — URP + 2D Light + Pixel Perfect Camera (1일)
  3. Phase 2 — Player PNG + 4방향 + 애니 (2~3일) ← 체감 변화 가장 큼
  4. Phase 3 — Autotile (1~2일)
  5. Phase 4 — Prop 베리에이션 (꾸준히)
  6. Phase 5 — Rune 손그림 (family당 0.5일 × 5)
  7. Phase 6 — Post FX (0.5일)

Phase 0·1 끝나는 시점에 한 번 빌드하고 직접 플레이해서 다음 Phase 우선순위 재조정 예정.

ART_OVERHAUL_PLAN.md에 현 상태 진단과 Phase 0~6 로드맵을 정리하고,
ART_STYLE_BIBLE.md에 해상도·팔레트·시점·라이팅·외곽선 규칙을 lock했다.
docs/30_tasks/ 아래 7개 Phase task와 work-queue 행 7개를 추가해
후속 자산 PR이 본 문서를 기준으로 리뷰될 수 있게 한다.
@SilverSupplier SilverSupplier requested a review from sw1029 as a code owner June 1, 2026 11:49
@SilverSupplier SilverSupplier merged commit 4887cc8 into sw1029:main Jun 2, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant