Language : English, Korean(한국어)

---

이 문서는 0.4.0 버전을 기준으로 작성되었습니다.

처음 시작하기

Haxbotron를 선택하신 것을 환영합니다.

Haxbotron을 사용하여 Haxball 게임의 봇방을 운영할 수 있습니다.

설치, 빌드, 실행의 세 과정을 거치면 바로 시작할 수 있습니다.

이 문서는 Windows 10 64bit 환경을 가정하여 설명할 것입니다. Linux, OS X 등의 환경에서도 비슷한 방식입니다.

설치하기

1단계. Node.js 설치

봇방을 운영하려면 Node.js를 먼저 설치하여야 합니다.

Node.js는 Chrome V8 엔진을 사용하는 Javascript 런타임입니다.

Node.js 홈페이지에 접속하여 LTS 버전(10.x, 14.x 등)을 다운로드하고 설치합니다.

2단계. 다운로드 및 압축해제

Haxbotron을 다운로드하기 위해 먼저 메인 화면에 가서 우측 메뉴의 Releases 항목을 여세요.

원하는 버전의 압축파일을 다운로드해서 적당한 위치에 압축해제 합니다.

압축해제한 폴더의 경로는 임의로 바꿔도 괜찮지만 나중에 봇 실행에 불편함이 없도록 간결한 이름을 사용할 것을 추천합니다.

이 문서에서 설명할때는 C:\haxbotron 에 압축해제한 것으로 가정합니다.

3단계. 명령 프롬프트 실행 및 경로 이동

명령 프롬프트(cmd)를 켠 후 명령어를 입력해 압축해제한 폴더로 경로이동합니다.

윈도우 키+R키를 누르면 나오는 실행 창에 cmd를 입력하면 명령 프롬프트를 빠르게 켤 수 있습니다.

cd c:\haxbotron

만약 C드라이브 대신 D, E와 같은 다른 드라이브에 압축해제하였다면 cd 명령어를 사용하기 전에, D: 혹은 E: 와 같은 방식으로 먼저 경로이동을 하여야 합니다.

경로를 이동하면 게임 서버에 해당하는 core와 DB 서버에 해당하는 db 폴더를 확인할 수 있습니다.

4단계. 패키지 설치 및 빌드

core와 db 서버를 실행하기 위해서는 먼저 패키지 설치와 빌드를 해야 합니다.

두 서버를 한 번에 설치하고 빌드하는 편리한 명령어가 있습니다.

먼저 다음 명령어를 입력하여 필요한 패키지를 설치합니다.

npm run quick:install

또한 다음 명령어를 입력하여 빌드하도록 합니다.

npm run quick:build

빌드에 너무 많은 시간이 소요되어 진척이 없다면, 이 문서를 참고하세요.

5단계. 서버 실행하기

설치 및 빌드를 완료했다면 이제 서버를 실행할 수 있습니다.

Haxbotron을 사용하기 위해서는 core 서버와 db 서버를 모두 실행해야 합니다.

먼저 db 서버를 실행하도록 합니다.

npm run quick:start:db

다음으로 명령 프롬프트 창을 새로 열고 core 서버를 실행하도록 합니다.

npm run quick:start:core

거의 다 되었습니다! db 서버와 core 서버를 모두 실행하였습니다.

설치, 빌드, 실행을 마쳤다면 곧바로 웹 기반 관리 시스템을 사용할 수 있습니다.

Haxbotron을 사용 중에는 db 서버와 core 서버를 계속 켜두어야 합니다.

6단계. 서버 관리하기

서버를 실행하였다고 방이 바로 열리는 것은 아닙니다.

우선 웹 기반 관리 시스템에 접속하도록 합니다.

크롬 등의 웹 브라우저를 열고 127.0.0.1:12001에 접속하세요.

인터넷 익스플로러(IE)와 같은 구식 브라우저는 제대로 지원되지 않을 수 있습니다. 최신 웹 브라우저를 사용하세요.

이번이 첫 실행이므로 관리자 계정을 생성해야 합니다. Installation을 클릭하세요.

관리자 계정으로 사용될 아이디와 비밀번호를 입력하고 생성하세요.

관리자 계정은 게임 내에서의 슈퍼 어드민과는 다르며, 서버 자체를 관리하기 위해 사용되므로 다른 사람과 공유하지 마세요.

관리자 계정이 만들어진 후에는 자동으로 관리 페이지로 이동됩니다. 앞으로도 이 계정을 사용하여 관리 시스템에 로그인할 수 있습니다.

'Room List' 메뉴를 클릭하면 전체 방 목록을 볼 수 있습니다. 클릭하세요.

사이드 메뉴의 'Create New Room'을 클릭하여 방을 새로 열 수 있습니다. 클릭하세요.

방을 새로 열 때는 고유의 RUID와 인증 토큰이 필요합니다.

RUID(Room Unique Identifier)는 각 방을 구분해주는 식별자입니다.

RUID가 달라야 서로 다른 방으로 취급되므로, 이미 사용중인 RUID를 재사용해서는 안됩니다.

나중에 방을 닫았다가 다시 여는 경우, 기존의 데이터를 불러오고 싶으면 이전에 사용했던 RUID를 다시 사용하면 됩니다.

인증 토큰은 방을 열기 위해 꼭 필요하며, Haxball Headless Host가 발급해줍니다. 입력 창 옆의 버튼을 클릭하여 발급받으세요.

Token obtained: "이 부분이 인증 토큰입니다"

이미 사용중인 인증 토큰을 재사용해서는 안됩니다. 인증 토큰은 일정 시간이 경과하면 만료되므로 다시 발급받으세요.

다른 설정 값들은 필요에 따라 알맞게 바꾸면 됩니다. 위키에 있는 문서들을 읽어보세요.

양식을 제대로 채웠다면 방이 잘 열릴 것입니다. 확인해보세요!

웹 기반 관리 시스템은 자유롭게 켜고 꺼도 됩니다. 단, core 서버와 db 서버를 끄면 봇이 멈추므로 사용 중에는 종료하지 마세요.

다음 단계로

위 과정을 그대로 따라했다면 서버가 기본 값으로 설정됩니다.

보안을 강화하고 세부적으로 설정하려면 다음 문서들을 읽어보세요.

• 사전에 미리 설정하기
• 고급 설정하기
• 방 세부 설정
• 맵 추가
• 번역 변경