사바쨩(Saba-chan) 공식 문서
사바쨩의 설치와 설정, 모듈 및 익스텐션 개발을 다루는 공식 가이드입니다.
사바쨩(Saba-chan) 공식 문서
사바쨩은 개인 PC에서 게임 서버를 설치하고 관리하는 프로그램입니다. 뒤에서 계속 도는 데몬이 서버 프로세스를 제어합니다. GUI·CLI·디스코드 명령어로 서버를 시작·정지하고 상태를 확인할 수 있습니다. Windows, 리눅스(x86_64), macOS(Apple 실리콘)를 지원합니다.
디스코드 쪽은 서버쨩이 맡습니다. 서버쨩은 사바쨩의 언니로, 디스코드 봇과 PC를 이어 주는 릴레이 서버입니다. 문서에서 서버쨩이라고 하면 이 릴레이 서버를 가리킵니다.
문서 가이드
처음 시작하는 경우
- 시작하기: 사바쨩 설치부터 첫 게임 서버를 만들고 실행하기까지의 절차를 안내합니다.
- 서버 관리하기: 서버 시작·정지와 모니터링 등 일상적인 운영 방법을 다룹니다.
- 디스코드 봇: 디스코드 채팅방에서 서버를 시작하고 상태를 확인하는 연동 방법을 다룹니다.
- 명령어: 디스코드 봇에서 사용할 수 있는 명령어와 별명 등록 방법을 정리합니다.
- 문제 해결: 포트 충돌이나 연결 오류 등 자주 발생하는 문제의 원인과 조치 방법을 안내합니다.
환경 설정과 확장
- 설정 파일: 모든 사용자 설정이 담긴
config.json의 세부 항목과 환경 변수 구성을 다룹니다. - 익스텐션: SteamCMD 자동 설치나 언리얼 엔진 설정 파일 편집처럼 데몬 기능을 확장하는 방법을 다룹니다.
모듈과 API 개발
- 모듈 시스템:
module.toml과 Python 스크립트로 새로운 게임 서버 지원을 추가하는 방법을 다룹니다. - REST API 레퍼런스: 데몬이 제공하는 HTTP REST API 명세입니다. 외부 도구나 대시보드를 연동할 때 참조합니다.
주요 특징
1. 런타임 준비
시스템 전역 환경 변수(PATH)를 변경하지 않습니다. 모듈과 익스텐션 실행에 필요한 Python 런타임은 설치 프로그램이 사바쨩 전용 폴더에 준비하므로 별도로 환경을 구성하지 않아도 됩니다.
2. 데몬과 인터페이스
Rust로 작성된 코어 데몬이 모든 기능을 수행하며 서버 프로세스를 직접 관리합니다. GUI와 CLI는 데몬 API를 호출하는 인터페이스입니다.
- GUI 창을 닫을 때 '인터페이스만 종료'를 선택하면 데몬과 게임 서버는 계속 실행됩니다. 완전히 끄려면 '완전히 종료'를 선택해 데몬까지 종료해야 합니다.
- 데몬이 재시작되면 실행 중이던 기존 서버 프로세스를 확인해 자동으로 다시 연결(Re-attach)하여 추적을 이어갑니다.
3. 디스코드 봇과 원격 관리
디스코드 봇은 서버쨩에서 동작합니다. 사바쨩을 봇과 페어링하면 데몬이 서버쨩으로 먼저 연결하므로, 외부 네트워크에서도 포트포워딩 없이 디스코드 명령어로 서버를 관리할 수 있습니다. 서버쨩은 관리 명령만 중계하므로, 플레이어가 게임에 접속하는 데 필요한 네트워크 설정은 별도로 진행해야 합니다.
4. 모듈과 익스텐션
- 모듈: 게임별 설치·실행 방법과 설정 규칙을 정의해 새로운 게임 서버를 추가합니다. 공식 모듈은 Minecraft, Palworld, Project Zomboid, Terraria입니다.
- 익스텐션: SteamCMD 자동 설치, 언리얼 엔진 설정 파일(INI) 편집, XNA Framework 포터블 배치처럼 서버 운영에 필요한 보조 기능을 데몬에 추가합니다.
- 공식 서명이 확인되지 않은 모듈과 익스텐션은 격리된 환경에서 실행됩니다(Windows는 AppContainer, 리눅스는 bubblewrap). 격리할 수 없는 환경(bubblewrap이 없거나 쓸 수 없는 리눅스, macOS)에서는 사용자가 동의한 뒤에만 실행됩니다. 격리 없이 실행하려면 사용자가 직접 동의해야 합니다.
5. 업데이트
앱, 모듈, 익스텐션 업데이트는 모두 공식 서명이 확인된 릴리스에서만 받으며, 내려받은 파일은 하나하나 해시로 검사합니다.
지원 및 기여
- GitHub 저장소: WareAoba/saba-chan Github 저장소에서 이슈를 등록하거나 풀 리퀘스트를 제출할 수 있습니다.
- 설치와 첫 실행은 시작하기 문서를 참고하세요.