밴딧 공용 효과와 문서 정리

docs/card-effect-fields.md

@@ -0,0 +1,84 @@
+# Card Effect Fields
+
+`data/cards.json`의 카드 효과를 공용 데이터 필드로 표현하는 기준 문서입니다.
+
+## 피해 수치
+
+- `damage`: 기본 피해
+- `damagePerOtherHandCard`: 손패의 다른 카드 수만큼 피해 증감
+- `damagePerAttackPlayedThisTurn`: 이번 턴에 사용한 공격 카드 수만큼 피해 증감
+- `damagePerDiscardedThisTurn`: 이번 턴에 버린 카드 수만큼 피해 증감
+- `damagePerSkillInHand`: 손패의 스킬 카드 수만큼 피해 증감
+- `otherHandAtLeast`: 손패의 다른 카드가 이 수 이상일 때 조건 충족
+- `bonusHitsWhenOtherHandAtLeast`: 조건 충족 시 추가 적중 수
+
+## 방어/상태
+
+- `block`: 방어도 획득
+- `cardPlayedBlock`: 카드를 사용할 때마다 방어도 획득
+- `hits`: 다단히트 횟수
+- `aoe`: 모든 적 대상
+- `pierce`: 방어도 무시
+- `draw`: 즉시 드로우
+- `drawUntilHandSize`: 손패가 지정 장수에 도달할 때까지 드로우
+- `heal`: 즉시 회복
+- `gainEnergy`: 즉시 에너지 획득
+- `strength`: 힘 획득
+- `dex`: 민첩 획득
+- `thorns`: 가시 획득
+- `selfVuln`: 자신에게 취약 부여
+
+## 상태이상
+
+- `weak`: 약화 부여
+- `vuln`: 취약 부여
+- `poison`: 중독 부여
+
+`poison`은 적 턴 시작 시 피해를 주고 1 감소합니다.
+
+## 드로우/버리기
+
+- `discard`: 손패에서 지정 장수 버리기
+- `discardAll`: 손패 전부 버리기
+- `drawPerDiscarded`: 버린 카드 1장당 추가 드로우
+- `addShiv`: 표창 생성
+- `addShivPerDiscard`: 버린 장수만큼 표창 생성
+- `sly`: 버려질 때 교활 발동
+- `retain`: 턴 종료 시 해당 카드 보존
+
+## 파워/턴 효과
+
+- `powerEffect: "strengthPerTurn"`
+- `powerEffect: "energyPerTurn"`
+- `powerEffect: "blockPerTurn"`
+- `powerEffect: "retainOne"`
+- `turnStartShiv`: 턴 시작 시 표창 생성
+- `turnStartDraw`: 턴 시작 시 추가 드로우
+- `turnStartDiscard`: 턴 시작 시 카드 버리기
+
+## 다음 턴 예약
+
+- `nextTurnBlock`: 다음 턴 시작 시 방어도 획득
+- `nextTurnDraw`: 다음 턴 시작 시 추가 드로우
+- `nextTurnKeepBlock`: 다음 턴 시작 시 기존 방어도 유지
+- `nextTurnAttackMultiplier`: 다음 턴 공격 피해 배수
+- `nextTurnCopies`: 다음 턴에 손패에서 가져올 복사본 수
+- `nextTurnSelectHandCard`: 현재 손패에서 카드 1장 선택
+- `nextTurnSelectPrompt`: 선택 UI 문구
+
+## 기타
+
+- `innate`: 전투 시작 시 첫 손패에 우선 진입
+- `playableWhenDrawPileEmpty`: 뽑을 카드 더미가 비었을 때만 사용 가능
+- `exhaust`: 사용 후 소멸
+- `unplayable`: 사용 불가
+- `curse`: 저주 카드
+- `token`: 토큰 카드
+- `endTurnDamage`: 턴 종료 시 손패에 있으면 피해
+
+## 사용 원칙
+
+- 카드 전용 분기보다 공용 필드를 먼저 쓴다.
+- 같은 효과는 같은 필드로 재사용한다.
+- 새 카드가 같은 패턴이면 먼저 공용 필드를 추가한다.
+