귀여운 촌아의 작은상자

가장 먼저 npc를 추가해보도록 하겠습니다.

텍스트 형식의 올바른(오류가 없는) npc 스크립트 파일을 원하는 폴더에 위치시킵니다.

(위에는 직접 만든 머리의 모양, 색깔, 옷의 색 등을 바꾸어는 npc 입니다.)

그 다음 상위 폴더인 npc 폴더의 script_custom.conf를 텍스트 편집기 등을 이용하여 열고

아래와 같이 추가한 npc 스크립트 파일이 있는 경로와 파일명을 추가하면 됩니다.

이로써 npc를 서버에 추가하는 것은 끝나게 됩니다.

위의 script_custom.conf 파일 안을 보면 알겠지만 주석 처리된 부분은 서버 구동시

읽어들이지 않기 때문에 npc가 나타나지 않게 됩니다.

또한 npc들은 서버가 처음 구동될 때 모두 읽어들이고 서버가 구동되는 동안에는

추가하거나 수정해도 서버 내에서 바뀐 내용이 반영되지 않습니다.

즉, 다시 서버를 구동하거나 스크립트를 reload해야만 합니다.

스크립트가 제대로 읽어들여지고 문제가 없다면 다음과 같이 서버가 구동될 것입니다.

만약 문제가 있다면 해당 스크립트 파일의 오류 부분을 보여주고 해당 npc는 서버에 로드되지 않습니다.

한가지 팁으로 Hercules의 에뮬에는 스크립트 체커 script checker가 있는데

이를 이용하면 실제로 서버를 구동하여 스크립트에 문제가 있는지 알아봐야하는 수고를 덜어 줍니다.

위의 script-checker.bat를 실행하면 아래와 같은 도스창이 열리는데

여기에 확인해볼 스크립트 파일의 경로를 직접 적어주거나

스크립트 체크를 해볼 txt 파일을 드래그 앤 드롭하면 됩니다.

스크립트에 문제가 없다면 아무런 메시지도 나오지 않지만 스크립트에

문법적 오류가 있다면 다음과 같이 출력이 됩니다.

오류가 발생한 스크립트 파일 안의 구문 위치와 대략 어떤 문법 오류인지 알려주기 때문에

스크립트를 만들 때 큰 도움이 됩니다.

이 전의 가이드에서는 char-server.conf와 map-server.conf는 userid/passwd만 수정하였습니다. 이번에는 userid/passwd를 제외한 나머지 부분을 설명하겠습니다.

먼저 char-server.conf 파일을 열어보면 각 라인(줄)의 가장 왼쪽,

즉 처음 부분에 // 이 있는 것과 없는 것이 나오게 되는데 // 이러한 기호가 앞에 있는 줄은 주석이고 사용자의 편의를 위해 있는 부분입니다.

다시 말해 // 이 기호가 앞에 나오는 줄은 서버의 설정에 영향을 미치지 않는 부분이며 실제로 서버의 설정에 영향을 주는 부분은 // 이 기호가 없는 부분이 됩니다.

따라서 주석을 지워도 설정에는 무방하고 주석이 없는 줄을 지우거나 잘못된 설정 값을 대입하면 오류가 발생합니다.

또한 반드시 // 슬래쉬가 연속해서 두개가 있어야 주석처리가 되며 이 주석의 글은 각 설정에 대한 설명이므로 잘 읽어보는 것이 좋습니다.

char-server.conf

를 메모장 (또는 기타 텍스트 에디터)를 이용하여 열어보면 userid/passwd 다음에

server_name: rAthena

가 있습니다. 말 그대로 서버 이름을 넣는 곳이고 윗 줄의 주석 설명을 읽어보면 공백이나 윈도우의 파일 이름에 허용되지 않는 문자를 사용하지 말라고 되어 있습니다.

위의 사항을 지켜주면서 서버 이름을 rAthena 대신 원하는 것으로 바꾸어주면 됩니다. 다음에는

wisp_server_name: Server

먼저 longin-server.conf 파일을 열어보면 각 라인(줄)의 가장 왼쪽,

즉 처음 부분에 // 이 있는 것과 없는 것이 나오게 되는데 // 이러한 기호가 앞에 있는 줄은 주석이고 사용자의 편의를 위해 있는 부분입니다.

다시 말해 // 이 기호가 앞에 나오는 줄은 서버의 설정에 영향을 미치지 않는 부분이며 실제로 서버의 설정에 영향을 주는 부분은 // 이 기호가 없는 부분이 됩니다.

따라서 주석을 지워도 설정에는 무방하고 주석이 없는 줄을 지우거나 잘못된 설정 값을 대입하면 오류가 발생합니다.

또한 반드시 // 슬래쉬가 연속해서 두개가 있어야 주석처리가 되며 이 주석의 글은 각 설정에 대한 설명이므로 잘 읽어보는 것이 좋습니다.

console_silent: 0

은 Athena 서버를 실행하고 보이는 콘솔(console)창 (도스창)에 출력되는 여러 서버정보 로그 메세지를 숨길지에 대한 설정입니다.

숫자를 이용하여 설정값을 적용하며 2의 거듭제곱 형태로 표현됩니다.

2^0 = 1: 정보 메세지 숨김

2^1 = 2: 상태 메세지 숨김

2^2 = 4: 공지 메세지 숨김

2^3 = 8: 경고 메세지 숨김

2^4 = 16: 오류 및 SQL오류 메세지 숨김

2^5 = 32: 디버깅 메세지 숨김

위의 설정을 중복해서 적용하기 위해서는 각 값을 더하여 적용합니다.

예) console_silent: 14 //  2 + 4 + 8 = 14 이며 상태, 공지, 경고 메세지를 함꺼번에 숨깁니다.

new_account: yes

주석의 설명으로는 _M, _F를 사용하여 계성을 생성할 수 있도록 하는 것입니다.

new_acc_length_limit: yes

위의 new_account가 설정되어 있을 때 사용가능하며 계정의 최소 길이에 대한 설정입니다.

allowed_regs: 1

time_allowed: 10

주석 설명에 따르면 계정 등록 폭주에 대한 보호 시스템으로 allowed_regs에 설정된 숫자만큼 등록하면 time_allowed에 설정된 초만큼 계정 등록이 되지 않습니다.

group_id_to_connect: -1

은 서버에 접속을 제한하는 그룹 아이디를 설정하며 -1의 경우 모든 그룹 아이디를 서버에 접속 가능하게 합니다.

0 이상의 그룹 아이디를 설정하면 해당 그룹 아이디만 접속을 허용합니다. 그룹 아이디 Group_id의 경우 MySQL 즉, 데이터베이스의 login 테이블에서 설정이 가능합니다.

min_group_id_to_connect: -1

은 위의 설정과 같으며 0 이상의 그룹 아이디를 설정하면 해당 그룹 아이디 이상의 그룹에 접속을 허용합니다.

단, group_id_to_connect이 -1로 설정되있을 경우에만 위 설정을 사용할 수 있습니다.

vip_group: 5

VIP 그룹 아이디를 설정합니다.

chars_per_account: 0

계정 당 캐릭터수를 제한할 수 있습니다.

단, src/common/mmo.h에 정의된 MAX_CHARS인 최대 캐릭터 슬롯을 초과할 수 없습니다.

vip_char_increase: 6

VIP 그룹의 최대 캐릭터 수를 늘려줍니다. 0의 경우 비활성화 입니다.

start_limited_time: -1

계정 생성시 서버에 딜레이 시간을 설정합니다.

-1의 경우 딜레이 시간이 없으며 0 이상의 숫자는 초 단위로 딜레이가 설정됩니다.

// Ipban features (SQL only)

ipban.enable: yes

ip 밴(차단) 설정입니다. SQL에서만 사용 가능하며

//ipban.sql.db_hostname: 127.0.0.1

//ipban.sql.db_port: 3306

//ipban.sql.db_username: ragnarok

//ipban.sql.db_password: ragnarok

//ipban.sql.db_database: ragnarok

//ipban.sql.codepage: 

//ipban.sql.ipban_table: ipbanlist

// Dynamic password failure ipban system

위의 주석을 해제하여 SQL에 차단을 위한 ip 리스트를 지정합니다.

이후의 설정은 추후에 작성하도록 하겠습니다.

다음 MySQL Workbench를 실행합니다. 해당 데이터베이스에 연결한 뒤 rag_test 스키마의 main.sql을 이용하여 생성한 테이블 중 login 테이블을 선택합니다. 즉, login 테이블을 수정할 수 있도록 합니다.

즉, login 테이블을 수정할 수 있는 상태로 준비합니다.

아래와 같이 userid와 user_pass를 볼 수 있습니다.

이제 서버 에뮬레이터가 서로 통신을 위한 아이디와 비밀번호를 설정하겠습니다.

주의할 점은 MySQL의 root 비밀번호와 함께 이 아이디와 비밀번호 또한 타인에게 노출되지 않도록 해야합니다.

따라서 기본적으로 설정되어있는 s1, p1은 절대 사용하지 않도록 합니다. (최근의 athena들은 s1/p1을 그대로 사용할 시 작동되지 않습니다.)

MySQL의 userid/user_pass를 반드시 자신만 아는 아이디와 비밀번호로 설정합니다.

수정을 원하는 셀을 더블 클릭하여 수정한 후 반드시 Apply를 눌러줍니다.

변경 내용을 확인한 뒤 Apply를 눌러줍니다.

올바로 적용된 후 Finish를 선택하여 마무리 합니다.

제대로 적용되었다면 char-server.conf와 map-server.conf의 userid/passwd를 위에서 수정한 값과 같은 값으로 수정하고 저장합니다.

가장 먼저 MySQL Workbench를 실행하여 root 사용자로 해당 데이터베이스에 연결합니다.

그 다음 Athena가 연결할 사용자를 생성해야 합니다.

왼쪽의 Users and Privileges를 선택한 후 중앙에 나오는 창에서 Add Account(새로운 사용자 생성)를 선택합니다.

다음 바로 오른쪽에 나오는 Login Name/Limit Connectivity to Hosts Matching/Password/Confirm Password를 적절히 채우고 반드시 Apply를 클릭하여 적용합니다.

Login Name/Password는 타인이 알 수 없도록 주의하며 Limit Connectivity to Hosts Matching에는

자신의 컴퓨터를 지칭하는 localhost 또는 127.0.0.1을 넣습니다. (데이터베이스와 Athena가 다른 곳에서 구축되어 있다면 그에 알맞는 아이피 주소를 넣습니다.)

Athena는 이 사용자 계정을 이용하여 이 데이터베이스에 연결합니다. 뿐만 아니라 앞에서 Athena는

이 데이터베이스에 값을 조회하고 추가/수정을 할 수 있어야 하므로 새로 생성한 사용자의 권한을 설정해야합니다.

다음과 같이 Administrative Roles 탭을 선택한 뒤 계정의 역할 Role과 권한 plivilige을 설정해야 합니다.

읽어보고 알맞는 설정을 하면 되지만 잘 모르겠다면 파란 V표시가 있는 DBA를 선택하여 모든 권한을 적용합니다.

그 다음 반드시 Apply를 선택하여 적용해 줍니다. (이렇게 많은 권한을 부여하므로 ID/Password 보안에 신경씁니다.)

이 가이드의 경우에는 Login Name : testUserID/Password : testUserPW로 설정하였습니다.

이렇게 Athena가 접속할 수 있는 새로운 사용자를 추가하였다면 이 사용자를 이용하여 Athena가 접속해야 하므로 이전에 보았던 inter-server.conf에 이 사용자를 추가합니다.

이제 MySQL에서는 Athena 구동에 필요한 데이터베이스들과 최소한의 데이터베이스 내용, 그리고 연결을 위한 계정까지 모두 준비되었습니다.

마지막으로 Athena에서 이 데이터베이스에 연결하기 위한 설정입니다.

Athena 안의 conf/inter-server.conf 파일을 열고 Global SQL settings를 수정합니다.

이 부분은 Athena가 접속할 데이터베이스 위치와 연결할 계정, 목적에 맞는 데이터베이스 스키마가 설정되는 곳입니다.

먼저 새로 추가한 사용자인 testUserID/testUserPW를 inter-server.conf의 Global SQL settings의 4 곳의 username과 password에 '똑같이' 적어줍니다. ※붉은색 상자와 화살표

다음 파란색 상자인 rag_test 스키마 이름을 inter-server.conf의 database에 적어줍니다. 단, MySQL Log SQL Database는 제외. ※파란색 상자와 화살표

마지막으로 초록색 상자인 rag_test_log 스키마 이름을 MySQL Log SQL Database에 적어줍니다. 이 부분은 헷갈릴 수 있으므로 천천히 잘 확인하면서 설정하도록 합니다.

-요약

추가한 사용자 아이디/비밀번호를 inter-server.conf에 4곳에 똑같이 적어줍니다.

메인 데이터베이스 스키마 이름을 3곳에 똑같이 적어줍니다.

로그 데이터베이스 스키마 이름을 1곳에 똑같이 적어줍니다.

이로써 구동을 위한 최소한의 설정이 끝났습니다. (SQL 버전의 경우)

실제로 가이드에 설명된 것 이외에는 아무것도 하지 않은 것을 이용하여 구동한 것입니다.

아무런 오류없이 잘 구동되었으며 Hercules팀의 5월 8일의 Athena를 Git에서 다운받은 것으로 실행하였습니다.

공유기를 사용하는 환경이지만 login/char/map_conf.conf에서 아이피/포트 수정없이 실행하였습니다. 딱 지금까지의 가이드를 충실히 따라서,,,

Athena가 DB에 접속하기 위한 사용자를 추가할 때 Limit Connectivity to Hosts Matching에서 자신의 컴퓨터 주소인 localhost 또는 127.0.0.1을 설정하였는데,

이 부분의 이름에서 알 수 있듯 설정한 조건에 맞는 연결을 제한하는 것입니다. 즉, 자신의 컴퓨터 주소를 적어준다면 자신의 컴퓨터에서만 연결할 수 있는 것입니다.

따라서 자신의 환경에 맞게 바꾸어 주어도 되며, 이에 따라 inter-server.conf에서 각각의 아이피 주소(기본적으로 127.0.0.1로 되어있음)/포트(기본적으로 3306으로 되어있음)를 바꾸어주면 됩니다.

마지막으로 여기까지의 가이드는 구동의 최소한의 설정으로 바로 runserver-sql.bat 또는 run-server.bat으로 서버구동할 때 잘 구동 될 수도 있습니다.

이 가이드를 보시는 분들 중 char/login/map_conf.conf 아이피를 수정해야한다는 점을 알고 있는 분이 있을 수 있는데

기본적으로 아이피에 대한 명시적인 설정이 없으면 자신의 컴퓨터로 접속하게 되어있으므로 자신의 컴퓨터에 mpa/login/char 서버가 모두 실행된다면 서버 구동에는 문제가 없습니다.

문제는...  Athena에 실제로 접속할 때 잘 되지 않을 수 있습니다. 이에 대한 자세한 설명은 허용되지 않을 수 있으므로 생략하며 char/login/map_conf.conf의 아이피 수정은 다음 가이드에 설명하겠습니다.

이 가이드를 마치면서 예로 설정했던 데이터베이스 및 많은 ID/PW는 모두 삭제하였습니다.

또한 결과에 보여지는 아이피는 내부 공유기 아이피이므로 혹시라도 잘 모르시는 분들의 무리한 접속 시도는 하지 않으시는 것이 좋을 것 같습니다.

SVN의 간략한 설명

먼저 SVN은 자유 소프트웨어 버전 관리 시스템으로 원래의 이름은 Subversion입니다. SVN은 시간에 따라 파일과 파일경로를 관리합니다. 파일 트리는 한 곳에 저장되어있는 Repository/. 즉, 레포지토리라는 저장소에 저장되어 있습니다. 개념적으로는 일반 파일 서버와 비슷하지만 파일과 파일경로 등에 적용된 모든 변경사항을 기록하여 관리합니다. 즉, 시간 1에 저장된 정보에 시간 2에 파일 경로와 저장된 정보에 변경 사항이 있을 경우 그 변경 사항만을 저장합니다. 이 변경사항을 시간에 따라 기록하여 관리하므로 이전 시간. 즉, 이전의 버전으로 돌아가기가 쉽고 이전의 버전과 어떠한 점이 달라졌는지 비교하기 쉬워서 소스 코드 관리에 많이 사용합니다.

하지만 Subversion은 명령행 인터페이스(CLI)로 텍스트 터미널을 통해 사용자와 컴퓨터가 상호작용 합니다. 이러한 인터페이스는 초보자들에게 다소 생소하고 어려운 부분이 있기 때문에 운영체재와 사용자가 사용하기 쉽도록 그래픽 사용자 인터페이스(GUI)를 제공해 주는 툴을 사용하는 것이 좋습니다.

SVN에 대한 자세한 정보와 사용법은 직접 찾아보시기 바랍니다.

Git의 간략한 설명

Git 또한 SVN과 비슷한 버전 관리 프로그램입니다. 하지만 SVN과 달리 속도에 중점을 둔 분산형 버전 관리 시스템(DVCS) 입니다. SVN의 경우에는 Repository라는 하나의 저장소를 가지고 있지만 Git의 경우에는 중간에 Local Repository가 존재하여 대체로 Local에서 작업이 이루어지기 때문에 인터넷을 통한 서버 조회 없이 Local에서 조회하므로 속도면에서 굉장히 빠릅니다. 이외에도 Git만 가지고 있는 강력한 장점이 있습니다.

이러한 장점들로 인해 Athena의 여러 개발팀들도 Git과 SVN을 동시에 사용하거나 SVN에서 Git으로 옮겨가는 추세입니다.

(앞에서 언급한 점 외에도 Git의 중요하고 특별한 점이 있지만 자세한 것은 직접 찾아보시기 바랍니다.)

rAthena팀

https://rathena.org/board/

SVN 체크아웃 URL

https://github.com/rathena/rathena/trunk

Hercules팀

https://hercules.ws/board/

SVN 체크아웃 URL

https://github.com/HerculesWS/Hercules

eAthena팀

https://www.eathena.ws/

SNV 체크아웃 URL

https//eathena-project.googlecode.com/svn/