[Korean] 사전에 미리 설정하기 - dapucita/haxbotron GitHub Wiki
Language : English, Korean(한국어)
This manual is written in Korean.
사전에 미리 설정하기
봇에 관련된 여러 옵션들에 대해 설정을 미리 할 수 있습니다.
설정을 바꾸더라도 다시 빌드(컴파일)할 필요가 없어 편리합니다.
이전 버전에서 지원하던 트윅(tweaks) 기능도 이 방식으로 통합되었습니다.
설정하는 방법
먼저 게임 서버(core)가 위치한 디렉토리에 .env 파일을 생성해야 합니다.
.env 파일을 생성한 후 텍스트 편집기로 열어 필요한 설정을 기입한 후 저장하면 됩니다.
설정을 지정한 후에는 다시 빌드(컴파일)할 필요는 없지만, 변화를 반영하기 위해 봇을 재시작해야 합니다.
직접 설정하기 어렵다면 같이 배포되는 .env.sample 파일을 참고하면 됩니다.
주의사항
.env 파일을 다른 사람과 공유하는 것은 권장되지 않는 행위입니다.
특히 민감한 정보를 담아두었다면 외부로 유출되지 않도록 주의하는 것이 좋습니다.
.env 파일을 설정한 이후 봇의 구동에 오류가 발생한다면 값을 올바른 형식으로 입력했는지 다시 한 번 살펴봐야 합니다.
서버 접근 제어하기
포트 번호
SERVER_PORT를 설정하여 core 서버의 포트 번호를 수동으로 지정할 수 있습니다. (기본값 12001)
SERVER_PORT = 12001
core 서버의 IP 주소가 127.0.0.1이고 포트 번호를 12345로 지정하는 경우, 127.0.0.1:12345와 같은 주소로 웹 기반 관리 시스템을 이용할 수 있습니다.
IP주소 화이트리스트
SERVER_WHITELIST_IP를 설정하여 core 서버에 접근을 허용할 IP주소를 지정할 수 있습니다.
SERVER_WHITELIST_IP = "::ffff:127.0.0.1,127.0.0.1"
IP주소는 콤마(,)로 구분하며, 이 목록에 없는 컴퓨터는 core 서버에 접근할 수 없습니다.
관리 시스템 설정하기
JWT 비밀 키
JWT_SECRET를 설정하여 계정 인증 로직에 사용되는 JWT 비밀 키를 바꿀 수 있습니다.
JWT_SECRET = "임의의 키를 입력하세요"
이 비밀 키를 다른 사람과 공유해서는 안됩니다.
서버 연동하기
DB 서버 연동
SERVER_CONN_DB_HOST, SERVER_CONN_DB_PORT, SERVER_CONN_DB_APIVER를 설정하여 db 서버에 연결할 수 있습니다.
SERVER_CONN_DB_HOST를 설정하여 db 서버가 위치한 원격지의 IP 주소를 지정합니다.
SERVER_CONN_DB_PORT를 설정하여 원격지에 위치한 db 서버의 포트 번호를 지정합니다.
SERVER_CONN_DB_APIVER를 설정하여 사용할 API의 버전을 지정합니다.
SERVER_CONN_DB_HOST = "127.0.0.1"
SERVER_CONN_DB_PORT = "13000"
SERVER_CONN_DB_APIVER = "v1"
위와 같이 설정하면, 127.0.0.1:13000에 위치한 db 서버에 연결합니다.
여러가지 문제 해결하기 (트윅)
봇에 관련된 여러 문제를 해결하기 위해 트윅(tweaks) 부분을 설정할 수 있습니다.
헤드리스 모드
웹 브라우저 제어는 기본적으로 헤드리스(Headless) 모드로 이루어지지만, 디버그 등을 위해 이 옵션을 비활성화할 수 있습니다.
GUI가 지원되지 않는 서버 등의 환경에서는 이 옵션을 비활성화하면 서버가 제대로 구동되지 않을 수 있습니다.
비활성화하기 위해서는 false로 설정합니다.
TWEAKS_HEADLESSMODE = false
서버 환경에서 봇 구동하기 (Local IP WebRTC Anonymization)
vps와 같은 서버 등의 환경에서 다른 플레이어가 방에 접속하지 못하는 문제가 발생할 수 있습니다.
이 경우 이 옵션을 비활성화하면 접속이 가능할 수 있습니다. 비활성화하기 위해서는 false로 설정합니다.
TWEAKS_WEBRTCANOYM = false
방의 위치정보 고치기 (GeoLocation)
게임 목록에 표시되는 방의 국가(국기)와 거리가 실제와 다르게 표시된다면 이 옵션을 활성화하여 조정할 수 있습니다.
활성화하기 위해서는 true로 설정하며, CODE에 국가 코드, LAT에 위도, LON에 경도를 기입합니다.
위치정보에 대해서는 구글 맵 등을 참고하세요.
TWEAKS_GEOLOCATIONOVERRIDE = true
TWEAKS_GEOLOCATIONOVERRIDE_CODE = "KR"
TWEAKS_GEOLOCATIONOVERRIDE_LAT = 37.5665
TWEAKS_GEOLOCATIONOVERRIDE_LON = 126.978