🎮 2024년 마인크래프트 Paper 서버 구축의 모든 것: 1.21.3 완벽 가이드 (초보자용)

목차

• 소개
• Paper 서버란?
• 시스템 요구사항
• 서버 설치 준비
• Paper 서버 설치
• 서버 최적화
• 필수 플러그인
• 고급 설정
• 문제 해결
• 보안 설정
• 성능 모니터링
• 백업 시스템
• 결론

소개

안녕하세요! 오늘은 마인크래프트 1.21.3 버전용 Paper 서버를 설치하고 운영하는 방법에 대해 상세히 알아보겠습니다. 이 가이드를 따라하시면, 초보자도 안정적인 마인크래프트 서버를 구축할 수 있습니다. 특히 Paper 서버는 뛰어난 성능과 안정성을 제공하므로, 많은 플레이어들에게 인기 있는 선택입니다.

Paper 서버란?

Paper 서버는 Spigot을 기반으로 한 고성능 마인크래프트 서버 소프트웨어입니다. 다음과 같은 장점들이 있습니다:

• 뛰어난 성능 최적화
• 광범위한 플러그인 지원
• 빠른 보안 업데이트
• 활성화된 커뮤니티 지원
• 상세한 서버 설정 옵션

시스템 요구사항

안정적인 Paper 서버 운영을 위한 최소 시스템 요구사항은 다음과 같습니다:

최소 사양

• CPU: 최신 듀얼 코어 프로세서 (3.0GHz 이상)
• RAM: 4GB (서버 전용)
• 저장공간: 10GB 이상의 SSD
• 네트워크: 업로드 속도 5Mbps 이상
• 운영체제: 64비트 Windows/Linux/macOS

권장 사양

• CPU: 최신 쿼드 코어 프로세서 (3.5GHz 이상)
• RAM: 8GB 이상 (서버 전용)
• 저장공간: 20GB 이상의 NVMe SSD
• 네트워크: 업로드 속도 10Mbps 이상
• 운영체제: Ubuntu 22.04 LTS 또는 Windows Server 2022

서버 설치 준비

Java 설치

먼저 최신 버전의 Java를 설치해야 합니다.

Windows의 경우:

1. Adoptium 웹사이트 방문
2. Java 17 또는 그 이상 버전 다운로드
3. 설치 파일 실행 및 설치 완료
4. 시스템 환경 변수 확인

Linux의 경우:

sudo apt update
sudo apt install openjdk-17-jdk

작업 디렉토리 생성

서버 파일을 저장할 전용 디렉토리를 생성합니다.

Windows:

mkdir C:\minecraft-server
cd C:\minecraft-server

Linux:

mkdir ~/minecraft-server
cd ~/minecraft-server

Paper 서버 설치

Paper 다운로드

최신 Paper 서버는 다음 링크에서 다운로드할 수 있습니다:

• 공식 웹사이트: https://papermc.io/downloads
• 직접 다운로드 링크가 없는 경우 검색어 추천: "papermc 1.21.3 download github"

시작 스크립트 생성

Windows (start.bat)

@echo off
java -Xms4G -Xmx4G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:InitiatingHeapOccupancyPercent=15 -Dusing.aikars.flags=https://mcflags.emc.gs -Daikars.new.flags=true -jar paper.jar nogui
pause

Linux (start.sh)

#!/bin/bash
java -Xms4G -Xmx4G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:InitiatingHeapOccupancyPercent=15 -Dusing.aikars.flags=https://mcflags.emc.gs -Daikars.new.flags=true -jar paper.jar nogui

초기 설정

서버를 처음 실행하면 다음 파일들이 생성됩니다:

• server.properties
• bukkit.yml
• spigot.yml
• paper.yml
• eula.txt

eula.txt 파일을 열어 eula=false를 eula=true로 변경해야 합니다.

서버 최적화

server.properties 최적화

view-distance=8
simulation-distance=6
network-compression-threshold=256
max-players=20
entity-broadcast-range-percentage=100
spawn-protection=16
max-world-size=29999984

paper.yml 최적화

max-auto-save-chunks-per-tick: 6
max-entity-collisions: 2
grass-spread: 3
container-update: 1
hopper:
  disable-move-event: true
max-tick-time:
  tile: 1000
  entity: 1000
chunk-system:
  min-load-radius: 2
  gen-queue-size: 8

bukkit.yml 최적화

chunk-gc:
  period-in-ticks: 400
spawn-limits:
  monsters: 50
  animals: 10
  water-animals: 5
  water-ambient: 20
  water-underground-creature: 5
  ambient: 5
ticks-per: 
  animal-spawns: 400
  monster-spawns: 100
  water-spawns: 400
  water-ambient-spawns: 400
  water-underground-creature-spawns: 400
  ambient-spawns: 400

필수 플러그인

안정적인 서버 운영을 위한 필수 플러그인들입니다:

1. EssentialsX

• 기본적인 서버 명령어 제공
• 다운로드: SpigotMC
• 주요 설정:

  # config.yml
  chat:
  format: '<{DISPLAYNAME}> {MESSAGE}'
  radius: 0
  commands:
  kit:
  delay: 3600
  home:
  delay: 5

2. CoreProtect

• 블록 변경 로깅 및 롤백
• 다운로드: SpigotMC
• 주요 설정:

  # config.yml
  check-updates: true
  database:
  use-mysql: false
  max-records: 1000000

3. LuckPerms

• 권한 관리 시스템
• 다운로드: LuckPerms
• 기본 설정:

  # config.yml
  server:
  broadcast-to-admins: true
  auto-op: false
  storage-method: H2

4. WorldGuard

• 지역 보호 및 관리
• 다운로드: SpigotMC

5. WorldEdit

• 월드 편집 도구
• 다운로드: SpigotMC

고급 설정

메모리 관리

서버의 메모리 사용량을 모니터링하고 최적화하는 방법:

1. 힙 크기 설정

   -Xms4G -Xmx4G  # 4GB 메모리 할당

2. GC 로깅 활성화

   -Xlog:gc*:file=gc.log:time,uptimemillis:filecount=5,filesize=10M

네트워크 최적화

1. 포트포워딩 설정

   • 기본 포트: 25565
   • UDP/TCP 모두 개방

2. server.properties 네트워크 설정

   network-compression-threshold=256
   prevent-proxy-connections=false

문제 해결

일반적인 문제와 해결방법

1. 서버가 느릴 때

   • 타임랩 확인: /timings report
   • 청크 생성 제한
   • 엔티티 수 제한

2. 메모리 부족

   • GC 로그 확인
   • 불필요한 플러그인 제거
   • 월드 프리로드 설정

3. 연결 문제

   • 방화벽 설정 확인
   • 포트포워딩 확인
   • DNS 설정 확인

로그 분석

server.log 파일에서 주의해야 할 경고:

[Warning] Can't keep up! Is the server overloaded?
[Warning] Entity in wrong chunk!
[Warning] Moved wrongly!

보안 설정

기본 보안 설정

1. 화이트리스트 활성화

   # server.properties
   white-list=true
   enforce-whitelist=true

2. 관리자 권한 설정

   # ops.json
   [
   {
   "uuid": "player-uuid",
   "name": "AdminName",
   "level": 4,
   "bypassesPlayerLimit": false
   }
   ]

플러그인 보안

1. AuthMe 설정

   # config.yml
   security:
   passwordHash: ARGON2
   minPasswordLength: 8

2. 안티치트 설정

   • NCP (NoCheatPlus) 설치
   • Matrix 설치

성능 모니터링

성능 측정 도구

1. Spark 플러그인

   • CPU 사용량 모니터링
   • 메모리 사용량 추적
   • 플러그인 성능 분석

2. Plan 플러그인

   • 서버 통계 수집
   • 플레이어 활동 분석
   • 리소스 사용량 추적

모니터링 명령어

/tps # 서버 TPS 확인
/gc # 가비지 컬렉션 상태
/timings # 서버 성능 분석

백업 시스템

자동 백업 스크립트

Windows (backup.bat)

@echo off
set BACKUP_DIR=backups
set SERVER_DIR=server
set DATE=%date:~-4,4%%date:~-10,2%%date:~-7,2%

mkdir "%BACKUP_DIR%\%DATE%"
xcopy /E /I "%SERVER_DIR%" "%BACKUP_DIR%\%DATE%"

Linux (backup.sh)

#!/bin/bash
BACKUP_DIR="backups"
SERVER_DIR="server"
DATE=$(date +%Y%m%d)

mkdir -p "$BACKUP_DIR/$DATE"
cp -r "$SERVER_DIR/" "$BACKUP_DIR/$DATE/"

백업 정책

1. 일일 백업

   • 매일 새벽 4시 자동 백업
   • 7일간 보관

2. 주간 백업

   • 매주 일요일 전체 백업
   • 4주간 보관

3. 월간 백업

   • 매월 1일 전체 백업
   • 6개월간 보관

결론

이제 여러분은 안정적인 Paper 1.21.3 마인크래프트 서버를 설정하고 운영하는 데 필요한 모든 정보를 갖게 되었습니다. 이 가이드를 통해 다음과 같은 내용을 배웠습니다:

• Paper 서버의 설치와 기본 설정
• 서버 성능 최적화 방법
• 필수 플러그인 설치와 설정
• 보안 설정과 백업 시스템 구축
• 문제 해결과 모니터링 방법

유용한 관련 링크

• Paper 공식 다운로드: https://papermc.io/downloads
• Paper 문서: https://docs.papermc.io/
• Spigot 플러그인: https://www.spigotmc.org/resources/
• 마인크래프트 위키: https://minecraft.fandom.com/

서버 운영 팁

1. 정기적인 유지보수

   • 주기적으로 서버 백업 실행
   • 플러그인 업데이트 확인
   • 로그 파일 정리

2. 커뮤니티 관리

   • 명확한 서버 규칙 설정
   • 관리자 가이드라인 작성
   • 플레이어 피드백 수렴

3. 성능 관리

   • 정기적인 성능 모니터링
   • 불필요한 청크 언로드
   • 엔티티 수 제한 설정

추가 학습 자료

마인크래프트 서버 관리에 대해 더 깊이 있게 공부하고 싶다면 다음 주제들을 살펴보세요:

1. Java 가상 머신 튜닝
2. MySQL 데이터베이스 연동
3. Docker 컨테이너화
4. 프록시 서버 구축 (BungeeCord/Velocity)
5. 커스텀 플러그인 개발

독자 참여 질문

아래 질문들에 대해 생각해보고 댓글로 공유해주세요:

1. 여러분의 서버에서 가장 유용하게 사용하는 플러그인은 무엇인가요?

2. 서버 운영 중 겪었던 가장 큰 문제는 무엇이었고, 어떻게 해결하셨나요?

3. Paper 서버의 어떤 기능이 가장 마음에 드시나요?

4. 처음 서버를 시작할 때 이 글에서 설명한 내용 중 어떤 부분이 가장 도움이 될 것 같나요?

5. 여러분만의 특별한 서버 최적화 팁이 있다면 무엇인가요?

마치며

서버 구축은 처음에는 복잡해 보일 수 있지만, 차근차근 따라하다 보면 누구나 할 수 있습니다. 문제가 생기더라도 위의 문제 해결 가이드를 참고하면서 하나씩 해결해 나가시면 됩니다.

이 글이 여러분의 마인크래프트 서버 구축에 도움이 되었기를 바랍니다. 추가 질문이나 의견이 있으시다면 언제든 댓글로 남겨주세요. 즐거운 서버 운영 되시기 바랍니다! 🎮✨