이 가이드는 Legion Hosting에서 Minecraft Java Edition 서버를 설정하는 과정을 안내합니다 -- 서버 유형 선택부터 월드 구성, 친구와 연결하기까지.

1. 서버 유형 선택

Minecraft 서버를 처음 설정할 때 가장 중요한 결정 중 하나는 어떤 서버 소프트웨어를 실행할지입니다. 각 유형은 플러그인, 모드, 또는 순수한 바닐라 경험을 원하는지에 따라 서로 다른 기능을 제공합니다.

서버 유형	가장 적합한 용도	플러그인 지원	모드 지원	비고
Vanilla	순수하고 수정되지 않은 Minecraft	없음	없음	공식 Mojang 서버 JAR입니다. server.properties 외에는 커스터마이징이 없습니다.
Paper	성능 최적화된 서바이벌/SMP	Bukkit & Spigot 플러그인	없음	상당한 성능 패치가 적용된 Spigot의 포크입니다. 대부분의 서버에 권장됩니다.
Spigot	플러그인 기반 서버	Bukkit & Spigot 플러그인	없음	원조 고성능 Bukkit 포크입니다. 오늘날에는 일반적으로 Spigot보다 Paper가 선호됩니다.
Forge	모드가 적용된 Minecraft(대형 모드팩)	제한적(일부는 Sponge를 통해)	Forge 모드	클래식 모드 로더입니다. 클라이언트는 동일한 Forge 버전과 모드를 설치해야 합니다.
Fabric	경량 모딩, 최신 모드	제한적	Fabric 모드	새 Minecraft 버전으로 더 빠르게 업데이트됩니다. 성장하는 모드 생태계입니다. 클라이언트는 Fabric + 일치하는 모드가 필요합니다.

2. 첫 시작

1. GPanel에 로그인합니다.
2. 서버 목록에서 Minecraft 서버를 선택합니다.
3. Startup 탭으로 이동합니다.
4. 드롭다운 메뉴에서 원하는 서버 유형(Paper, Vanilla, Forge 등)과 Minecraft 버전을 선택합니다.
   중요: 선택한 버전이 플레이어가 실행할 버전과 일치하는지 확인하세요. 버전이 일치하지 않으면 클라이언트가 연결할 수 없습니다.
5. Console 탭에서 Start를 클릭하여 서버를 처음 실행합니다.
6. 첫 시작 시 자동으로 다음을 수행합니다:
   • 선택한 서버 JAR 다운로드
   • server.properties, eula.txt 및 기타 기본 구성 파일 생성
   • 초기 월드 생성(1~2분 정도 걸릴 수 있음)
7. 콘솔에서 Done!이 보이면 서버가 실행 중이며 구성할 준비가 된 것입니다.

3. server.properties 구성

server.properties 파일은 서버의 대부분의 핵심 동작을 제어합니다. GPanel의 File Manager에서 직접 편집할 수 있습니다 -- 루트 디렉터리의 파일을 클릭하여 내장 편집기를 엽니다.

속성	기본값	설명
server-name	A Minecraft Server	서버 목록에 표시되는 이름입니다(Bedrock 전용; Java는 대신 motd를 사용합니다).
gamemode	survival	새 플레이어의 기본 게임 모드입니다. 옵션: survival, creative, adventure, spectator.
difficulty	easy	서버 난이도입니다. 옵션: peaceful, easy, normal, hard.
max-players	20	동시에 연결할 수 있는 최대 플레이어 수입니다. 호스팅 플랜의 플레이어 슬롯 한도에 맞게 설정하세요.
pvp	true	플레이어가 서로에게 피해를 줄 수 있는지 여부입니다. PvE 전용 서버의 경우 false로 설정하세요.
online-mode	true	Mojang으로 플레이어 계정을 확인합니다. 비활성화해야 할 특별한 이유가 없는 한 이 값을 true로 유지하세요 -- 비활성화하면 크랙 클라이언트가 참여할 수 있습니다.
motd	A Minecraft Server	Java Edition 서버 목록에 표시되는 오늘의 메시지입니다. \u00A7(섹션 기호)로 색상 코드를 지원합니다.
view-distance	10	청크 단위의 렌더 거리입니다(1청크 = 16블록). 낮은 값(6-8)은 성능을 향상시키고, 높은 값(12-16)은 더 많은 RAM과 CPU를 소모하는 대신 더 나은 시각적 경험을 제공합니다.
spawn-protection	16	비운영자가 블록을 짓거나 부술 수 없는 월드 스폰 주변의 반경(블록 단위)입니다. 비활성화하려면 0으로 설정하세요.
level-seed	(공백)	월드 생성 시드입니다. 무작위 시드를 원하면 공백으로 두거나, 특정 월드를 생성하려면 특정 시드를 입력하세요. 새 월드가 생성될 때만 적용됩니다.
level-type	minecraft\:normal	월드 유형입니다. 옵션: minecraft\:normal, minecraft\:flat, minecraft\:large_biomes, minecraft\:amplified, minecraft\:single_biome_surface.
white-list	false	true일 때 whitelist.json에 나열된 플레이어만 참여할 수 있습니다. 아래 화이트리스트 섹션을 참조하세요.
enable-command-block	false	명령 블록을 사용할 수 있는지 여부입니다. 많은 어드벤처 맵과 일부 미니게임 설정에 필요합니다.

편집 후 파일을 저장하고 서버를 시작하세요. 새 설정은 시작 시 즉시 적용됩니다.

4. 운영자(관리자) 접근

운영자(op)는 /gamemode, /tp, /ban, /kick 등의 서버 명령어에 접근할 수 있습니다. 운영자 상태를 부여하는 방법은 두 가지입니다.

방법 1: GPanel 콘솔 (권장)

GPanel의 Console 탭에서 서버가 실행 중일 때 다음 명령어를 입력하세요:

op YourPlayerName

콘솔에 확인 메시지가 표시됩니다. 이제 해당 플레이어가 운영자입니다.

방법 2: ops.json 편집

서버 루트 디렉터리의 ops.json 파일을 수동으로 편집할 수도 있습니다. 각 항목은 다음과 같습니다:

[
  {
    "uuid": "player-uuid-here",
    "name": "YourPlayerName",
    "level": 4,
    "bypassesPlayerLimit": false
  }
]

level 필드는 운영자가 무엇을 할 수 있는지 제어합니다:

레벨	권한
1	스폰 보호를 무시할 수 있음
2	치트 명령어(/gamemode, /tp 등)와 명령 블록을 사용할 수 있음
3	플레이어 관리 명령어(/ban, /kick, /op)를 사용할 수 있음
4	/stop 및 /save-all을 포함한 전체 접근

운영자 상태를 제거하려면 콘솔 명령어를 사용하세요:

deop YourPlayerName

5. 화이트리스트

화이트리스트는 서버를 승인된 플레이어로만 제한합니다. 누가 참여할 수 있는지 제어하려는 비공개 서버나 커뮤니티에 유용합니다.

화이트리스트 활성화

server.properties에서 다음을 설정하세요:

white-list=true
enforce-whitelist=true

enforce-whitelist 설정은 화이트리스트가 다시 로드될 때 화이트리스트에 없는 현재 접속한 플레이어를 추방합니다.

화이트리스트 관리

서버가 실행 중일 때 GPanel 콘솔에서 다음 명령어를 사용하세요:

명령어	설명
whitelist add PlayerName	플레이어를 화이트리스트에 추가
whitelist remove PlayerName	플레이어를 화이트리스트에서 제거
whitelist list	모든 화이트리스트 플레이어 표시
whitelist reload	whitelist.json에서 화이트리스트 다시 로드

6. 연결 방법

서버가 실행되면 다음 단계에 따라 Minecraft Java Edition에서 연결하세요:

1. Network 탭 아래 GPanel에서 서버의 IP 주소와 포트를 찾습니다.
2. Minecraft Java Edition을 열고 Multiplayer를 클릭합니다.
3. Add Server를 클릭합니다.
4. Server Name 필드에 서버 이름을 입력합니다(이것은 서버 목록의 레이블일 뿐입니다).
5. Server Address 필드에 다음 형식으로 IP와 포트를 입력합니다:

   your.server.ip:port

   예: 192.168.1.100:25565

6. Done을 클릭한 다음 목록에서 서버를 선택하고 Join Server를 클릭합니다.

7. 월드 관리

월드 저장 위치

기본적으로 Minecraft 월드는 서버의 루트 디렉터리에 있는 world라는 폴더에 저장됩니다. 이 폴더에는 지형, 플레이어 데이터, 구조물을 포함한 모든 월드 데이터가 포함되어 있습니다. 해당 차원에 대한 world_nether 및 world_the_end 폴더도 볼 수 있습니다(Paper/Spigot 서버에서; Vanilla는 이를 world 내의 하위 폴더로 저장합니다).

기존 월드 업로드

싱글플레이어 또는 다른 서버에서 월드를 업로드하려면:

1. GPanel에서 서버를 정지합니다.
2. GPanel의 File Manager(또는 SFTP를 통해)를 사용하여 기존 world 폴더를 삭제하거나 이름을 변경합니다.
3. SFTP를 통해 월드 폴더를 업로드합니다. 폴더 이름이 world인지 확인하세요(또는 server.properties의 level-name 속성을 폴더 이름과 일치하도록 업데이트하세요).
   팁: 대용량 월드 업로드의 경우 SFTP가 브라우저 기반 File Manager보다 훨씬 빠릅니다. 설정 지침은 SFTP 가이드를 참조하세요.
4. 월드 폴더 구조가 올바른지 확인하세요 -- level.dat 파일이 하위 폴더에 중첩되지 않고 world 폴더 바로 안에 있어야 합니다.
5. 서버를 시작합니다. 업로드한 월드가 로드됩니다.

백업

특히 서버 버전 업데이트나 새 모드/플러그인 설치와 같은 주요 변경을 하기 전에 월드의 정기적인 백업을 유지하는 것이 강력히 권장됩니다.

수동 백업을 생성하려면:

1. GPanel 콘솔에서 save-all을 실행하여 모든 데이터를 디스크에 플러시합니다.
2. 서버를 정지합니다.
3. SFTP 또는 File Manager를 통해 world 폴더(및 world_nether / world_the_end가 있는 경우)를 다운로드합니다.
4. 백업을 컴퓨터나 클라우드 스토리지의 안전한 위치에 저장합니다.

---

관련 문서

• 서버 IP 및 포트 찾는 방법
• SFTP를 통한 파일 업로드 방법