세아니 접속기 사용자 매뉴얼 v1.0

접속기를 만들어 유저에게 배포하는 전체 과정입니다.

브라우저에서 관리 서버 주소로 접속합니다.

https://con.gameboylab.com

관리자에게 받은 아이디와 비밀번호를 입력하고 로그인합니다.

로그인 후 가장 먼저 서버 설정 탭에서 서버 정보를 입력합니다.

3-1. 서버 기본 정보

3-2. 접속 서버 목록

게임에 접속할 서버 주소를 입력합니다. 여러 개 추가 가능합니다.

3-3. 클라이언트 파일 설정

3-4. 가드 설정

가드(핵 감지) 기능을 사용하려면 토글을 켜고 가드 서버 URL을 입력합니다. 사용하지 않으면 끄면 됩니다.

3-5. 저장

모든 항목을 입력했으면 하단의 설정 저장 버튼을 클릭합니다.

List파일인코딩 탭에서 패치 리스트 텍스트를 암호화하여 List.pak 파일을 만듭니다.

4-1. 패치 텍스트 준비

패치 리스트는 아래와 같은 형식의 텍스트입니다. 기존에 사용하던 List 텍스트를 그대로 사용하면 됩니다.

0 0 0 0 0 7 8 2 0 0 0
[기존 패치 데이터 내용]
@

4-2. 인코딩 방법

4-3. 파일 서버에 업로드

다운로드받은 List.pak 파일을 파일 서버(웹서버)에 업로드합니다.

업로드 경로가 서버 설정의 List.pak URL과 일치하는지 확인하세요.

예) 서버 설정의 List.pak URL: http://files.example.com/List.pak
    → files.example.com 웹서버에 List.pak 업로드

5-1. 접속기 생성

5-2. 유저에게 배포

1. 다운로드받은 exe 파일을 유저에게 전달합니다.
2. 유저는 게임 클라이언트 폴더 (lin.bin이 있는 폴더)에 exe를 넣습니다.
3. exe를 실행하면 자동으로 필요한 파일을 다운로드하고 게임이 시작됩니다.

6-1. 파일 자동 업데이트 개요

접속기는 실행할 때마다 아래 순서로 자동 업데이트를 수행합니다.

1. 패치 업데이트 (ver.txt 기반 ZIP 패치)
2. List.pak 업데이트 (파일 크기 비교)
3. lin.bin 다운로드 (파일 없으면 자동 다운로드)
4. 이미지 다운로드 (배경 이미지, 없으면 자동 다운로드)

유저는 접속기를 실행하기만 하면 항상 최신 상태로 유지됩니다.

6-2. ver.txt 기반 패치 시스템

게임 클라이언트 파일(맵, 스프라이트, 텍스트 등)을 업데이트하는 핵심 시스템입니다.

동작 원리

1. 접속기가 {패치 기본 URL}/ver.txt 를 다운로드하여 서버 버전을 확인합니다.
2. 게임 폴더의 ver.txt 에서 로컬 버전을 읽습니다. (파일이 없으면 0)
3. 로컬 버전 < 서버 버전이면, 그 사이의 ZIP 파일을 순서대로 다운로드하고 압축을 풉니다.
4. 모든 패치 적용 후 로컬 ver.txt를 서버 버전으로 갱신합니다.

파일 서버 구성 방법

패치 기본 URL에 아래 파일들을 준비합니다.

http://files.example.com/patch/
  ├── ver.txt          ← 현재 최신 버전 번호 (예: "5")
  ├── 001.zip          ← 버전 1 패치 파일
  ├── 002.zip          ← 버전 2 패치 파일
  ├── 003.zip          ← 버전 3 패치 파일
  ├── 004.zip
  └── 005.zip

패치 ZIP 파일 만드는 법

ZIP 파일 안에는 게임 클라이언트 폴더 기준의 상대 경로로 파일을 넣습니다.

003.zip 내부:
  ├── map/0004.s32        ← 수정된 맵 파일
  ├── sprite/npc01.spr    ← 수정된 스프라이트
  └── text/               ← text 폴더가 있으면 update.exe 자동 실행
      ├── item_kr.txt
      └── npc_kr.txt

패치 추가 예시

현재 서버 버전이 3인 상태에서 새 패치를 추가하려면:

이후 유저가 접속기를 실행하면 자동으로 004.zip이 다운로드되어 적용됩니다.

6-3. List.pak 변경 시

1. List파일인코딩 탭에서 수정된 텍스트로 새 List.pak을 생성합니다.
2. 파일 서버에 새 List.pak을 업로드 (기존 파일 덮어쓰기)합니다.
3. 접속기가 다음 실행 시 파일 크기가 다르면 자동으로 새 파일을 받아갑니다.

6-4. 서버 설정 변경 시

서버명, 공지사항, 접속 서버 목록, 가드 설정 등은 서버 설정에서 변경 후 저장하면 접속기가 다음 실행 시 자동으로 반영됩니다. 접속기를 새로 만들 필요 없습니다.

6-5. 접속기 자체를 변경해야 할 때

접속기 exe 자체를 새로 배포해야 하는 경우:

• 접속기 프로그램이 업데이트되었을 때
• 보안상 라이선스를 갱신해야 할 때

이 경우 접속기 생성 탭에서 새로 생성하고, 유저에게 다시 배포합니다.

Q. "List.pak 복호화 실패" 오류가 나요

서버 설정의 인코드 키와 List.pak을 만들 때 사용한 키가 다릅니다. 동일한 키를 입력했는지 확인하세요.

Q. 접속기를 새로 만들면 기존 유저는 어떻게 되나요?

이전 라이선스가 모두 무효화되므로, 기존 접속기는 동작하지 않습니다. 새 exe를 다시 배포해야 합니다.

Q. 서버 IP를 바꿨는데 접속기를 새로 만들어야 하나요?

아닙니다. 서버 설정에서 접속 서버 목록의 IP를 변경하고 저장하면, 다음 접속기 실행 시 자동 반영됩니다.

Q. 공지사항만 바꾸고 싶어요

서버 설정에서 공지사항을 수정하고 저장하면 끝입니다. 접속기를 새로 만들 필요 없습니다.

Q. 동시에 몇 개까지 게임을 실행할 수 있나요?

서버 설정의 클라이언트 수에서 설정할 수 있습니다. 기본값은 4입니다.

Q. 서버가 여러 개인데 하나의 접속기로 되나요?

네. 접속 서버 목록에 여러 서버를 추가하면 접속기 상단에 서버 선택 드롭다운이 나타납니다.

Q. 기존 List.pak을 텍스트로 변환하려면?

decoder.exe 프로그램을 사용하세요. 암호화된 List.pak과 인코드 키를 입력하면 원본 텍스트를 추출할 수 있습니다.

Q. 패치 파일을 업데이트했는데 유저에게 적용이 안 돼요

서버의 ver.txt 숫자를 올렸는지 확인하세요. ver.txt 숫자가 로컬보다 높아야 새 ZIP을 다운로드합니다. 또한 ZIP 파일명이 001.zip, 002.zip 형식(3자리 숫자)인지 확인하세요.

Q. 유저가 처음 설치하는데 패치가 너무 오래 걸려요

처음 설치 시 001.zip부터 모든 패치를 순서대로 받습니다. 패치가 많이 쌓였다면 이전 패치들을 합쳐서 001.zip 하나로 만들고 ver.txt를 1로 리셋하는 것을 고려하세요. (기존 유저의 ver.txt도 리셋 필요)

Q. text 폴더 패킹이 자동으로 안 돼요

게임 폴더에 update.exe가 있어야 합니다. update.exe가 없으면 text 폴더가 추출만 되고 패킹은 되지 않습니다. update.exe를 첫 번째 패치(001.zip)에 포함시키는 것을 권장합니다.