jinilkim/DS-Combat_analy

Fork 0

Files

Gnill82 80176c7c9e v2 폐기하고 v3로 새출발

2025-11-05 11:09:16 +09:00

6.9 KiB

Raw Blame History

장기 과제: Blueprint 변수 검증

과제 개요

DT_Skill의 스킬 설명(desc)에 사용된 {0}, {1} 등의 변수가 실제 게임 로직(Blueprint, 몽타주 등)의 값과 일치하는지 검증하는 작업

현재 상태

✅ 완료된 부분

DT_Skill의 desc (원본 설명 문자열) 추출
DT_Skill의 descValues (UI 표시용 값 배열) 추출
descFormatted (변수 치환된 최종 설명) 생성
문서에 완전한 스킬 설명 표시

⚠️ 제한 사항

descValues는 유저에게 보여주기 위한 텍스트 정보일 뿐, 실제 게임 로직에서는 사용되지 않음

실제 스킬 효과는 Blueprint, AnimMontage, GameplayEffect 등에 정의됨
descValues와 실제 게임 로직 값이 다를 가능성 존재
각 변수가 어느 Blueprint/몽타주의 어떤 변수와 연결되는지 case-by-case 분석 필요

검증 대상 예시

예시 1: Hilda 반격 (SK100202)

DT_Skill 정보:

desc: "방패를 들어 {0}초 동안 반격 자세를 취합니다. 반격 성공 시 {1}%만큼 물리 피해를 줍니다."
descValues: [5, 80]
abilityClass: /Game/Blueprints/Abilities/GA_Skill_Knight_Counter.GA_Skill_Knight_Counter_C

검증 필요 사항:

{0} = 5초 → GA_Skill_Knight_Counter의 어느 변수? (activeDuration? blockingDuration?)
{1} = 80% → GA_Skill_Knight_Counter의 어느 변수? (counterDamageMultiplier?)

현재 문제:

Blueprint.json에서 GA_Skill_Knight_Counter 추출 시 모든 VarName이 None으로 나타남
변수 이름 없이는 매칭 불가능

예시 2: Urud 다발 화살 (SK110205)

DT_Skill 정보:

desc: "{0}발의 화살을 동시에 발사하여 각각 {1}%만큼 물리 피해를 입힙니다."
descValues: [3, 90]
abilityClass: /Game/Blueprints/Characters/Urud/GA_Skill_Urud_MultiShot_Quick.GA_Skill_Urud_MultiShot_Quick_C

검증 필요 사항:

{0} = 3발 → Blueprint의 ProjectileCount? 또는 몽타주의 AN_Trigger_Projectile_Shot_C 호출 횟수?
{1} = 90% → 이미 DT_Skill.skillDamageRate=0.9로 검증됨 ✅

작업 범위

1단계: 정보 수집 (필수)

Blueprint 변수 이름을 얻기 위한 방법 선택:

옵션 A: Blueprint.json 재추출

FModel 또는 다른 추출 도구 설정 변경
VarName 필드가 포함되도록 추출 옵션 조정
또는 Unreal Editor에서 직접 Blueprint을 JSON으로 Export

옵션 B: 수동 조사

Unreal Editor에서 각 GA_Skill Blueprint 열기
변수 목록과 기본값을 수동으로 기록
config.py에 수동으로 정의

옵션 C: 코드 분석

C++ 소스 코드에서 WSGameplayAbility 클래스 분석
각 GA_Skill의 부모 클래스 변수 확인
.h/.cpp 파일에서 변수 정의 추출

2단계: 변수 매칭 규칙 정의

각 스킬 타입별 변수 매칭 패턴 정의:

# 예시 매칭 규칙
SKILL_VAR_MAPPING = {
    'counter_skills': {
        # 반격 스킬 계열
        '{0}': 'blockingDuration',  # 반격 지속 시간
        '{1}': 'counterDamageRate'  # 반격 피해 배율
    },
    'projectile_skills': {
        # 발사체 스킬 계열
        '{0}': 'projectileCount',   # 발사체 개수
        '{1}': 'skillDamageRate'    # 피해 배율 (DT_Skill에서 검증 가능)
    },
    'summon_skills': {
        # 소환 스킬 계열
        '{0}': 'activeDuration',    # 소환 지속 시간 (DT_Skill에서 검증 가능)
        '{1}': 'summonDamageRate'   # 소환수 피해 배율
    }
}

3단계: 자동 검증 스크립트 작성

def verify_skill_desc_values(skill_id: str, skill_data: Dict) -> Dict:
    """
    스킬 설명의 변수가 실제 Blueprint/몽타주 값과 일치하는지 검증

    Returns:
        {
            'verified': bool,
            'mismatches': [],
            'sources': {
                '{0}': {'expected': 5, 'actual': 5, 'source': 'Blueprint.activeDuration'},
                '{1}': {'expected': 80, 'actual': 75, 'source': 'Blueprint.counterDamageRate'}
            }
        }
    """
    pass

4단계: 검증 리포트 생성

각 스킬별 검증 상태를 마크다운으로 출력:

## SK100202 - 반격 (Hilda)

**Desc**: 방패를 들어 {0}초 동안 반격 자세를 취합니다. 반격 성공 시 {1}%만큼 물리 피해를 줍니다.

| 변수 | descValues | 실제 값 | 출처 | 상태 |
|------|------------|---------|------|------|
| {0} | 5 | 5 | GA_Skill_Knight_Counter.blockingDuration | ✅ 일치 |
| {1} | 80 | 75 | GA_Skill_Knight_Counter.counterDamageRate | ❌ 불일치 |

**결론**: descValues가 실제 로직과 다를 수 있음 (UI 표시용 값)

우선순위 스킬 목록

다음 스킬들을 우선적으로 검증:

High Priority (복잡한 변수 사용)

SK100202 (Hilda 반격) - 지속시간, 피해량
SK110205 (Urud 다발 화살) - 발사체 개수, 피해량
SK160202 (Rene Ifrit 소환) - 지속시간, 공격력
SK160206 (Rene Shiva 소환) - 지속시간, 공격 주기
SK120202 (Nave 화염벽) - 지속시간, 틱 피해

Medium Priority (1-2개 변수)

SK100201 (Hilda 칼날 격돌) - 피해량, 경직 시간
SK130204 (Baran 강제 끌어오기) - 피해량
SK180202 (Sinobu 부적폭탄) - 폭발 범위, 피해량

Low Priority (변수 없거나 단순)

대부분의 유틸리티 스킬
변수가 없는 스킬

예상 결과물

검증 스크립트: verify_blueprint_variables.py
변수 매칭 정의: config.py에 SKILL_VAR_MAPPING 추가
검증 리포트: Blueprint변수검증_리포트.md
업데이트된 문서: 각 스킬에 실제 값 vs descValues 비교 추가

예상 소요 시간

옵션 A (Blueprint 재추출): 1-2시간 (추출 설정 + 재실행)
옵션 B (수동 조사): 10-15시간 (91개 스킬 × 평균 10분)
옵션 C (코드 분석): 3-5시간 (C++ 코드 리뷰 + 자동화)

권장 접근 방법

단기 (1-2시간):
- Blueprint.json 재추출 시도 (FModel 설정 변경)
- 성공 시 자동 검증 스크립트 작성
중기 (3-5시간):
- C++ 소스 코드 분석으로 변수 패턴 파악
- 우선순위 High 스킬 5개만 수동 검증
장기 (필요 시):
- 모든 스킬 완전 검증
- 자동화 스크립트 완성
- CI/CD 파이프라인에 검증 단계 추가

참고 사항

descValues는 UI 표시용이므로 실제 로직과 다를 수 있음을 명심
밸런스 패치 시 Blueprint는 업데이트되지만 descValues는 업데이트 안 될 수 있음
이 검증은 "문서의 정확성"보다 "게임 로직의 일관성"을 위한 것
실제 DPS 계산에는 Blueprint/몽타주의 실제 값을 사용해야 함

연락처 및 진행 상황

담당자: (추후 할당)
시작일: 2025-10-24
목표 완료일: (TBD)
현재 상태: 계획 단계
진행률: 0% (정보 수집 대기 중)

생성일: 2025-10-24 21:34 버전: v1.0 작성자: Claude Code

6.9 KiB Raw Blame History Unescape Escape