이전 버전 시연영상

이전 버전 스크립트

준비물:

• TemperMonkey(크롬) 또는 GreaseMonkey(파이어폭스)
• Genshin-Paisitioning-App (설명은 아래 참조)

Genshin-Paisitioning 프로젝트는

실시간으로 원신 화면을 캡쳐해 미니맵을 이미지 인식해서

현재 위치를 게임닷 맵스 사이트 화면에 띄워주는 프로그램/스크립트임.

(이전 버전의 스크립트는 여전히 cocogoat와 함께 사용 가능하지만, 더이상 업데이트는 하지 않을 것임.)

이 프로젝트는 크게 두 가지로 구성된다.

1. Genshin Paisitioning App (줄여서 GPA라고 부르겠음)
2. Genshin Paisitioning Script (줄여서 GPS라고 부르겠음)

Genshin Paisitioning App (이하 GPA, 원붕이들 학점 얘기하는 거 아님)

원신 게임 화면을 캡쳐하고 위치 정보를 웹 페이지로 전송하기 위한 런타임 프로그램이다.

설치 방법:

1. 링크에서 genshin_paisitioning_app.zip을 다운로드 받는다.
2. zip파일 내부의 genshin_paisitioning_app.exe를 실행한다.
3. 실행하면 관리자 권한을 요구한다, 수락. (설치시에만 요구함)
4. 설치 완료 (설치 위치 %localappdata%\genshin-paisitioning)
5. 주의: zip 파일 안의 exe를 %localappdata%\genshin-paisitioning 경로에 넣으라는 것이 아님!
   genshin_paisitioning_app.exe는 실행된 경로가 위 경로가 아닐때에만 설치 과정을 진행한다.

삭제 방법:

1. 제어판 - 프로그램 제거 - [원신 파이지셔닝] 우클릭 - [제거/변경(U)]
2. (윈11 이라면, 또는) 설정 - 앱 - 설치된 앱 - [원신 파이지셔닝] 검색 - […] 선택 - [제거]
3. [윈도우 키]+[R] 키 - %localappdata% 입력 - genshin-paisitioning 폴더 찾아보고, 있다면 삭제 (없을 수도 있음)

GPA는 이전 버전의 cocogoat 프로그램을 대체하기 위해

Rust언어를 이용해 새로 작성됐음.

cocogoat를 대체하고자 한 주된 이유:

1. 인터페이스 및 오류 내용이 중국어라 사용하기 어려움.
2. 구버전의 cvAutoTrack 사용을 강제함, 신맵 업데이트가 이루어져도 지원 버전 갱신이 느려서 신맵에 제때 적용할 수 없음.
3. cvAutoTrack 라이브러리 사용 이외에도 다른 기능들이 포함돼있는 프로그램이라 안전하다고 안심하기 어려움.
4. 추가 기능 확장에 제한이 있음.
5. 동작 과정이나 세세한 원리를 본인이 모르기 때문에 다른 원붕이들의 질문에 적극적으로 답변해주는것이 제한됨.

GPA의 동작 구조:

cvAutoTrack ==라이브러리로 호출됨=> GPA <= WebSocket으로 상호 통신 => GPS <= UI로 상호 작용 => 브라우저

GPA의 실행 과정은 기술적인 내용이 많이 포함되기 때문에 추후에 Github에 README 내용으로 올리거나 하겠음.

Genshin Paisitioning Script (이하 GPS)

브라우저에서 GPA와 통신하고, 전달받은 인게임 위치를 맵스 화면에 찍어주기 위한 유저스크립트이다.

아직까지 자잘자잘한 버그가 존재하는 수준이나, 실사용에는 문제가 없음.

 설치 방법:

1. TemperMonkey 또는 GreaseMonkey를 설치, (Beta 버전 유무 상관없으나, 잘 아는게 아니라면 Stable 추천)
2.  클릭
   
   
   
3. 클릭
   
   
   

4. https://github.com/Haytsir/Genshin-Paisitioning-Script/raw/gh-pages/userscript/genshin-paisitioning-script.user.js

   링크 복사
   
   
   
5. 
   붙여넣고 [설치] 클릭
   
   
   
6. 
   나는 이미 설치돼있어서 재설치로 보임, [설치] 클릭, 완료

 삭제 방법:

1. 
   TemperMonkey 또는 GreaseMonkey [대시보드] 클릭
   
   
   
2. 
   
   원신-파이지셔닝 스크립트 항목의 쓰레기통 아이콘 클릭
   
   
3. 
   우측 위 탭을 보면 쓰레기통 아이콘이 생겨 있음, 클릭
   
   
   
4. 
   [삭제] 클릭

사용 방법:

게임 내 [설정] - [기타] - [미니맵 고정: 방향 고정]으로 설정

게임닷 맵스 열면 실시간 연결 버튼이 생김

이 버튼을 누르면 GPA를 실행하고,

GPS가 GPA를 준비된 상태로 만들기 위해 업데이트 버전 등등을 점검하고

GPA에게 원신 화면을 인식 시작하라는 명령을 보냄

즉, 실질적인 화면 인식 처리 등등은 GPA에서 실행하지만,

사용자 인터페이스를 가지고 사용자와 상호작용 하는건 GPS임.

QnA:

1. 이거 쓰면 상자 먹은것도 자동으로 체크됨?
   ㄴ
   
   
2. 안전한거임? 정지먹는 거 아님?
   당연히 확신할 수는 없고, 선택은 사용자의 몫임
   다만 이미 fps_unlocker 처럼 엔진 외부에 직접 달라붙어서 메모리 조작하는 프로그램이나,
   Inventory Kamera (Genshin Optimizer 캡쳐 툴)을 써봤다면,
   GPA가 밴 대상이라면 이들도 다 밴 대상이라는 것을 알아야 함.
   
   
3. GPA 프로그램 어떻게 끔?
   GPA는 GPS와 일단 한 번 연결이 되었다면,
   GPS로부터 완전히 연결이 끊겼을 때 자동으로 종료되게 돼있음
   하지만 GPS가 연결되지 않은 상태에서 끄고싶다면
   
   트레이에서 수동 종료할 수 있음
   
   
4. 작동이 안되는 거 같은데 (GPA-GPS 연결 자체가 안될 경우)
   GPA를 수동으로 종료한 뒤, 게임닷 맵스를 새로고침하고 다시 [실시간 연결]을 시도해보길 바람
   수 차례 해도 똑같은 상황이라면 댓글이나 깃허브 Issue 등록시 자세한 상황을 말해주면 검토해보겠음
   또는 자바 스크립트 또는 브라우저 콘솔을 다룰 줄 아는 사람이라면
   [실시간 연결] 버튼을 우측 마우스 클릭하면 GPS가 debug 모드로 진입하니
   문제 내용과 함께 WebSocket 통신 과정에서 받은 Object  내용을 펼쳐 보여준다면 더 도움이 될 듯
   
   
5. 위치를 얻는 도중 오류가 발생했다고 계속 뜸
   GPA-GPS 서로 연결은 됐지만
   GPA가 사용하는 cvAutoTrack이 원신 화면을 캡쳐하지 못했거나,
   원신 화면은 캡쳐했는데 미니맵을 읽지 못했거나,
   미니맵에서 위치, 방향 등을 찾아내지 못한 경우임.
   사용자에 따라서 여러 원인이 있을 수 있는데, 주된 이유는
   Nvidia 또는 Amd 그래픽 필터 또는 외부 그래픽 옵션 사용
   프레임/리소스 출력 프로그램이 미니맵이나 페이몬(메뉴) 아이콘을 가림
   미니맵이 방향 고정돼있지 않음
   등이 대표적임.
   
   
6. genshin_paisitioning_app.exe 실행 시 아래 화면의 창이 뜨지 않을 경우
   
   관리자 권한 요구 자체가 안떴다면, 
   윈도우 [시작] - [cmd 검색] - [관리자 권한으로 실행]
   

   %localappdata%\genshin-paisitioning\genshin_paisitioning_app.exe --install

   
   복사 후 붙여넣기 했을때 위 창이 나타나는지 확인
   
   
7.  작동은 되는데 화살표 마커가 뚝뚝 끊기고(버벅 거리고) 순간이동하고 난리침
   위에서도 수 차례 말했지만 이건 게임 화면을 캡쳐해서 캡쳐된 이미지를 토대로 위치를 특정하는 방식이기 때문에 브라우저에 표시된 위치가 실제 게임 위치와 다르거나 인식을 잘 못하는 지역에 있다면 순간이동처럼 막 이상한 데 찍는 경우가 있음. 이는 왠만해선 컴퓨터의 리소스가 딸리거나 하는 문제가 아님, 원붕이 컴퓨터가 4기가램 쓰고 그런 환경이 아니라면.
   
   
8. 유저 스크립트 수동 업데이트 방법(크롬 기준)
   
   
   왼쪽 마우스 클릭

   해당 아이콘이 없다면 퍼즐 모양 눌러서 보면 있음

   다른 브라우저에서도 비슷한 방식
   
   
   도구 밑 유저 스크립트 업데이트 확인

테스트 환경:
: 의도한 방식으로 작동함.
: 해당 환경에서 테스트 하지 않음, 동작은 할 것이지만, 처리되지 못한 버그 발생 가능.

GPS 또는 GPA 기능 제안,
코드 수정(Pull Request)
문제(Issue) 등을 내는 것은 언제나 환영이고,
Pull Request나 Issue 작성은 각각 GPS/GPA 깃허브에 해주길 바람.

변경점:

23-04-24

GPA v1.1.4

릴리즈

바이러스 토탈 (v1.1.4)

GPS v1.6.3

릴리즈

GPA v1.1.5
cvAutoTrack가 없는 상태에서 업데이트를 시도할 시 동작이 중단되는 버그 수정.

debug 모드로 실행시, 로그 파일을 생성하도록 변경.
바이러스 토탈 (v1.1.5)

GPS v1.6.4

라이브러리 및 GPA 업데이트 중 다이얼로그에 발생하는 문제 수정.

GPS v1.6.5

라이브러리 업데이트 도중 다운로드 상황을 표시하는 다이얼로그가 표시되지 않는 문제 수정.
플레이어가 다른 맵(연하궁/층암거연)에 있을때 위치가 표시되지않는 문제 수정

23-04-25

GPS v1.6.6

다이얼로그 최소화 기능 추가

GPS v1.6.7

여러 화면 크기 지원

GPA v1.1.6

캡쳐 간격과 딜레이의 최소값 제한

바이러스 토탈 (v1.1.6)

GPS v1.6.8

마이너 픽?스

알려진 문제점:

GPA:

• cvAutoTrack에서 내보내는 오류가 정상적으로 GPS에 전달되지 않음

GPS:

• 플레이어가 실제로 존재하는 맵과, 현재 맵스에 표시된 맵이 다를 때에도 플레이어 마커가 의도치 않은 위치에 표시됨.
• cvAutoTrack 로드에 실패했을 때에도 설정 메뉴가 표시
• 비트블럭(BitBlt) 캡쳐 모드가 적용되지 않음
  => 이는 현재 BitBltCapture모드와 DxCapture모드를 서로 변경하여도 똑같이 캡쳐 과정에서 오류가 발생해서
  추후 검토후 실적용하기 위해 GPA내부에서 비활성화된 상태임
• 게임닷의 가로뷰 모바일 버전 UI에서 다이얼로그가 감춰지지 않음 => 수정 v1.6.7
  
  

4.0버전부터 인게임 지하맵 기능이 생겨서

cvAutoTrack, 게임닷맵스 기능 부분에서도 많은 변화가 있을걸로 예상된다

GPA / GPS에서 기능을 추가한다면

인게임에서 지하에 왔다면 맵스에서도 자동으로 해당 지하 지도를 밝혀주는 정도일 거 같음

cvAutoTrack에서 지상지도와 지하지도를 따로 구분해서 인식하는 게 마냥 간단한 방법이 아니라서 이쪽에서 기능을 추가하는 데에도 시간이 좀 걸릴거고

이를 어떻게 구현할 건지 확인한 뒤에 GPA쪽에도 코드를 변경해야 하는데

요즘 장시간동안 코딩할 수 없는 환경이라 파이지셔닝 기능 구현에도 시간이 추가로 걸릴듯함