한글 패치는 크게 세 부분으로 나눠진다

# 1. 리소스 언팩

파일을 처음보면 .tac 이라는 낮선 파일이 보인다.

지금까지 경험해본 .tac 파일은 확장자가 같아도 TArc1.10, TArc1.20, glib/glib2 세가지 분류로 나눠진다

파일 헤더를 확인해보면 바로 알수 있다. TArc1.10, TArc1.20 로 적혀있는 경우가 있고 헤더가 이상하면 glib2 로 의심해본다

TArc1.10, TArc1.20 는 패키지 안의 파일 이름(경로)을 미리 알고 있어야만 정확한 파일이름으로 unpack 이 가능하다.

반면 glib2 는 파일 이름까지 완벽하게 unpack 가능하다.

TArc1.10 와 glib2 는 arc_unpacker 로 unpack 이 가능하며 TArc1.20 는 파일 구조가 알려져있지 않아 현존하는 unpack 도구가 없다.

다행이도 조카소녀는 .tac 파일이 모두 glib2 로 이루어져있어 arc_unpacker 로 완벽하게 풀수 있었다.

한글패치만 하려면 datascn.tac 만 unpack 하면 된다 해당 파일 안에 모든 시나리오 스크립트 파일이 존재한다.

datascn.tac 를 풀면 처음보는 .BCS 파일이 반겨준다. 이 파일도 TanukiSoft의 자체 파일 포맷이고 csv 파일을 담고 있다.

다행히 양덕들이 bcs 파일을 리버싱하여 bcs to csv 변환이 가능한 도구 BcsExtractor 가 있다. github 에서 찾아보면 나온다.

.BCS 를 .csv 로 바꾸었으면 unpack 은 모두 끝났다.

특이한 점은 .tac 으로 리팩을 하지 않아도 패치가 가능하다는것이다.

csv 가 올바르게 작성되었다는 가정하에

datascn.tac 라는 이름의 폴더를 만들고 그 안에 csv 파일만 위치 시키면 게임 실행이 가능하다.

.BCS 파일이나 원본 datascn.tac 파일은 지워야 한다.

# 2. csv 번역

csv 는 shift-jis 인코딩으로 되어있으며 일반적인 csv와는 약간 다른 자체 포맷으로 이루어져있다.

이 게임의 시나리오 CSV는 일반적인 RFC 스타일 CSV처럼만 다루면 안 된다.

게임 엔진이 일부 줄, 기호, 줄바꿈, 명령 문자열을 바이트 단위로 민감하게 처리한다.

번역 CSV를 작성할 때는 원본 파일의 형태를 최대한 유지해야 한다.

조금이라도 이 포맷에서 벗어나면 게임실행이 안되거나 게임이 비정상으로 동작한다.

%info% 나 %comment% 는 주석이라 번역하지 않아도 되고 %text% 와 %seq% 만 번역하면 된다.

이 게임은 utf-8 을 지원하지 않으므로 ansi 포맷인 cp949 로 저장하여 번역해야 한다.

다음은 csv 를 번역할때 주의해야 할 점이다

## 인코딩

- 번역본 CSV는 cp949로 작성한다.

- 일본어 원본 CSV는 실질적으로 cp932 / Shift-JIS 계열이다.

- 단, 일부 메뉴 제어 기호는 번역본이 cp949이더라도 원본 cp932 바이트를 유지해야 한다. (후에 서술)

## 줄바꿈

- 기본적인 줄바꿈은 CRLF 이지만 모든 줄을 무조건 CRLF로 정규화하면 안 된다.

- 원본 파일의 각 물리 라인별 CR 개수와 LF 개수를 맞춰야 한다.

- 일부 원본 파일에는 CRLF가 아니라 LF만 있는 줄이 있다.

## 컬럼

- 일반 논리 행은 18컬럼이다.

- 원본에는 CSV의 정상 18컬럼 행 대신 쉼표가 없는 라인이 존재한다.

- 이런 라인은 빈 줄이거나 텍스트만 있는 줄이다.

- 이 줄들을 18컬럼짜리 빈 행으로 확장하면 안 되고 원본 쉼표 개수를 정확히 맞춰야 한다

## 마지막 footer 행

원본 파일의 마지막에는 보통 comma-only footer 행이 있다.

```

,\r\n

```

번역 원본에 18컬럼짜리 빈 행이 있어도, 출력할 때는 대상 원본 파일의 footer 형태에 맞춰야 한다.

## 쉼표 처리

ASCII 쉼표 ,는 위험하다. CSV 구분자이기도 하고, 게임 스크립트 명령의 인자 구분자로도 쓰인다.

텍스트용 대체 쉼표는 전각 쉼표를 사용한다.

```

， U+FF0C

```

규칙:

- %text% 안의 ASCII 쉼표 ,는 전각 쉼표 ，로 바꾼다.

- %text% 안의 , 는 ， 하나로 바꾼다.

- 이미 ， 형태가 있으면 뒤의 스페이스를 제거해서 ，만 남긴다.

- $menu_item의 %seq%에서는 명령 구분용 쉼표 2개는 유지하고, 선택지 텍스트 내부 쉼표만 ，로 바꾼다.

- %seq%의 다른 명령 구분 쉼표는 바꾸면 안 된다. 이 쉼표는 반드시 ASCII 쉼표로 남겨야 한다.

예:

올바른 출력:

```

$menu_item 0,응，당연하지!, sel_1a

```

잘못된 출력:

```

$menu_item 0，응，당연하지!，sel_1a

```

## 따옴표 처리

%text% 안에 ASCII double quote "가 있고, 이것을 CSV 방식으로 "" 이스케이프하면 게임실행이 실패한다.

규칙:

- %text% 안에 ASCII "를 남기지 않는다.

- 맨 앞 "는 「로 바꾼다.

- 맨 뒤 "는 」로 바꾼다.

- 중간에 남은 "는 ＂로 바꾼다.

예:

```

"아아, 마음대로 써."

```

올바른 처리:

```

「아아，마음대로 써.」

```

단, 텍스트가 아닌 다른 필드에서는 CSV quote가 필요할 수 있다.

이런 필드는 그대로 CSV quote를 사용한다.

예:

```

"aya,private"

"saya,m_private"

```

## 메뉴 및 라벨 기호

게임 엔진은 일부 메뉴 기호를 문자 디코딩 결과가 아니라 원본 바이트값으로 검사하는 것으로 보인다. 같은 문자라도 cp949 바이트로 쓰면 실패한다.

현재까지 반드시 필요한 것으로 확인된 바이트는 ■, ↓이다.

전체 파일을 cp949로 인코딩한 뒤, 아래 기호는 원본 cp932 바이트로 후처리해야 한다.

■ cp949 A1 E1 -> cp932 81 A1 -> 걾

↓ cp949 A1 E9 -> cp932 81 AB -> 겓

예:

```

52300 ,$menu_begin,,,,,,,,,,,,,,,,■選択肢

↓,"$menu_item 0,一緒に出掛ける,sel_1a",,,,,,,,,,,,,,,,

↓,"$menu_item 1,留守番をしている,sel_1b",,,,,,,,,,,,,,,,

↓,$menu_end,,,,,,,,,,,,,,,,

52600 ,*sel_1a,,,,,,,,,,,,,,,,■①一緒に出掛ける

```

올바른 처리:

```

52300 ,$menu_begin,,,,,,,,,,,,,,,,걾선택지

겓,"$menu_item 0,함께 외출한다,sel_1a",,,,,,,,,,,,,,,,

겓,"$menu_item 1,집을 지키고 있는다,sel_1b",,,,,,,,,,,,,,,,

겓,$menu_end,,,,,,,,,,,,,,,,

52600 ,*sel_1a,,,,,,,,,,,,,,,,걾①같이 외출한다

```

## $menu_item 규칙

%seq% 컬럼의 $menu_item은 내부적으로 다시 쉼표로 split된다.

형식:

```

$menu_item 번호,선택지 텍스트,이동 라벨

```

따라서 ASCII 쉼표는 정확히 2개가 있어야 한다.

올바른 예:

전각 쉼표 사용

```

$menu_item 0,응，당연하지!, sel_1a

```

잘못된 예:

ascii 쉼표 사용

```

$menu_item 0,응, 당연하지!, sel_1a

```

## 정합성 검증

검증해야 할 항목:

- 라인 수

- 각 라인의 ASCII comma 개수

- 각 라인의 CR 개수

- 각 라인의 LF 개수

원본에 쉼표 없는 continuation 줄이 있으면 출력에도 같은 위치에 쉼표 없는 줄이 있어야 한다.

이 구조를 CRLF로 정규화하거나 18컬럼 빈 행으로 만들면 게임 진행이 깨질 수 있다.

## troubleshooting

1. %text% 안의 ASCII "를 CSV 방식으로 "" 이스케이프함

- 게임실행 실패.

- 「」 / ＂로 바꿔 해결했다.

2. ■, ↓를 cp949 바이트로 저장함

- 선택지 진행에서 오류.

- 원본 cp932 바이트로 후처리하여 해결했다.

3. $menu_item 선택지 텍스트 안에 ASCII 쉼표가 남음

- 게임 진행중 오류.

- 선택지 내부 쉼표만 전각 쉼표 ，로 바꿔 해결했다.

4. %seq%의 모든 쉼표를 전각 쉼표로 바꿈

- $fset %f_010,1 같은 명령이 깨졌다.

- $menu_item 선택지 텍스트만 특수 처리하도록 수정했다.

5. 모든 줄바꿈을 CRLF로 정규화함

- 원본의 bare LF 라인 이후 게임 타이틀화면으로 돌아감.

- 원본의 각 라인별 CR/LF 개수를 맞춰 해결했다.

6. 원본 continuation 물리 라인을 18컬럼 빈 행으로 확장함

- 원본과 같은 쉼표 없는 물리 라인으로 맞춰 해결했다.

# 3. 실행파일 변조

게임 exe 실행파일을 변조하지 않으면 한글 csv 파일을 만들어도 게임은 실행되지만 한글이 깨진채로 보인다.

만약 게임 실행도 되지 않는다면 그것은 csv 파일 문제이다.

exe 파일을 변조해서 CreateFontIndirectA에 넘기는 LOGFONTA.lfCharSet 값을 0x80 (SHIFTJIS_CHARSET) 에서 81 (HANGEUL_CHARSET) 로 바꾸어줘야 한다.

또한 게임내 설정 문구나 여러 메시지가 exe 안에 일본어로 박혀있어서 이것 또한 한국어 문자열로 번역해줘야 한다.

exe 를 패치하려고 헥스 에디터를 열었지만 exe 가 패킹되어있어서 위의 리소스를 쉽게 찾아볼 수 없었다.

exe 언패킹 시도는 실력이 없어 실패했고 대신 c# 으로 게임을 후킹 및 런타임 변조 하는 방식으로 meishoujo_kor.exe 를 만들었다.

패치한 내용은 다음과 같다.

1. 런처가 같은 폴더의 meishoujo.exe를 실행한다.

2. OpenProcess, ReadProcessMemory, WriteProcessMemory, VirtualProtectEx로 원본 프로세스 메모리에 접근한다.

3. 언패킹 완료를 특정 바이트 패턴으로 감지한 뒤, raw 파일 오프셋에 RawToVaDelta = 0x400C00을 더해 실제 메모리 주소를 계산한다.

4. 일본어 문자열 슬롯을 한국어 문자열 바이트로 덮어쓴다.

- 일반 게임/메뉴 문자열: 한국어를 CP949로 인코딩

- 설정 다이얼로그 리소스 문자열: UTF-16LE로 인코딩

- 포인터/구분자 등은 별도 HexPatch로 바이트 직접 수정

5. 폰트 생성부의 charset 값을 일본어 0x80에서 한글 0x81로 바꿔 GDI 텍스트가 한글 폰트/문자셋으로 렌더링되게 한다.

6. 설정창처럼 실행 중 Win32 컨트롤이 동적으로 생성하는 텍스트는 메모리 패치만으로 부족해서, SetWinEventHook으로 창 생성/이름 변경 이벤트를 감시하고 SetWindowTextW 및 콤보박스 항목 재삽입으로 일본어 UI를 한국어로 바꾼다.

7. 제품명 姪少女는 저장 폴더명 생성 전에 깨질 수 있으므로, 언패킹 감지 전부터 CP932 원본 바이트를 찾아 CP949 바이트로 먼저 교체한다. 단, 이름 자체는 한국어로 번역하지 않고 원래 한자명을 유지한다.