지금 체험하기(Minecraft 테스트 서버)

지금 체험하기는 프로젝트가 설치된 실제 Minecraft 서버를 나만을 위해 시작해요. 내 게임에서 접속해 플러그인, 스크립트, 데이터팩을 테스트하면 되고, 시간이 다 되면 서버는 저절로 사라져요.

#체험할 수 있는 것

Fabric 및 Forge 모드, Folia, BungeeCord 프로젝트는 아직 테스트 서버에서 체험할 수 없어요.

플러그인과 Skript 프로젝트는 같은 창의 테스트 탭에서 Codexe의 테스트 플레이어로 확인할 수도 있어요. 테스트 플레이어로 테스트하기를 참고하세요.

#테스트 서버 시작하기

테스트 서버는 도구 모음의 지금 체험하기 버튼, AI의 마지막 답변 아래에 있는 지금 Minecraft에서 무료로 체험하세요, 그리고 다운로드 창(테스트 서버 시작)에서 열 수 있어요. 그래서 내려받기 전에 프로젝트를 체험해 볼 수 있어요. 오늘 쓸 수 있는 테스트 서버를 다 썼다면 그렇게 알려 주고, 더 많이 제공하는 플랜을 보여 줘요.

1. 프로젝트를 여세요. 플러그인이라면 먼저 컴파일을 누르세요. 서버는 컴파일된 jar를 설치해요.
2. Minecraft에서 체험하기를 누르세요. 채팅의 마지막 답변 아래(지금 Minecraft에서 무료로 체험하세요), 도구 모음의 컴파일 옆, 그리고 빌드 후 JAR 다운로드 옆에 있어요. 모든 플랜에서 무료이고, 내려받지 않은 프로젝트에서도 쓸 수 있어요. Free 플랜에서 다운로드 없이 프로젝트를 써 보는 방법이에요.
3. Minecraft 이름을 입력하고 테스트 서버 시작을 누르세요. 그 이름은 오퍼레이터로 서버 접근 목록에 추가되며, 이 목록에 있는 이름만 접속할 수 있어요.
4. 서버가 부팅되는 동안 버튼에 서버를 시작하는 중… 표시가 나오며, 보통 20~40초가 걸려요. 버튼이 남은 시간과 함께 서버 온라인으로 바뀌면 주소가 나타나요. 시간은 그때부터 흘러가기 시작해요.
5. Minecraft에서 멀티플레이, 직접 연결을 차례로 누르고 주소(예: swift-otter-27.codexe.eu)를 붙여 넣으세요. 포트는 필요 없어요. 혹시 대화 상자에 포트가 붙은 숫자 주소가 표시되면 보이는 그대로 붙여 넣으세요.

서버가 어떤 버전으로 돌아가든 1.8부터 26.3까지 모든 Minecraft Java 버전으로 접속할 수 있어요. 모든 테스트 서버에 ViaVersion, ViaBackwards, ViaRewind가 설치되어 있어요.

#월드

대부분의 프로젝트는 구조물 없는 평지 월드에서 체험해요. 빨리 시작되고, 상자, 명령어, 메뉴, 키트 같은 기능에는 지형이 상관없기 때문이에요.

프로젝트에 실제 지형이 필요하면 Codexe는 대신 바이옴, 산, 동굴, 마을과 약탈자 전초기지 같은 구조물이 있는 새 일반 월드로 서버를 시작해요. 따로 요청할 필요는 없어요. Codexe가 프로젝트를 읽고 결정해요. 예를 들어 월드 생성을 바꾸는 데이터팩(더 높은 산, 새 바이옴)이나 눈 덮인 봉우리 또는 약탈자 전초기지에서 동작하는 플러그인은 일반 월드를 받고, 상자 플러그인은 평지에 머물러요. 데이터팩은 월드가 생성되기 전에 설치되므로, 보이는 지형이 바로 그 데이터팩이 만든 지형이에요. 월드를 생성하느라 첫 시작이 조금 더 오래 걸리며, 일반 월드를 고른 이유는 콘솔에 표시돼요.

#플러그인에 필요한 플러그인

플러그인의 plugin.yml(depend와 softdepend)이나 paper-plugin.yml에 LuckPerms, Vault, PlaceholderAPI, WorldEdit, WorldGuard, ProtocolLib 같은 다른 플러그인이 적혀 있으면, 테스트 서버가 그 Minecraft 버전에 맞는 버전으로 설치해 주고 그 플러그인들이 다시 필요로 하는 것도 함께 설치해요. Modrinth와 Hangar에서 가져와요.

무엇이 설치됐는지는 콘솔에 표시돼요. 유료 플러그인(MythicMobs, ItemsAdder, Nexo...)은 자동으로 설치할 수 없어요. 콘솔에 그렇게 표시되고, 유료 플러그인이 꼭 필요한 플러그인은 테스트 서버에서 활성화되지 않아요.

#플러그인용 데이터베이스

플러그인이 데이터를 MySQL에 저장한다면 테스트 서버가 전용 MySQL 데이터베이스를 줘요. 플러그인의 config.yml에 storage-type: mysql이 있고 일반적인 mysql: 섹션(host, port, database, username, password)이 있으면 자동으로 진행돼요. 테스트 서버가 데이터베이스를 만들고, 그 섹션에 주소와 새 비밀번호를 쓴 다음 서버를 시작해요. 완료되면 콘솔에 표시돼요.

• Codexe로 만든 플러그인은 기본적으로 설정이 필요 없는 파일인 SQLite를 써요. MySQL을 원하면 채팅에서 요청하세요. 그러면 storage-type: mysql로 플러그인이 작성돼요.
• 데이터베이스는 여러분의 플러그인에만 제공돼요. 그 플러그인을 위해 설치된 플러그인(위의 LuckPerms 등)은 테스트 서버에서 각자의 기본 저장 방식을 그대로 써요.
• 데이터베이스는 테스트 서버가 멈출 때 다른 모든 것과 함께 삭제돼요. 최대 200 MB까지 담을 수 있고, 넘으면 서버가 멈춰요.

#플랜별 한도

시간은 시작 버튼을 누른 때가 아니라 서버가 준비된 순간부터 계산돼요. 계정당 한 번에 하나의 테스트 서버만 실행돼요. 모든 테스트 서버가 사용 중이면 몇 분 뒤에 다시 시도하세요.

#서버 접근

서버 접근(계정 메뉴, 또는 실행 중인 서버의 플레이어 탭)은 테스트 서버에 접속할 수 있는 사람의 목록이에요. 등록할 수 있는 이름 수는 위 표에 있는 플랜의 테스트 서버 동시 접속 인원이에요.

• Minecraft 이름을 추가하세요. Codexe가 Mojang에서 이름을 조회해 정품 계정인지와 얼굴을 보여 줘요. Mojang 계정이 없는 이름은 오프라인 플레이어로 추가되며, 이 경우 정확한 철자가 중요해요.
• 오퍼레이터를 켜면 그 플레이어가 서버에서 /op 권한을 받아요. 언제든 켜고 끌 수 있어요.
• 삭제를 누르면 목록에서 이름이 빠져요.

변경 사항은 이미 실행 중인 서버에도 몇 초 안에 반영되며, 접속 중인 사람을 빼는 것도 마찬가지예요. 그렇지 않으면 다음에 시작하는 서버부터 적용돼요. 목록에는 지금 접속 중인 사람과 각 사람이 마지막으로 접속한 시간도 표시돼요.

#콘솔, 로그, 성능

실행 중인 서버의 패널에는 탭이 세 개 더 있어요.

• 콘솔은 서버 콘솔처럼 Minecraft 명령어를 서버에 보내고 응답을 보여 줘요. Minecraft 콘솔일 뿐이라, 서버를 멈추거나 리로드하는 명령어와 오퍼레이터나 화이트리스트를 바꾸는 명령어는 거부돼요(이런 작업은 서버 접근에서 하세요). 10초마다 최대 10개 명령어까지 보낼 수 있어요.
• 로그는 서버 로그를 실시간으로 보여 주며 경고와 오류를 강조 표시하고, 서버가 멈춘 뒤에도 로그의 끝부분을 보관해요. 로그 내보내기를 누르면 이 세션의 로그가 줄마다 시간과 레벨이 붙은 .log 파일로 저장돼요. 디버깅하거나 도와주는 사람에게 공유할 때 쓰세요.
• 성능은 서버의 CPU, 메모리, TPS, 접속 플레이어 수, 디스크 사용량을 10초마다 측정해서 보여 줘요.

#서버가 저절로 멈추는 경우

시간이 다 되는 것 말고도 테스트 서버는 다음 경우에 멈춰요.

• Codexe를 떠날 때. 프로젝트 페이지가 서버에 여러분이 아직 있다고 알려요. 그 페이지가 약 1분 동안 열려 있지 않으면(탭을 닫았거나, 로그아웃했거나, 연결이 끊긴 경우) 서버가 멈춰요. 로그아웃하면 바로 멈춰요.
• 아무도 플레이하지 않을 때. 아무도 접속하지 않은 채 15분이 지나면 서버가 멈춰요.

멈춘 이유는 패널에 표시돼요. 직접 중지, 시간 종료, Codexe를 떠남, 접속자 없음, 서버 오류 중 하나예요.

아직 프로젝트를 내려받지 않았다면 테스트 서버가 멈출 때 다운로드 창이 다시 열려서 프로젝트를 내려받거나 플랜을 고를 수 있어요. 이때는 다른 테스트 서버를 시작하는 버튼이 더 이상 표시되지 않아요.

#플레이하는 동안

• 서버 접근으로 들여보낸 친구들은 여러분 서버의 손님으로 환영 메시지를 받고, 프로젝트는 여러분만 바꿀 수 있다는 안내를 받아요.
• 접속하면 채팅에 [Codexe] 메시지가 나타나 테스트 서버라는 것, 남은 시간, 서버가 닫히면 모든 것이 삭제된다는 것을 알려 줘요.
• 종료 5분, 3분, 1분, 10초 전에 채팅에 알림이 표시돼요.
• AI는 서버에서 일어나는 일을 볼 수 없어요. 프로젝트를 바꾸려면 평소처럼 프로젝트 채팅에 변경 사항을 설명하세요.
• 테스트하는 데 방해되지 않도록 슬라임은 자연적으로 스폰되지 않아요. 다른 몹은 평소대로 스폰되고, 스폰 알, 스포너, 명령어로 만든 슬라임은 그대로 나타나요.

#프로젝트 업데이트하기

테스트 서버가 실행 중일 때 다시 컴파일하면(또는 Skript 파일이나 데이터팩을 바꾸면) 대화 상자에 이 서버는 이전 빌드로 실행 중이에요 메시지와 최신 빌드로 재시작 버튼이 표시돼요. 새 서버는 최신 빌드로 실행되고 타이머도 새로 시작돼요.

#보관되는 것

서버 자체는 아무것도 보관되지 않아요. 위의 이유 중 무엇으로든 테스트 서버가 멈추거나 새 빌드로 재시작하면, 서버와 그 안의 모든 것이 삭제돼요. 월드, 건축물, 설정 변경, 플러그인의 데이터베이스가 모두 포함되며, 다시 열 수 없어요.

Codexe는 여러분과 지원팀을 위해 세션마다 간단한 기록을 남겨요. 시작과 종료 시각 및 이유, Minecraft 버전, 접속한 플레이어, 콘솔에서 보낸 명령어, 로그의 마지막 부분, 성능 측정값이에요. 무엇을 얼마나 오래 보관하는지는 개인정보 처리방침 4.8조와 보존 기간 표에 나와 있어요.

#격리와 안전

• 각 테스트 서버는 메모리, CPU, 시간 제한이 따로 있는 격리된 환경에서 실행되며 인터넷에 접근할 수 없어요. 웹 API, 외부 데이터베이스, Mojang을 호출하는 코드는 테스트 서버에서 그곳에 닿을 수 없어요. 접근할 수 있는 데이터베이스는 여러분의 플러그인을 위해 만든 것 하나뿐이며, 다른 테스트 서버는 그 데이터베이스를 열 수 없어요.
• 서버는 오프라인 모드로 실행되므로 Mojang으로 플레이어 이름을 확인하지 않아요. 주소와 서버 접근 목록의 이름을 둘 다 아는 사람은 서버가 실행되는 동안 접속할 수 있어요. 들어오지 않았으면 하는 사람에게는 주소를 알려 주지 마세요.
• 콘솔은 Minecraft에만 닿아요. 셸도, 파일 접근도, 그 뒤에 있는 머신의 명령어도 없어요.
• 테스트 서버가 실행되는 동안 무엇을 얼마나 오래 보관하는지는 개인정보 처리방침 4.8조에 설명되어 있어요. 규칙은 이용약관 15.6조부터 15.10조까지에 있어요.

#문제 해결