AdeptiScanner-GI

원신(Genshin Impact)용 OCR 기반 인벤토리 스캐너로, 수동 모드와 자동 모드를 모두 지원합니다.

_사용 전에 아래 지침을 반드시 읽어주세요. 최신 버전 다운로드 링크는 여기에서 확인할 수 있습니다._

AdeptiScanner는 마이크로소프트에서 제공하는 몇 가지 도구를 필요로 하며, 이들은 게임에서 흔히 사용되므로 이미 설치되어 있을 가능성이 높습니다.

• 스캐너가 시작 시 오류를 발생시키면 해당 도구가 없을 수 있습니다. 설치 파일 다운로드 링크는 여기에서 찾을 수 있습니다. x86과 x64 둘 다 필요합니다

경고 및 중요 참고 사항

• 이 프로그램의 자동 스캔 모드가 작동하려면 관리자 권한으로 실행해야 합니다.
• 자동 모드 사용 시 프로그램이 마우스를 제어합니다. 스캔 중에 ESC 키를 눌러 일시정지할 수 있습니다. 일시정지 상태가 아니면 마우스를 움직이거나 사용하지 마세요.
• 원신 이용 약관(Genshin TOS)을 제 해석에 따르면, 이 스캐너의 사용은 부당한 경쟁 우위를 제공하지 않으므로 허용되어야 한다고 생각합니다. 제가 아는 한, 이 프로그램이나 유사 프로그램 사용으로 인해 문제를 겪은 사람은 없지만, 걱정된다면 자동 모드 사용을 피하는 것이 좋습니다.
• AdeptiScanner는 이미지 내 색상 값을 기반으로 내용을 식별합니다.
• 게임 내 색상을 변경하는 모든 요소가 결과에 영향을 줄 수 있습니다. 예를 들어 Reshade, Windows 야간 모드, F.lux, Nvidia 필터 및 색맹 보정 도구 등이 해당됩니다.
• 이미지 선명도 조정도 색상에 영향을 미칩니다. 가장 흔한 예는 AMD Radeon 소프트웨어의 "Radeon Image Sharpening"입니다.

새 버전 업데이트 방법

• 앱 내 선택적 업데이트 검사기가 있어 게임 데이터 업데이트 및 스캐너 업데이트를 알릴 수 있습니다.
• 게임 데이터 업데이트는 한 번의 클릭으로 처리할 수 있습니다.
• 스캐너 업데이트는 새 버전 다운로드 페이지를 열고 설정을 내보내 다음 실행 시 새 버전이 이를 가져올 수 있게 합니다.
• ScannerFiles 폴더 내 ArtifactInfo.json 파일을 최신 버전으로 교체하여 게임 데이터를 수동으로 업데이트할 수도 있습니다. 최신 버전은 여기에서 확인하세요.

무기 모드

• 무기 모드는 일반(성유물) 모드와 동일하게 사용합니다.
• 레벨별로 무기 목록을 정렬하는 것을 권장하며, 실제로 필요한 낮은 희귀도의 무기를 놓치는 것을 방지할 수 있습니다.
• 무기 모드에서 자동 기능을 사용할 경우, 한 페이지 내 무기 모두가 이미 스캔된 무기와 동일할 때 스캔이 중지됩니다. (성유물 모드에서는 하나만 동일해도 중지)

enka.network를 통한 캐릭터 불러오기

• (선택 사항) 성유물 및/또는 무기를 스캔합니다.
• 이를 통해 AdeptiScanner가 아직 불러오지 않은 보유 캐릭터를 표시할 수 있습니다.
• 프로필 쇼케이스가 캐릭터 상세 정보를 표시하도록 설정되어 있는지 확인합니다.
• 이 설정을 변경했다면, 타이틀 화면으로 나갔다가 다시 들어가 쇼케이스 데이터를 빠르게 새로 고칩니다.
• AdeptiScanner에서 Characters 탭을 열고 UID를 입력한 뒤 Fetch 버튼을 클릭합니다.
• 쇼케이스 캐릭터를 변경하고 3단계부터 반복합니다.
• 1단계를 수행했다면, Fetch 버튼 아래 텍스트 박스에 아직 불러오지 않았지만 스캔 결과에 따라 보유 중인 캐릭터 목록이 표시됩니다.
• 타이틀 화면으로 나갔다가 다시 들어가 쇼케이스 데이터를 빠르게 새로 고칠 수 있습니다.

스캔 준비 방법

• 게임을 1600x900 해상도의 창 모드로 설정하는 것을 권장하지만 필수는 아닙니다.
• 다른 화면 비율과 해상도도 작동할 가능성이 있지만 동일한 정도로 테스트되지 않았습니다.
• 전체 화면 모드는 작동하지만 고급 -> 프로세스 핸들 기능 설정을 활성화해야 합니다 (기본값으로 활성화됨).
• 메인 가방에서 유물 섹션을 열고 전체 길이 아이템 설명이 있는 5성 유물을 선택하세요.
• "캡처"를 누르세요.
• 미리보기가 좋은 예와 일치하는지 확인하세요. 일치하지 않으면 게임 내에서 카메라를 약간 움직여 배경을 변경한 후 2단계부터 다시 시도하세요
• 여행자 이름 텍스트 상자에 게임 내 이름/여행자 이름을 입력하세요.
• 입력하지 않으면 장착된 유물이 잘못된 캐릭터에게 장착된 것으로 인식되거나 전혀 장착되지 않은 것으로 잘못 감지될 수 있습니다.
• 방랑자 이름에 대한 동등한 설정도 있습니다.

이제 수동 또는 자동 유물 스캔 준비가 완료되었습니다.

수동 스캔

• 스캔 준비 방법 지침을 따르세요. 스캔 중에는 게임 창을 이동하거나 캡처 영역을 가리지 마세요.
• 스캔할 유물을 선택하고 통계 읽기 버튼을 누르세요.
• 스캐너는 주로 4성 및 5성 유물에 대해 테스트되었습니다. 모든 등급의 유물 정보를 가지고 있지만 낮은 등급의 일부는 읽지 못할 수 있습니다.
• 수동으로 스캔할 모든 유물에 대해 2단계를 반복하세요.

자동 스캔

• 자동 모드 사용 시 프로그램이 마우스를 제어합니다. 스캔 중에 ESC 키를 눌러 일시 중지할 수 있습니다.
• 일시 중지 상태가 아니면 마우스를 이동하거나 사용하지 마세요.
• 자동 스캔은 관리자 권한으로 실행할 때만 제대로 작동합니다.
• 자동 스캔은 전체 유물 인벤토리를 스크롤하며, 내보내기 시 필터가 적용됩니다.
• 스캔 준비 방법 지침을 따르세요.
• 유물 목록을 스크롤하여 상단 행의 별과 하단 행의 흰색/베이지색 라벨이 둘 다 완전히 보이도록 약간의 여유를 두세요.
• 자동 시작 버튼을 누르세요.
• 스캔 중에 키보드의 ESC 버튼을 눌러 일시 중지할 수 있습니다.
• 재개 버튼은 스캐너가 스캔을 다시 시작하게 합니다.
• 처리 후 중지는 새 유물 스크롤을 즉시 멈추고 스캔된 유물 처리만 완료합니다.
• 즉시 중지는 스캐너가 즉시 자동 스캔을 종료하며 스캔된 유물을 저장하지 않습니다.
• 스캐너는 유물 목록 스크롤이 끝났거나 이전과 동일한 통계의 유물을 발견하면 자동으로 멈춥니다.
• 너무 일찍 멈추면(예: 동일한 유물이 두 개 이상 있을 때) 수동으로 다음 화면으로 스크롤한 후 자동 시작을 누르세요. 이전 결과는 자동으로 삭제되지 않습니다.

결과 내보내기

• 수동, 자동 스캔 또는 두 방식을 조합하여 유물을 스캔하세요.
• 내보내기 필터 섹션을 원하는 대로 구성하세요.
• 아티팩트 세부 정보 외 모든 내용이 복사될 GOOD 형식 템플릿 파일을 사용할 수 있습니다. 이를 위해 ScannerFiles 폴더에 GOOD 형식 JSON을 넣고 이름을 ExportTemplate.json으로 변경하세요.
• 원한다면 여러 GOOD 형식 JSON의 유물을 고급 -> 유물 파일 불러오기 버튼으로 결합할 수 있습니다. 이때 중복 감지는 없습니다.
• 결과 내보내기 버튼을 누르면 결과가 타임스탬프가 붙은 파일로 ScannerFiles 폴더에 저장됩니다.
• 내보내기 필터를 변경하고 내보내기 버튼을 여러 번 눌러도 되며, 각 내보내기는 별도의 파일로 나타납니다.

관리자 권한 없이 실행하거나 프로세스 핸들 기능이 없을 때의 특별 정보

클릭하여 확장

이러한 조건에서는 다음과 같은 추가 요구 사항이 적용됩니다

• 전체화면 모드의 원신은 지원되지 않습니다
• 캡처 프로세스가 자동으로 게임에 포커스를 전환할 수 없으므로, 캡처 프로세스나 게임 창을 스캔하는 기타 기능 동안 게임 창이 가려지면 안 됩니다
• 게임을 캡처하려면 기본 모니터에 있어야 하며, 화면 중앙을 덮고 흰색 창 헤더가 보여야 합니다 (메모장 등으로 "가짜"로 만들 수 있음)
• 1080p 모니터에서 이러한 조건을 만족하는 예제 이미지

연락 방법

• 이 저장소에 이슈 또는 풀 리퀘스트를 생성하세요
• 관심이 얼마나 있을지 몰라 Discord 서버를 만들지 않았습니다. 필요하면 나중에 만들 예정입니다
• 커뮤니티에서 만든 원신 개발자 Discord에 있으며, 여기 사용자명과 같습니다
• 또한 원신 옵티마이저 Discord에도 있습니다. 작은 문제는 저를 @해도 되지만, 긴 내용은 원신 개발자 Discord나 DM으로 연락하는 것이 좋습니다

감사의 말

• 캐릭터 임포팅은 API Enka.Network에 의존합니다
• 일부 기능은 워프레임용 OCR 기반 동반 프로그램인 WFInfo의 코드를 많이 참고했습니다
• 사용된 테서랙트 모델은 이 유사 프로그램 제작자가 훈련 및 제공했습니다
• 이 스캐너의 주요 목적은 아티팩트를 원신 옵티마이저에 더 쉽게 임포트하기 위함이지만, GOOD 포맷을 사용하는 다른 프로그램과도 호환되어야 합니다

--- Tranlated By Open Ai Tx | Last indexed: 2026-05-04 ---