1) 게임 설치 폴더에서 JSON 자동 생성 + 바로 불러오기 권장
검은사막 재료계산기 실행.bat 로 계산기를 실행한 경우 이 버튼 하나로 처리할 수 있습니다. 버튼을 누르면 ① 검은사막 설치 폴더 선택 → ② 현재 프로그램 폴더의 DB 덮어쓰기 확인 → ③ items.json/recipes.json/item_names_ko.json 자동 생성·교체 → ④ 현재 계산기에 자동 불러오기 순서로 진행됩니다.
게임 폴더 선택 → JSON 자동 생성 및 불러오기
저장 위치 선택 없음 · 현재 프로그램 DB를 확인 후 자동 교체
자동 생성 도우미 상태 확인
자동 생성 도우미 상태를 확인하지 않았습니다.
폴더 선택과 DB 덮어쓰기 확인을 마치면 이곳에 데이터 업데이트 중 과 경과 시간이 표시됩니다. 추출/한국어 이름 생성/DB 교체/계산기 반영이 모두 끝나면 데이터 관리 창은 자동으로 닫힙니다.
R12: JSON 생성 후 items.json → recipes.json → 한국어 아이템명 → 관계 변환 → DB 반영 순서로 처리합니다. 설치 폴더에 한국어 LOC가 실제로 있으면 그것을 우선하고, 없으면 Paz 안의 itemenchant.dbss에 들어 있는 한국어 원본 Name을 직접 읽습니다.
게임 폴더는 내부에 Paz\pad00000.meta가 있는 폴더를 선택하면 됩니다. 한국 클라이언트에서는 설치 폴더의 languagedata_kr.loc/languagedata_ko.loc가 실제로 있으면 그것을 우선 사용하고, 없으면 Paz 내부 itemenchant의 한국어 원본 Name을 사용합니다. 영어 LOC는 전체 JSON을 만드는 extractor 호환용으로만 사용합니다. 실제 검은사막 설치 폴더에는 어떤 파일도 추가·변경하지 않습니다. 별도의 저장 폴더는 선택하지 않습니다. 새 DB는 압축을 푼 계산기의 _program 폴더에 있는 items.json, recipes.json, item_names_ko.json을 확인 후 자동으로 덮어씁니다.
HTML 파일을 직접 더블클릭해서 연 경우: 웹 브라우저 보안 때문에 HTML 자체가 Windows 프로그램을 실행할 수 없습니다. 압축을 푼 폴더의 맨 위에 있는 검은사막 재료계산기 실행.bat 를 실행하면 로컬 도우미가 켜지고 위 자동 생성 버튼을 사용할 수 있습니다. 수동 JSON 불러오기는 HTML 단독 실행에서도 계속 사용할 수 있습니다.
2) 이미 생성한 items.json / recipes.json 수동 불러오기
이 계산기는 bdo-data-extractor 형식의 items.json과 recipes.json을 직접 읽습니다. R12에서도 불러온 DB를 영구 저장합니다. 영어 전용 JSON은 한국어 이름 생성 · 적용 을 한 번 실행하면 목록/상세/재료까지 모두 한국어 표시명으로 바뀌고 저장됩니다.
item_names_ko.json (선택) R12가 설치된 클라이언트에서 만든 한국어 아이템 이름 매핑 파일입니다. 기존 영어 items.json을 불러올 때 함께 선택하면 한국어 표시명이 적용됩니다.
추출 DB로 교체 (권장) 내장 DB와 합치기
한국어 이름 생성 · 적용 게임 설치 폴더만 선택하면 설치된 한국 클라이언트의 한국어 아이템명을 생성해 현재 DB 전체에 적용합니다. recipes.json을 다시 선택할 필요가 없습니다.
R12: items.json의 아이템 설명에 적힌 대체 재료와 요리/연금 Ingredients를 읽고, 공통 요리·연금 대체 그룹/상위 등급 규칙을 자동으로 보완합니다. 포함된 R12 데이터는 처음 실행 BAT로 실행할 때 자동 적용됩니다.
3) 별도 한글 이름 매핑 CSV (선택)
추출 DB가 영어 이름이면 item_id,name_ko 형식 CSV를 불러와 한글 표시명으로 바꿀 수 있습니다. 기존 이름은 검색 별칭으로 유지됩니다.
4) 사용자 DB 백업/복원
이 HTML의 현재 아이템/레시피/대체재/상위재료 규칙 전체를 JSON으로 백업하거나 다시 불러올 수 있습니다.
현재 DB JSON 저장 DB JSON 불러오기 내장 예시 DB로 초기화
5) items.json / recipes.json은 어디에 있나요?
중요: items.json과 recipes.json은 검은사막 설치 폴더에 원래 들어 있는 파일을 찾아서 복사하는 방식이 아닙니다. bdo-data-extractor 가 본인 PC에 설치된 검은사막 클라이언트의 PAZ·레시피 XML·아이템 데이터를 읽고 새로 만들어 주는 출력 파일입니다. R10은 추가로 설치 클라이언트의 한국어 아이템명을 읽어 item_names_ko.json도 만듭니다.
프로젝트 문서 기준 기본 Steam 설치 폴더는 아래 위치입니다.
C:\Program Files (x86)\Steam\steamapps\common\Black Desert Online
Steam이 아닌 설치본이거나 다른 드라이브에 설치했다면 게임 폴더 안에 Paz\pad00000.meta가 존재하는지 확인하세요. Paz 폴더의 바로 상위 폴더를 --game 경로로 지정하면 됩니다.
6) 자동 생성 도우미 없이 직접 생성하는 방법
① 먼저 Go 1.26 이상 을 설치한 뒤 새 PowerShell 또는 명령 프롬프트를 엽니다.
② 추출기를 설치합니다.
go install github.com/idevelopthings/bdo-data-extractor@latest
③ JSON이 생성될 위치를 헷갈리지 않도록 전용 폴더를 하나 만든 뒤 그 폴더로 이동합니다.
mkdir C:\BDO_Recipe_Data
cd C:\BDO_Recipe_Data
④ Steam 기본 설치라면 다음 명령을 실행합니다. 프로젝트 문서상 build의 기본 출력은 현재 작업 폴더 아래 data입니다.
bdo-data-extractor build --game "C:\Program Files (x86)\Steam\steamapps\common\Black Desert Online"
한국 공식 클라이언트(C:\Pearlabyss\BlackDesert 등)는 ads\languagedata_en.loc가 없기 때문에 위 명령을 직접 실행하면 이번에 보신 것과 같은 오류가 날 수 있습니다. 한국 클라이언트에서는 위의 자동 생성 버튼 을 사용하는 것을 권장합니다. 도우미가 보조 LOC와 임시 가상 게임 폴더를 자동으로 준비합니다.
⑤ 완료 후 아래 두 파일을 데이터 관리 → 이미 생성한 items.json / recipes.json 수동 불러오기 에서 선택합니다. 한국어 표시가 필요하면 위의 한국어 이름 생성 · 적용 버튼을 추가로 사용할 수 있습니다.
C:\BDO_Recipe_Data\data\items.json
C:\BDO_Recipe_Data\data\recipes.json
게임이 예를 들어 D:\Games\Black Desert에 있다면 명령의 --game 부분만 실제 경로로 바꾸면 됩니다. 기준은 D:\Games\Black Desert\Paz\pad00000.meta가 실제로 존재하는 폴더입니다.
7) 명령어가 인식되지 않거나 출력 위치를 직접 정하고 싶을 때
bdo-data-extractor가 “명령을 찾을 수 없음”으로 나오면 아래 명령으로 Go 설치 경로를 확인할 수 있습니다. GOBIN이 비어 있으면 기본 설치에서는 GOPATH\bin을 확인하면 됩니다.
go env GOBIN
go env GOPATH
또한 추출기는 --out <폴더> 옵션을 지원하므로 출력 위치를 명시할 수도 있습니다.
bdo-data-extractor build --game "C:\Program Files (x86)\Steam\steamapps\common\Black Desert Online" --out "C:\BDO_Recipe_Data\data"
한국 클라이언트 안내: bdo-data-extractor의 --lang 선택지는 제한되어 있으므로 전체 JSON 생성에는 호환용 LOC를 사용합니다. 한국어 표시는 별도로 설치 클라이언트의 한국어 Name을 추출해 덮어쓰며, 기존 영어 이름은 검색 별칭으로 보존합니다.
추출기는 게임 설치 폴더를 읽기 전용 으로 사용하며, 이 계산기 자체는 게임 메모리나 계정에 접근하지 않습니다.