방법론
이 페이지는 BISPath가 BIS 가이드와 메타 장비 통계를 만드는 방법을 정직하게 설명합니다. 이 글의 목적은 어떤 데이터든 그대로 신뢰하기 전에 표본 방식과 한계를 먼저 이해할 수 있게 하는 것입니다.
1. 데이터 출처
BISPath는 두 곳에서 데이터를 가져옵니다. 게임 메타데이터(아이템 정보, 직업·특성 정의, 스탯 키, 아이템 세트 효과)는 Blizzard Entertainment의 공식 API를 통해 가져옵니다. 사용하는 namespace는 동적 데이터를 위한 profile-{region}, 정적 데이터를 위한 static-{region}이며, 캐릭터 동기화는 OAuth 로그인 토큰으로 본인 계정의 캐릭터에 한해 수행됩니다. 상위 플레이어 장비 통계는 WarcraftLogs의 GraphQL API를 통해 가져옵니다.
2. 표본 추출 방식
메타 장비 데이터는 현재 시즌의 레이드 보스 전체와 대표 쐐기던전 인카운터에 대해 WarcraftLogs 랭킹 첫 페이지를 호출해서 수집됩니다. WarcraftLogs는 페이지당 100개의 랭킹 항목을 반환하며, 같은 캐릭터가 여러 보스에서 등장하면 캐릭터 이름·서버·리전 조합을 키로 중복을 제거한 뒤 가장 높은 랭킹 항목 하나만 남깁니다. 그렇게 만들어진 dedup된 표본에서 각 캐릭터가 실제로 착용했던 장비, 인챈트, 보석 정보를 추출해 슬롯별로 분포를 집계합니다. 스탯 우선순위 분포는 별도 분석기가 동일한 표본의 서브셋에서 계산합니다. 현재 구현은 쐐기던전 표본이 단일 인카운터 기준이라는 점을 명확히 밝혀 둡니다 — 확장은 로드맵에 있습니다.
3. 수집 주기
데이터 수집은 GitHub Actions의 cron 워크플로로 매일 한국 시간 00:03(UTC 15:03 전날)에 자동 실행됩니다. 한 번의 실행에서 레이드 데이터, 쐐기던전 데이터, 그리고 스탯 우선순위 분포가 모두 갱신되며, 각 스펙별로 새 표본 크기와 마지막 수집 시간이 저장됩니다. 시간이 갈수록 새 로그가 더 많이 쌓이면서 표본이 안정화되지만, 패치 직후에는 표본이 작을 수 있으니 주의가 필요합니다.
4. 쐐기돌 픽률은 다른 파이프라인입니다
쐐기돌 픽률 화면은 위에서 설명한 WarcraftLogs 경로를 쓰지 않습니다. 데이터는 블리자드의 공식 쐐기돌 리더보드에서 오고, 리더보드는 서버·던전·주차마다 상위 500건까지만 공개합니다. 인구가 많은 리전은 그 상한에 걸리는 경우가 많으므로, 화면의 구간별 런 수는 '얼마나 플레이했는가'가 아니라 '공개 범위 안에 얼마나 잡혔는가'입니다. 구간 사이의 비중을 인구 비중으로 읽으면 안 됩니다. 수집은 매일 돌지만 저장 단위는 한 주이고, 진행 중인 주차는 저장하지 않습니다 — 절반만 쌓인 기록이 완결본으로 굳으면 되돌릴 수 없기 때문입니다. 주차 경계는 리전마다 달라서 수집기가 리전별 주차 정보를 따로 읽습니다. 그래서 이 화면의 수치는 매일 바뀌지 않고 해당 리전의 한 주가 끝난 뒤 갱신됩니다. 백분율의 분모도 종류마다 다릅니다. 특성 비율은 같은 역할 안에서의 비율이고, 조합별 비율은 그 구간의 전체 런(투탱·투힐 같은 비표준 구성 포함)을 분모로 쓰며, 탱커·힐러 짝 비율만 탱커 한 명·힐러 한 명인 런을 셉니다. 단수 구간을 나눠 보여주는 이유는 구간마다 사람들이 고르는 조합이 크게 다르기 때문이고, 한 표로 합치면 어느 구간에도 해당하지 않는 평균이 나옵니다.
5. 편집 워크플로우
BIS 가이드의 해설 부분은 자동 생성이 아니라 사람이 작성합니다. 작성 절차는 (1) 자동화된 팩트 시트로 BIS 아이템 목록, 장신구 티어, 스탯 분포, 수집 표본 크기를 추출하고, (2) 편집자가 그 시트와 본인의 게임 지식을 결합해 각 스펙의 장비 철학, 스탯 우선순위 이유, 예외 상황, FAQ를 작성하고, (3) 검토 후 lastReviewed 날짜와 함께 커밋합니다. 편집자가 작성하지 않은 스펙은 데이터 표만 보여주고 검색 엔진 색인에서 제외됩니다.
6. 알려진 한계
이 방식의 한계는 명확합니다. 첫째, WarcraftLogs 랭킹 상위 표본은 이미 장비가 충분히 갖춰진 상위 플레이어에 편향되어 있으므로, 초보자나 중급자의 최적 선택과는 다를 수 있습니다. 둘째, 특정 보스나 컨텐츠 타입(레이드 vs 쐐기)에서 강한 장비가 다른 곳에서는 약할 수 있고, 표본에는 그 차이가 잘 드러나지 않습니다. 셋째, 새 패치나 핫픽스 직후에는 충분한 새 로그가 쌓이기 전까지 표본이 옛 메타를 반영합니다. 넷째, 수집은 한국 리전을 기본으로 하며, 글로벌 평균이 아닙니다.
7. 변경과 정정
방법론이나 수집 코드가 바뀌면 이 페이지를 먼저 갱신합니다. 사실 오류가 발견되면 가능한 빠르게 정정하고, 각 데이터 레코드의 마지막 갱신 시각(updatedAt)을 통해 최신 상태를 확인할 수 있습니다. 데이터 오류 신고나 방법론 개선 제안은 bispath.gg@gmail.com으로 받습니다.