Starbound 서버 설정 가이드

이 가이드는 Steam 인증 사전 요구 사항, 최초 시작, 서버 구성, 유니버스 설정, 플레이어 연결, 세이브 관리를 포함하여 Legion Hosting에서 Starbound 전용 서버를 설정하고 구성하는 방법을 다룹니다. 모드 설치는 Starbound 모드 설치를 참조하세요. 관리자 명령어 및 권한은 Starbound 관리자 명령어를 참조하세요.

---

사전 요구 사항

Starbound 서버를 시작하기 전에 다음이 필요합니다:

• Starbound를 소유한 Steam 계정. 서버 바이너리는 익명 다운로드가 불가능합니다 -- 제공하는 계정의 라이브러리에 Starbound가 있어야 합니다.
• Steam Guard 고려 사항. Steam 계정에 Steam Guard(2단계 인증)가 활성화되어 있는 경우, 최초 설치 중에 STEAM_AUTH 시작 변수를 통해 인증 코드를 제공해야 합니다. 최초 인증 후 SteamCMD는 세션을 캐시하며, 캐시가 만료되지 않는 한 이후의 시작에서는 코드가 다시 필요하지 않습니다.
• 전용 Steam 계정 권장. 보안을 위해, 서버 호스팅 전용으로 Starbound를 소유한 별도의 Steam 계정을 사용하는 것을 고려하세요. 이렇게 하면 기본 계정 자격 증명을 공유하지 않아도 되며, 동일한 계정으로 동시에 플레이하려는 경우 충돌을 방지할 수 있습니다.

---

최초 시작

Legion Hosting에서 Starbound 서버를 구매한 후, 다음 단계에 따라 처음으로 실행하세요:

1. GPanel에 로그인하고 Starbound 서버를 선택합니다.
2. Startup 탭으로 이동합니다.
3. 필수 Steam 자격 증명을 입력합니다:
   • STEAM_USER -- Steam 계정 사용자 이름(필수).
   • STEAM_PASS -- Steam 계정 비밀번호(필수).
   • STEAM_AUTH -- 요청 시 Steam Guard 2FA 코드(선택, 최초 설치 시 또는 캐시된 세션이 만료될 때만 필요).
4. Console 탭으로 이동하여 Start를 클릭합니다.
5. 서버가 SteamCMD를 통해 Starbound 전용 서버 파일을 다운로드합니다. 최초 실행 시 몇 분이 소요될 수 있습니다.
6. 다운로드가 완료되면 서버가 기본 유니버스를 생성하고 연결 대기를 시작합니다.

GPanel 시작 변수

변수	필수	설명
STEAM_USER	예	Steam 계정 사용자 이름. Starbound를 소유해야 합니다. anonymous일 수 없습니다.
STEAM_PASS	예	위 사용자 이름의 Steam 계정 비밀번호.
STEAM_AUTH	아니요	Steam Guard 2단계 인증 코드. 초기 설정 중이거나 캐시된 세션이 만료될 때만 필요합니다.
WORKSHOP	아니요	Steam Workshop 모드 지원을 활성화하려면 1, 비활성화하려면 0으로 설정합니다. 기본값은 0입니다. 자세한 내용은 Starbound 모드 설치를 참조하세요.

---

starbound_server.config

기본 서버 구성 파일은 다음 위치에 있습니다:

storage/starbound_server.config

이 파일은 JSON 형식을 사용합니다. GPanel의 File Manager 또는 SFTP를 통해 편집하세요. 변경 사항은 시작 시 로드되므로, 편집하기 전에 서버를 중지해야 합니다.

주요 서버 설정

설정	기본값	설명
serverName	"A Starbound Server"	서버 브라우저 및 플레이어 접속 시 표시되는 이름.
maxPlayers	8	동시에 접속할 수 있는 최대 플레이어 수.
gameServerPort	21025	게임 서버가 수신 대기하는 포트. Legion Hosting에서는 자동으로 설정됩니다 -- 지원팀의 지시가 없는 한 변경하지 마세요.
gameServerBind	"::"	바인딩할 네트워크 인터페이스. 기본값 "::"는 모든 인터페이스(IPv4 및 IPv6)에 바인딩합니다. 그대로 두세요.
serverPassword	""	서버에 접속하는 데 필요한 비밀번호. 비밀번호가 없으면(공개 접속) 비워 두세요.
allowAnonymousConnections	true	true이면 플레이어가 Starbound 계정 없이 접속할 수 있습니다. 모든 플레이어에게 계정 인증을 요구하려면 false로 설정하세요.
allowAssetsMismatch	true	true이면 다른 모드 세트를 가진 플레이어도 접속할 수 있습니다. 서버와 클라이언트 간 에셋 일치를 강제하려면 false로 설정하세요(모드가 적용된 서버에 권장).
maxTeamSize	4	파티/팀당 최대 플레이어 수.
clientIPJoinable	false	직접 IP를 통해 서버에 접속할 수 있는지 여부. 전용 서버의 경우 true여야 합니다.
clientP2PJoinable	false	피어 투 피어 연결을 허용할지 여부. 전용 서버의 경우 일반적으로 false입니다.

starbound_server.config 예시

{
  "serverName" : "My Legion Starbound Server",
  "maxPlayers" : 8,
  "gameServerBind" : "::",
  "serverPassword" : "",
  "allowAnonymousConnections" : true,
  "allowAssetsMismatch" : true,
  "maxTeamSize" : 4,
  "clientIPJoinable" : true,
  "clientP2PJoinable" : false,
  "allowAdminCommands" : true,
  "allowAdminCommandsFromAnyone" : false,
  "serverUsers" : {
    "YourUsername" : {
      "admin" : true,
      "password" : "your-admin-password"
    }
  }
}

---

월드 및 유니버스 설정

Starbound는 절차적으로 생성된 유니버스를 사용합니다. 플레이어가 새로운 항성계나 행성을 방문할 때마다 게임은 유니버스 시드와 좌표 시스템을 기반으로 이를 생성합니다. 서버의 유니버스 데이터는 다음에 저장됩니다:

storage/universe/

이 디렉터리에는 행성, 우주 정거장, 월드에 배치된 플레이어가 건설한 구조물을 포함한 모든 생성된 월드 데이터가 포함되어 있습니다.

유니버스 구성

유니버스 생성 매개변수는 starbound_server.config 파일이나 유니버스 관련 에셋 파일을 통해 조정할 수 있습니다. 주요 개념:

개념	설명
유니버스 시드	유니버스는 좌표를 기반으로 절차적으로 생성됩니다. 동일한 게임 버전을 가진 모든 서버는 동일한 좌표에서 동일한 행성을 생성하지만, 플레이어가 배치한 객체와 수정 사항은 각 서버마다 고유합니다.
시작 행성	새 플레이어는 절차적으로 선택된 시작 행성에서 스폰됩니다. 시작 월드는 초반 진행에 적합한 정원형 행성입니다.
월드 파일	방문한 각 행성은 storage/universe/에 .world 파일을 생성합니다. 이 파일에는 플레이어가 변경한 지형, 배치된 객체, 타일 변경 사항이 포함됩니다.
천체 데이터	유니버스 디렉터리의 universe.chunks 및 universe.dat 파일은 유니버스 맵의 전체 상태를 저장합니다.

---

접속 방법

플레이어는 게임 내 멀티플레이어 메뉴를 사용하여 Starbound 서버에 접속합니다.

IP를 통한 직접 접속

1. Starbound를 실행합니다.
2. 메인 메뉴에서 Multiplayer를 클릭합니다.
3. 캐릭터를 선택합니다.
4. Server Address 필드에 서버의 IP 주소와 포트를 IP:Port 형식으로 입력합니다.
5. 서버에 비밀번호가 설정되어 있으면, 서버 구성의 serverUsers 항목과 일치하는 Account Name 및 Password를 입력합니다. allowAnonymousConnections가 true이고 서버 비밀번호가 설정되지 않은 경우, 이 필드는 비워 둘 수 있습니다.
6. Join Server를 클릭합니다.

Steam 친구(해당 없음)

Steam의 "Join Game" 기능은 피어 투 피어로 호스팅되는 게임을 위한 것이며, 전용 서버용이 아닙니다. 플레이어는 위에서 설명한 직접 IP 접속 방법을 사용하여 Legion Hosting 서버에 접속해야 합니다.

---

세이브 관리

Starbound는 모든 서버 데이터를 storage/ 디렉터리 내에 저장합니다. 파일 구조를 이해하면 백업, 전송, 문제 해결에 도움이 됩니다.

주요 저장 디렉터리 및 파일

경로	설명
storage/universe/	모든 생성된 월드 데이터 -- 행성, 우주 정거장, 월드에 대한 플레이어 수정 사항이 포함됩니다. 방문한 각 행성에는 .world 파일이 있습니다.
storage/player/	플레이어 세이브 파일이 포함됩니다. 각 플레이어는 인벤토리, 진행 상황, 퀘스트 상태, 우주선 데이터를 저장하는 .player 파일을 가지고 있습니다.
storage/starbound_server.config	기본 서버 구성 파일.
storage/starbound_server.log	서버 로그 파일. 충돌, 오류, 접속 문제를 진단하는 데 유용합니다.

백업 생성

정기적인 백업은 서버의 유니버스, 플레이어 데이터, 구성을 우발적인 손실이나 손상으로부터 보호합니다.

1. 모든 데이터가 디스크에 기록되도록 GPanel에서 서버를 중지합니다.
2. SFTP를 통해 서버에 연결하거나 File Manager를 사용합니다.
3. 전체 storage/ 디렉터리를 로컬 컴퓨터로 다운로드합니다.
4. 날짜 레이블(예: storage-backup-2026-02-26)과 함께 안전한 위치에 백업을 저장합니다.

백업에서 복원

1. 서버를 중지합니다.
2. 백업 파일을 storage/ 디렉터리의 해당 위치에 업로드하여 기존 파일을 덮어씁니다.
3. 서버를 시작합니다.

다른 서버에서 월드 전송

다른 서버나 로컬 게임에서 Starbound 유니버스를 이동하려면:

1. 소스 및 대상 서버를 모두 중지합니다.
2. 소스에서 대상 서버로 storage/universe/ 디렉터리를 복사합니다.
3. 선택적으로, 플레이어 데이터도 전송하려면 storage/player/를 복사합니다.
4. 서버 설정을 보존하기 위해 starbound_server.config를 복사합니다.
5. 대상 서버를 시작하고 월드가 올바르게 로드되는지 확인합니다.

---

관련 문서

• Starbound 모드 설치
• Starbound 관리자 명령어
• 서버 IP 및 포트 찾는 방법
• SFTP를 통한 파일 업로드 방법
• 서버 시작 가이드

---

도움이 필요하신가요?

이 가이드에서 다루지 않은 문제를 겪고 계신다면, 저희 지원팀이 도와드릴 준비가 되어 있습니다. legionhosting.net/submitticket.php에서 서버 세부 정보와 문제 설명을 포함하여 티켓을 열어주세요.