#!/usr/bin/env python3 """Build a focused review for battle stance/status coefficient tables. The damage reports established the consumer side: * +0x70/+0x72/+0x74 are attacker-side action/hit coefficients. * +0x7a/+0x7c/+0x7e are target-side defense/avoid/resist coefficients. * +0x80/+0x82/+0x84 cache the base attacker coefficients before each hit unit. This report identifies the producer side for those values. The EXE stores the battle mode/status names and six percentage bytes in one table at 0x0048bcaa. Function 0x00433932 selects the record by actor +0x2a and multiplies the active battle coefficients by those bytes. """ from __future__ import annotations import html import json import re import struct import subprocess from pathlib import Path from typing import Any ROOT = Path(__file__).resolve().parents[1] OUT = ROOT / "out" EXE = ROOT / "Hwanse2.exe" MODE_TABLE_VA = 0x0048BCAA MODE_TABLE_COUNT = 28 def esc(value: Any) -> str: return html.escape(str(value if value is not None else "")) def hex32(value: int | None) -> str: return "-" if value is None else f"0x{value:08x}" def pe_sections(blob: bytes) -> tuple[int, list[dict[str, int | str]]]: pe_offset = struct.unpack_from(" int | None: rva = va - image_base for section in sections: start = int(section["virtualAddress"]) span = max(int(section["virtualSize"]), int(section["rawSize"])) if start <= rva < start + span: return int(section["rawPtr"]) + (rva - start) return None def read_c_string_cp949(data: bytes) -> str: raw = data.split(b"\0", 1)[0] return raw.decode("cp949", "replace").replace("\u3000", " ").rstrip() def disassemble(start_va: int, stop_va: int) -> str: try: result = subprocess.run( [ "objdump", "-Mintel", "-D", "-b", "pei-i386", f"--start-address=0x{start_va:08x}", f"--stop-address=0x{stop_va:08x}", str(EXE), ], check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, ) except (OSError, subprocess.CalledProcessError) as exc: return f"; disassembly unavailable: {exc}" return "\n".join(line for line in result.stdout.splitlines() if re.match(r"\s*[0-9a-f]{6,8}:", line)) def compact_lines(disasm: str, needles: list[str], *, context: int = 0) -> list[str]: lines = disasm.splitlines() selected: list[tuple[int, str]] = [] for index, line in enumerate(lines): if any(needle in line for needle in needles): for i in range(max(0, index - context), min(len(lines), index + context + 1)): selected.append((i, lines[i])) seen: set[int] = set() result: list[str] = [] for index, line in selected: if index not in seen: seen.add(index) result.append(line) return result def category_for_index(index: int) -> str: if 1 <= index <= 5: return "battle stance" if 6 <= index <= 10: return "아타호 술취함" if 11 <= index <= 15: return "스마슈 눈요기" if 16 <= index <= 20: return "린샹 도발" if 21 <= index <= 27: return "상태이상/행동불가" return "unused/null" def decode_mode_table(exe: bytes, sections: list[dict[str, int | str]], image_base: int) -> list[dict[str, Any]]: rows: list[dict[str, Any]] = [] for index in range(MODE_TABLE_COUNT): entry_va = MODE_TABLE_VA + index * 8 entry_offset = va_to_offset(entry_va, sections, image_base) if entry_offset is None: continue record_va, meta = struct.unpack_from(" dict[str, Any]: exe = EXE.read_bytes() image_base, sections = pe_sections(exe) mode_rows = decode_mode_table(exe, sections, image_base) function_rows = [] for spec in FUNCTIONS: disasm = disassemble(spec["va"], spec["end"]) function_rows.append( { **spec, "vaHex": hex32(spec["va"]), "endHex": hex32(spec["end"]), "keyLines": compact_lines(disasm, spec["needles"], context=0), } ) return { "sourceExe": str(EXE.relative_to(ROOT)), "modeTableVaHex": hex32(MODE_TABLE_VA), "modeTableCount": MODE_TABLE_COUNT, "status": "mode-coefficients-grounded-tail-metadata", "summary": [ "전투 자세/상태 이름과 6개 계수 byte는 0x0048bcaa 포인터 테이블에서 확정적으로 읽힌다.", "기본 자세 5개는 보통/돌격/방어/선제/반격이며, 사용자 설명과 EXE 수치가 일치한다.", "돌격은 공격 115, 방어 90, 명중 110, 회피 80이다. 방어는 공격 80, 방어 150이다.", "선제는 행동순서 계수 120, 반격은 행동순서 계수 10이라 turn order 설명과 맞는다.", "+0x7e는 target-side critical/status resistance 계수로 확정됐다. 이 자세/상태 테이블은 +0x7e를 바꾸지 않아 reset 기본값 100이 유지된다.", "+0x72는 attacker 쪽 critical result gate 계수로 승격한다. critical은 텍스트가 아니라 섬광/전용 사운드/높은 데미지로 표시된다.", "record +0x16/+0x17은 전투 계산 계수가 아니다. 0x48bcaa를 쓰는 code path는 상태명 표시와 +0x10..+0x15 계수 적용뿐이며, record VA 직접 참조도 없다.", "+0x16/+0x17은 전투 런타임 계산 미확정이 아니라 비소비 정적 분류 메타데이터로 닫는다. +0x16은 전투 자세 1..5 표식, +0x17은 비자세 상태 그룹 마스크다.", ], "fieldMap": FIELD_MAP, "tailFlagInterpretation": TAIL_FLAG_INTERPRETATION, "modeRows": mode_rows, "functionRows": function_rows, "openQuestions": [], } def render_table(headers: list[str], rows: list[dict[str, Any]]) -> str: head = "".join(f"{esc(header)}" for header in headers) body = [] for row in rows: cells = [] for header in headers: value = row.get(header, "") if header.endswith("Coef") and isinstance(value, int): cls = "good" if value > 100 else "bad" if value < 100 else "" cells.append(f'{esc(value)}') else: cells.append(f"{esc(value)}") body.append("" + "".join(cells) + "") return f"{head}{''.join(body)}
" def render_html(data: dict[str, Any]) -> str: mode_headers = [ "index", "name", "category", "recordVaHex", "attackCoef", "defenseCoef", "hitStatusCoef", "avoidCoef", "actionSpeedCoef", "criticalCoef", "flag0x16", "flag0x17", ] field_headers = ["recordByte", "coefficient", "actorField", "meaning", "evidence"] tail_headers = ["recordByte", "mask", "meaning", "matchingIds", "confidence", "evidence"] summary = "".join(f"
  • {esc(item)}
    • " for item in data["summary"]) open_questions = "".join(f"
  • {esc(item)}
    • " for item in data["openQuestions"]) functions = [] for row in data["functionRows"]: functions.append( f"""
    {esc(row['vaHex'])} {esc(row['label'])}

    {esc(row['summary'])}

    {esc(chr(10).join(row['keyLines']) or '(no key lines)')}
    """ ) return f""" 전투 자세/상태 계수 검토

    전투 자세/상태 계수 검토

    mode table {esc(data['modeTableVaHex'])} · actor +0x2a indexed coefficient records

    결론

      {summary}

    레코드 필드 의미

    {render_table(field_headers, data["fieldMap"])}

    Tail Flag 해석 후보

    {render_table(tail_headers, data["tailFlagInterpretation"])}

    자세/상태 계수 테이블

    {render_table(mode_headers, data["modeRows"])}

    남은 부분

      {open_questions}

    근거 함수

    {''.join(functions)}
    """ def render_md(data: dict[str, Any]) -> str: lines = [ "# 전투 자세/상태 계수 검토", "", f"- table: `{data['modeTableVaHex']}`", f"- records: `{data['modeTableCount']}`", "", "## 결론", "", ] lines.extend(f"- {item}" for item in data["summary"]) lines.extend(["", "## 자세 5종", ""]) lines.append("| index | name | attack | defense | hit/status | avoid | order | critical |") lines.append("|---:|---|---:|---:|---:|---:|---:|---:|") for row in data["modeRows"]: if row["category"] == "battle stance": lines.append( f"| {row['index']} | {row['name']} | {row['attackCoef']} | {row['defenseCoef']} | " f"{row['hitStatusCoef']} | {row['avoidCoef']} | {row['actionSpeedCoef']} | {row['criticalCoef']} |" ) lines.extend(["", "## 전체 상태 테이블", ""]) lines.append("| index | name | category | attack | defense | hit/status | avoid | order | critical | flags |") lines.append("|---:|---|---|---:|---:|---:|---:|---:|---:|---|") for row in data["modeRows"]: if row["index"] == 0: continue lines.append( f"| {row['index']} | {row['name']} | {row['category']} | {row['attackCoef']} | {row['defenseCoef']} | " f"{row['hitStatusCoef']} | {row['avoidCoef']} | {row['actionSpeedCoef']} | {row['criticalCoef']} | " f"{row['flag0x16']:02x} {row['flag0x17']:02x} |" ) lines.extend(["", "## Tail Flag 해석 후보", ""]) lines.append("| record byte | mask | meaning | matching ids | confidence |") lines.append("|---|---|---|---|---|") for row in data["tailFlagInterpretation"]: lines.append( f"| {row['recordByte']} | {row['mask']} | {row['meaning']} | {row['matchingIds']} | {row['confidence']} |" ) lines.extend(["", "## 남은 부분", ""]) if data["openQuestions"]: lines.extend(f"- {item}" for item in data["openQuestions"]) else: lines.append("- 없음") lines.append("") return "\n".join(lines) def main() -> None: OUT.mkdir(parents=True, exist_ok=True) data = build() (OUT / "battle_mode_coefficient_review.json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") (OUT / "battle_mode_coefficient_review.html").write_text(render_html(data), encoding="utf-8") (OUT / "battle_mode_coefficient_review.md").write_text(render_md(data), encoding="utf-8") print("wrote out/battle_mode_coefficient_review.{json,html,md}") if __name__ == "__main__": main()